动态与公告

产品动态

关于短视频 SDK “startPlay”接口名变更的公告

产品简介

产品概述

产品功能

应用场景

基本概念

购买指南

价格总览

退款说明

免费测试

License 指引

新增与续期 License

配置查看 License

Demo 体验

SDK 下载

发布日志（App）

含 UI 集成方案

小视频 App

源码解读（iOS）

源码解读（Android）

不含 UI 集成方案

SDK 集成

拍照和录制

预览裁剪和拼接

上传和播放

美颜特效

高级功能和特效

API 文档

短视频编辑

短视频录制

技术支持

错误码表

功能答疑

常见问题

上传常见问题

Android 编译问题

Android 常见问题

iOS 常见问题

License 常见问题

UGSV 政策

隐私政策

数据处理和安全协议

SDK 集成(Android Studio)

PDF

聚焦模式

字号

最后更新时间： 2025-04-01 18:10:24

Android 工程配置
系统要求
SDK 建议使用Android 5.0（API Level 21）及以上系统。
开发环境
以下是 SDK 的开发环境，App 开发环境不需要与 SDK 一致，但要保证兼容：
Android NDK：android-ndk-r12b
Android SDK Tools：android-sdk_25.0.2
minSdkVersion：21
targetSdkVersion：26
Android Studio（推荐您使用 Android Studio）
步骤1：集成 SDK
gradle 集成方式
aar 方式集成
jar+so 方式集成
1. 工程配置
1.1 在工程 App 目录下的 build.gradle 中指定依赖。
若使用3.x版本的com.android.tools.build:gradle工具，请添加如下代码：
dependencies {
 implementation 'com.tencent.liteav:LiteAVSDK_UGC:latest.release'
}
若使用2.x版本的com.android.tools.build:gradle 工具，请添加如下代码：
dependencies {
 compile 'com.tencent.liteav:LiteAVSDK_UGC:latest.release'
}
1.2 在 defaultConfig 中，指定 App 使用的 CPU 架构。
defaultConfig {
ndk {
    abiFilters "armeabi-v7a", "arm64-v8a"
}
}
说明：
目前 SDK 支持 armeabi-v7a 和 arm64-v8a。
2. 单击 Sync Now 等待自动下载 SDK 完毕，然后编译工程。
1. 下载最新的 SDK
下载地址：SDK 下载。将下载包 SDK 目录下的后缀名为 aar 的文件拷贝到指定目录（下面工程配置2.2中添加的本地仓库目录）
﻿
﻿
﻿
2. 工程配置
2.1 在工程 App 目录下的 build.gradle 中，指定依赖（LiteAVSDK_UGC_12.2.0.15065 是示例版本，请指定下载的版本）：
 若使用3.x版本的com.android.tools.build:gradle工具，请添加如下代码：
dependencies {
   implementation(name: 'LiteAVSDK_UGC_12.2.0.15065', ext: 'aar')
}
若使用2.x版本的com.android.tools.build:gradle 工具，请添加如下代码：
dependencies {
    compile(name: 'LiteAVSDK_UGC_12.2.0.15065', ext: 'aar')
}
2.2 在工程目录下的 build.gradle 中，添加 flatDir，指定本地仓库目录（下载的SDK拷贝到该目录）:
allprojects {
 repositories {
       jcenter()
       flatDir {
               dirs 'libs'
       }
 }
}
2.3 在 App 工程目录下的 build.gradle 的 defaultConfig 里面，指定 ndk 兼容的架构：
defaultConfig {
   ndk {
      abiFilters "armeabi-v7a", "arm64-v8a"
   }
}
3. 最后单击 Sync Now 同步工程，然后编译工程。
1. 下载最新的 SDK
1.1 下载地址：SDK 下载。解压下载包 SDK 目录下的 zip 文件并解压：
﻿
﻿
﻿
﻿
﻿
1.2 拷贝文件
如果您的工程之前没有指定过 jni 的加载路径，推荐您将刚才得到的 jar 包和对应架构 so 库拷贝到 Demo\\app\\src\\main\\jniLibs 目录下，这是 Android Studio 默认的 jni 加载目录。jar文件放置在libs文件夹下。
2. 工程配置
2.1  在工程 App 目录下的 build.gradle 中，添加引用 jar 包和 so 库的代码。
 若使用3.x版本的com.android.tools.build:gradle工具，请添加如下代码：
