Android

最近更新时间:2023-09-19 18:43:52

我的收藏
本文主要介绍如何快速地将腾讯云 LiteAVSDK(Android)集成到您的项目中,按照如下步骤进行配置,就可以完成 SDK 的集成工作。下面以全功能的 全功能版 SDK 为例:

开发环境要求

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 授权

单击 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
TXLiveBase.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 下载