短视频 SDK 源码解读（Android）

一、如何运行 Demo

1. 下载 Demo，并解压。

2. 使用 Android Studio 打开项目 LiteAVDemo(UGC)。

3. 在 xiaoshipindemo 模块下找到 LicenseManager 类，填写申请的短视频 License 和腾讯特效 License 信息：

·ugcLicenceUrl / ugcKey：短视频 License 的授权地址与密钥。

·xmagicAuthLicenceUrl / xmagicAuthKey：腾讯特效 License 的授权地址与密钥。

4. 在 app 模块下找到 build.gradle 文件，将 applicationId 的值修改为申请 License 时填写的 Android 包名。

二、工程结构

小视频工程共包含六个模块，其中 app 为壳工程，业务功能分布在其余五个模块中：

三、app

app 模块目录结构参考如下：

此模块放置整个工程的 Application 类，具体功能模块在对应的功能 module 中。

四、xiaoshipindemo

xiaoshipindemo 模块目录结构参考如下：

小视频按照功能划分成账号、主界面、播放、短视频（编辑、合成、录制、发布）等模块，代码上也按此划分进行分类。下面分别介绍这些模块及相应实现。

五、目录结构

六、账号模块

·负责处理用户登录、注册以及登录缓存的逻辑。

·如果你已经有自己的账号体系，可以直接替换该模块。

·通过调用 TCUserMgr.register 将用户名、密码注册到小视频的业务后台；调用 TCUserMgr.login 进行登录，并将登录信息缓存到本地 SharedPreferences 中；退出登录时清空本地缓存。

相关代码：

七、主界面和列表管理模块

·主界面主要负责短视频列表、短视频拍摄/编辑和个人资料三个一级功能的切换。

·登录成功后，默认展示列表界面；单击「+」号按钮后，弹出对话框让你选择录制小视频或编辑本地小视频；单击个人资料按钮，跳转到个人资料页面。

·列表管理包含列表的拉取和展示。

相关代码：

八、短视频录制模块

小视频提供 短视频录制 功能，可录制一分钟的短视频；SDK 本身不显示录制时长。

相关代码：

九、文件选择模块

提供本地文件选择功能，列出手机中所有 mp4 视频文件。

相关代码：

十、编辑模块

视频编辑 包括视频裁剪、慢动作、滤镜、音乐混音、贴纸、添加字幕等功能。

相关代码：

十一、短视频合成模块

videojoiner/ 目录负责短视频合成相关功能。

十二、短视频发布模块

将录制的文件发布到腾讯云视频分发平台（点播系统）中。

相关代码：

十三、短视频播放模块

播放已经发布到点播系统中的视频，在小视频列表页面上下滑动可快速切换上/下一个视频。

相关代码：

十四、ugckit

ugckit 模块目录结构参考如下：

此模块主要是对短视频 SDK 的高级封装（包含 UI），方便快速接入。

十五、xmagickit

xmagickit 模块目录结构参考如下：

此模块用于快速接入腾讯特效美颜，是对腾讯特效美颜 Kit（TEBeautyKit）的二次封装。如果你需要在短视频中接入腾讯特效，可以参考 Demo 中使用此模块的方式快速接入。

十六、beautykit

beautykit 模块目录结构参考如下：

此模块是短视频中的基础美颜模块。如果客户选择使用基础美颜，可以使用此模块进行快速集成。

十七、ugcquic

ugcquic 模块目录结构参考如下：

此模块用于短视频上传的 QUIC 协议探测与加速，是对腾讯云 QUIC（TQUIC）SDK 的封装。它能在短视频上传前探测 QUIC 链路是否连通，从而提升上传速度与成功率。

相关代码：

注意：说明：

注意：该模块通过 com.qcloud.cos:quic 依赖提供底层 QUIC 能力。上传模块（ugckit 中的 QuicClient）通过反射调用本模块的 UGCQuicClientProxy / UGCQuicCallback 完成上传前的 QUIC 链路探测；当业务无需 QUIC 加速时，可移除该模块依赖而不影响上传主流程。