dependencies {
 implementation fileTree(dir: 'libs', include: ['*.jar'])
 // 导入腾讯云短视频SDK jar
 implementation fileTree(dir: 'src/main/jniLibs', includes: ['*.jar'])
}
 若使用2.x版本的com.android.tools.build:gradle 工具，请添加如下代码：
dependencies {
 compile fileTree(dir: 'libs', include: ['*.jar'])
 // 导入腾讯云短视频SDK jar
 compile fileTree(dir: 'src/main/jniLibs', includes: ['*.jar'])
}
2.2 在 App 工程目录下的 build.gradle 的 defaultConfig 里面，指定 ndk 兼容的架构：
defaultConfig {
   ndk {
           abiFilters "armeabi-v7a", "arm64-v8a"
   }
}
3. 最后单击 Sync Now 同步工程，编译工程。
步骤2：配置 App 权限
在 AndroidManifest.xml 中配置 App 的权限，音视频类 App 一般需要以下权限：
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-feature android:name="android.hardware.Camera"/>
<uses-feature android:name="android.hardware.camera.autofocus" />
步骤3：设置 License
1. 参见 License 申请 的指引申请 License 后，从 云点播控制台 复制 License Key 和 License URL，如下图所示：
﻿
﻿
﻿
2. 在您的应用中使用短视频功能之前，建议在- Application onCreate()中进行如下设置：
public class DemoApplication extends Application {
 String ugcLicenceUrl = ""; // 填入您从控制台申请的 licence url
 String ugcKey = "";        // 填入您从控制台申请的 licence key
﻿
 @Override
 public void onCreate() {
     super.onCreate();
     TXUGCBase.getInstance().setLicence(instance, ugcLicenceUrl, ugcKey);
 }
}
3. 新版本的 SDK 增加了短视频 License 的校验，如果校验没通过，您可以通过该接口来查询 License 中具体信息：
TXUGCBase.getInstance().getLicenceInfo(Context context);
说明：
对于使用4.7版本 License 的用户，如果您升级了 SDK 到4.9版本，您可以登录控制台，单击下图的切换到新版 License 按钮生成对应的 License Key 和 License URL，切换后的 License 必须使用4.9及更高的版本，切换后按照上述操作集成即可。
﻿
﻿
﻿
步骤4：打印 log
在  TXLiveBase 中可以设置 log 是否在控制台打印以及 log 的级别，具体代码如下：
setConsoleEnabled
设置是否在 Android Studio 的控制台打印 SDK 的相关输出。
setLogLevel
设置是否允许 SDK 打印本地 log，SDK 默认会将 log 写到 sdcard 上，Android/data/应用包名/files/log/tencent/liteav 文件夹下。如果您需要我们的技术支持，建议将此开关打开，在重现问题后提供 log 文件，非常感谢您的支持。
TXLiveBase.setConsoleEnabled(true);
TXLiveBase.setLogLevel(TXLiveConstants.LOG_LEVEL_DEBUG);
问题排查
如果您将 SDK 导入到您的工程，并在编译运行时遇到以下类似的错误：
Caused by: android.view.InflateException:
Binary XML file #14:Error inflating class com.tencent.rtmp.ui.TXCloudVideoView
可以按照以下流程来排查问题：
1. 确认是否已经将 SDK 中的 jar 包和 so 库放在 jniLibs目录下。
2. 如果您使用 aar 集成方式的完整版本，在工程目录下的 build.gradle 的 defaultConfig 里面确认下是否将 x64 架构的 so 库过滤掉。
defaultConfig {
 ...   
 ndk {
     abiFilters "armeabi-v7a", "arm64-v8a"
 }
}
3. 检查下混淆规则，确认已将 SDK 的相关包名加入了不混淆名单。
-keep class com.tencent.** { *; }
4. ﻿配置 App 打包参数。
﻿
﻿
﻿
详细介绍
以下为各模块的详细说明：
﻿视频录制﻿
﻿视频编辑﻿
﻿视频拼接﻿
﻿视频上传﻿
﻿视频播放﻿