开发环境要求
Android Studio 2.0+。
Android 4.1(SDK API 16)及以上系统。
集成 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_Professional:latest.release'}
或
dependencies {implementation 'com.tencent.liteav:LiteAVSDK_Professional:latest.release@aar'}
3. 在 defaultConfig 中,指定 App 使用的 CPU 架构(目前 LiteAVSDK 支持 armeabi 、 armeabi-v7a 和 arm64-v8a)。
defaultConfig {ndk {abiFilters "armeabi", "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_Professional_8.7.10102', ext:'aar')
5. 在
app/build.gradle
的 defaultConfig 中,指定 App 使用的 CPU 架构(目前 LiteAVSDK 支持 armeabi 、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_Professional_xxx.zip
(其中xxx
为 LiteAVSDK 的版本号):
解压后得到 libs 目录,里面主要包含 jar 文件和 so 文件夹,文件清单如下:
2. 将解压得到的 jar文件和 armeabi、armeabi-v7a、arm64-v8a 文件夹拷贝到
app/libs
目录下。
3. 在
app/build.gradle
中,添加引用 jar 库的代码。
dependencies{implementation fileTree(dir:'libs',include:['*.jar'])}
4. 在工程根目录下的 build.gradle 中,添加 flatDir,指定本地仓库路径。
5. 在
app/build.gradle
中,添加引用 so 库的代码。
6. 在
app/build.gradle
的 defaultConfig 中,指定 App 使用的 CPU 架构(目前 LiteAVSDK 支持 armeabi 、 armeabi-v7a 和 arm64-v8a) 。defaultConfig {ndk {abiFilters "armeabi", "armeabi-v7a", "arm64-v8a"}}
7. 单击 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 授权
在您的 App 调用全功能版 SDK 相关功能之前(建议在 Application类中)进行如下设置:
public class MApplication extends Application {@Overridepublic void onCreate() {super.onCreate();String licenceURL = ""; // 获取到的 licence urlString licenceKey = ""; // 获取到的 licence keyTXLiveBase.getInstance().setLicence(this, licenceURL, licenceKey);}}
设置混淆规则
在 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 下载。