直播 SDK
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 下载。