tencent cloud

直播 SDK

动态与公告
TUILiveKit 产品动态
云直播推拉流 SDK 产品动态
新手指引
产品简介
产品概述
产品优势
性能数据
基本概念
购买指南
TRTC Live 价格总览
Live 视频直播计费说明
开通服务(TUILiveKit)
Demo 体验
Demo 体验指引
跑通 Demo(TUILiveKit)
接入指南
视频直播
准备工作
主播开播
观众观看
直播列表
语聊房
准备工作
主播开播
观众观看
直播列表
推流助手
推流助手(Electron 桌面应用)
推流助手(Web 桌面浏览器)
直播监播
监播页面(Web 桌面浏览器 React 版)
监播页面(Web 桌面浏览器 Vue 版)
UI 自定义
直播视频组件
视频源编辑组件
观众列表组件
聊天弹幕组件
媒体源配置面板
连麦管理面板
直播送礼组件
无 UI 集成
搭建视频直播
搭建语聊房
功能指南
关注主播(TUILiveKit)
至臻画质(TUILiveKit)
输入媒体流进房(TUILiveKit)
礼物系统(TUILiveKit)
客户端 API
Android
iOS
Web
服务端 API(TUILiveKit)
账号系统
REST API
第三方回调
错误码(TUILiveKit)
常见问题
平台编译
用户鉴权
云直播推拉流 SDK
产品简介
购买指南
Demo 体验
免费测试
SDK 下载
License 管理
高级功能
客户端 API
常见问题
无 UI 集成方案
API 文档
OSS information
OSS Attribution Notice

Android

聚焦模式
字号
最后更新时间: 2025-11-11 15:52:08
本文主要介绍如何快速地将腾讯云 LiteAVSDK(Android)集成到您的项目中,按照如下步骤进行配置,就可以完成 SDK 的集成工作。下面以全功能的 Live版 SDK 为例:

开发环境要求

Android Studio 4.0+。
Android 4.4(SDK API 19)及以上系统。

集成 SDK(aar)

您可以选择使用 Gradle 自动加载的方式,或者手动下载 aar 再将其导入到您当前的工程项目中。

方法一:自动加载(aar)

因为 jcenter 已经下线,您可以通过在 gradle 配置 mavenCentral 库,自动下载更新 LiteAVSDK。 只需要用 Android Studio 打开需要集成 SDK 的工程,然后通过简单的四个步骤修改 build.gradle 文件,就可以完成 SDK 集成:



1. 打开 app 下的 build.gradle。
2. 在 dependencies 中添加 LiteAVSDK 的依赖。
dependencies {
implementation 'com.tencent.liteav:LiteAVSDK_Live:latest.release'
}
dependencies {
implementation 'com.tencent.liteav:LiteAVSDK_Live:latest.release@aar'
}
3. 在 defaultConfig 中,指定 App 使用的 CPU 架构(目前 LiteAVSDK 支持 armeabi-v7a 和 arm64-v8a)。
defaultConfig {
ndk {
abiFilters "armeabi-v7a", "arm64-v8a"
}
}
4. 单击

Sync Now 同步 SDK,如果您的网络连接 mavenCentral 没有问题,很快 SDK 就会自动下载集成到工程里。

方法二:手动下载(aar)

如果您的网络连接 mavenCentral 有问题,也可以手动下载 SDK 集成到工程里:
1. 下载 LiveAVSDK ,下载完成后进行解压。
2. 将下载文件解压之后 SDK 目录下的 aar 文件拷贝到工程的 app/libs 目录下:

3. 在工程根目录下的 build.gradle 中,添加 flatDir,指定本地仓库路径。

4. 添加 LiteAVSDK 依赖,在 app/build.gradle 中,添加引用 aar 包的代码。

implementation(name:'LiteAVSDK_Live_11.2.0.13154', ext:'aar')
5. app/build.gradle 的 defaultConfig 中,指定 App 使用的 CPU 架构(目前 LiteAVSDK 支持 armeabi-v7a 和 arm64-v8a)。
defaultConfig {
ndk {
abiFilters "armeabi-v7a", "arm64-v8a"
}
}
6. 单击 Sync Now 同步 SDK,完成 LiteAVSDK 的集成工作。

集成 SDK(jar)

如果您不想集成 aar 库,也可以通过导入 jar 和 so 库的方式集成 LiteAVSDK:
1. 下载 LiveAVSDK ,下载完成后进行解压。在 SDK 目录下找到 LiteAVSDK_Live_xxx.zip(其中 xxx 为 LiteAVSDK 的版本号):

2. 解压后得到 libs 目录,里面主要包含 jar 文件和 so 文件夹,文件清单如下:

3. 将解压得到的 jar文件和 armeabi-v7a、arm64-v8a 文件夹拷贝到 app/libs 目录下。

4. app/build.gradle 中,添加引用 jar 库的代码。

dependencies{
implementation fileTree(dir:'libs',include:['*.jar'])
}
5. 在工程根目录下的 build.gradle 中,添加 flatDir,指定本地仓库路径。

6. app/build.gradle 中,添加引用 so 库的代码。

7. app/build.gradle 的 defaultConfig 中,指定 App 使用的 CPU 架构(目前 LiteAVSDK 支持 armeabi-v7a 和 arm64-v8a) 。
defaultConfig {
ndk {
abiFilters "armeabi-v7a", "arm64-v8a"
}
}
8. 单击 Sync Now 同步 SDK,完成 LiteAVSDK 的集成工作。

配置 App 打包参数




packagingOptions {
pickFirst '**/libc++_shared.so'
doNotStrip "*/armeabi/libYTCommon.so"
doNotStrip "*/armeabi-v7a/libYTCommon.so"
doNotStrip "*/x86/libYTCommon.so"
doNotStrip "*/arm64-v8a/libYTCommon.so"
}

配置 App 权限

在 AndroidManifest.xml 中配置 App 的权限,LiteAVSDK 需要以下权限:
<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.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-feature android:name="android.hardware.camera.autofocus" />

配置 License 授权

单击 License 申请 获取 License。您会获得两个字符串:一个字符串是 licenseURL,另一个字符串是解密 key。
在您的 App 调用全功能版 SDK 相关功能之前(建议在 Application类中)进行如下设置:
public class MApplication extends Application {

@Override
public void onCreate() {
super.onCreate();
String licenceURL = ""; // 获取到的 licence url
String licenceKey = ""; // 获取到的 licence key
V2TXLivePremier.setEnvironment("GDPR"); // 设置环境
V2TXLivePremier.setLicence(this, licenceURL, licenceKey);
V2TXLivePremier.setObserver(new V2TXLivePremierObserver() {
@Override
public void onLicenceLoaded(int result, String reason) {
Log.i(TAG, "onLicenceLoaded: result:" + result + ", reason:" + reason);
}
});
}
}


设置混淆规则

在 proguard-rules.pro 文件中,将 LiteAVSDK 相关类加入不混淆名单:
-keep class com.tencent.** { *; }

常见问题

1. Android 端使用 LiteAVSDK 录屏/屏幕共享功能必现 crash 问题怎么解决?

请您先检查下项目里面 targetSdkVersion 设置,如果设置的29那么运行 Android 10 设备使用录屏共享会触发闪退问题。原因是安卓隐私策略有更改,解决办法需要启动前台 service,并指定 type 为 mediaProjection 即可,不需要在 Service 里面调用 startScreenCapture。

2. 项目里面同时集成了直播 SDK/实时音视频/播放器等 LiteAVSDK 系列的多个 SDK 报符号冲突问题怎么解决?

如果集成了2个或以上产品(直播、播放器、TRTC、短视频)的 LiteAVSDK 版本,编译时会出现库冲突问题,因为有些 SDK 底层库有相同符号文件,这里建议只集成一个全功能版 SDK 可以解决,直播、播放器、TRTC、短视频这些都包含在一个 SDK 里面。具体请参见 SDK 下载

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