实时音视频快速集成(Android) - 快速入门_编程技术网-程序员技术内容聚合平台

（在说正事之前，我要推荐一个福利：你还在原价购买阿里云、腾讯云、华为云服务器吗？那太亏啦！来这里，新购、升级、续费都打折，能够为您省60%的钱呢！2核4G企业级云服务器低至69元/年，点击进去看看吧>>>)

本文主要介绍如何快速地将腾讯云 TRTC SDK(Android) 集成到您的项目中，只要按照如下步骤进行配置，就可以完成 SDK 的集成工作。

开发环境要求

Android Studio 3.5+。
Android 4.1（SDK API 16）及以上系统。

集成 SDK（aar）

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

方法一：自动加载（aar）

TRTC SDK 已经发布到 jcenter 库，您可以通过配置 gradle 自动下载更新。
只需要用 Android Studio 打开需要集成 SDK 的工程（本文以 TRTCScenesDemo 为例），然后通过简单的三个步骤修改 app/build.gradle 文件，就可以完成 SDK 集成：

在 dependencies 中添加 TRTCSDK 的依赖。
- 若使用3.x版本的 com.android.tools.build:gradle 工具，请执行以下命令：
```
dependencies {
   implementation 'com.tencent.liteav:LiteAVSDK_TRTC:latest.release'
}
```
- 若使用2.x版本的 com.android.tools.build:gradle 工具，请执行以下命令：
```
dependencies {
   compile 'com.tencent.liteav:LiteAVSDK_TRTC:latest.release'
}
```
在 defaultConfig 中，指定 App 使用的 CPU 架构。
```
defaultConfig {
   ndk {
       abiFilters "armeabi", "armeabi-v7a", "arm64-v8a"
   }
}
```
说明：

目前 TRTC SDK 支持 armeabi ， armeabi-v7a 和 arm64-v8a。

3.单击【Sync Now】，自动下载 SDK 并集成到工程里。

方法二：手动下载（aar）

如果您的网络连接 jcenter 有问题，您也可以手动下载 SDK 集成到工程里：

下载最新版本 TRTC SDK。
将下载到的 aar 文件拷贝到工程的 app/libs 目录下。
在工程根目录下的 build.gradle 中，添加 flatDir，指定本地仓库路径。
在 app/build.gradle 中，添加引用 aar 包的代码。

5.在 app/build.gradle的defaultConfig 中，指定 App 使用的 CPU 架构。
```
defaultConfig {
   ndk {
       abiFilters "armeabi", "armeabi-v7a", "arm64-v8a"
   }
}
```
说明：

目前 TRTC SDK 支持 armeabi ， armeabi-v7a 和 arm64-v8a。
单击【Sync Now】，完成 TRTC SDK 的集成工作。

集成 SDK（jar）

如果您不想集成 aar 库，也可以通过导入 jar 和 so 库的方式集成 TRTC SDK：

下载最新版本的 jar 压缩包，文件路径为SDK/LiteAVSDK_TRTC_xxx.zip （其中 xxx 为 TRTC SDK 的版本号）。
解压后得到 libs 目录，里面主要包含 jar 文件和 so 文件夹。
将解压得到的 jar 文件和 armeabi， armeabi-v7a， arm64-v8a 文件夹拷贝到 app/libs 目录下。
在 app/build.gradle 中，添加引用 jar 库的代码。

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

sourceSets {
   main {
       jniLibs.srcDirs = ['libs']
   }
}

在 app/build.gradle 的 defaultConfig 中，指定 App 使用的 CPU 架构。
```
defaultConfig {
  ndk {
      abiFilters "armeabi", "armeabi-v7a", "arm64-v8a"
  }
}
```
说明：

目前 TRTC SDK 支持 armeabi， armeabi-v7a 和 arm64-v8a。
单击【Sync Now】，完成 TRTC SDK 的集成工作。

配置 App 权限

在 AndroidManifest.xml 中配置 App 的权限，TRTC SDK 需要以下权限：

<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" />
<uses-feature android:name="android.hardware.camera.autofocus" />

注意：

请勿设置 android:hardwareAccelerated="false"，关闭硬件加速之后，会导致对方的视频流无法渲染。

设置混淆规则

在 proguard-rules.pro 文件，将 TRTC SDK 相关类加入不混淆名单：

-keep class com.tencent.** { *; }

设置 App 打包参数

在 app/build.gradle 下，添加如下信息：

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

通过 C++ 接口使用 SDK（可选）

如果您更倾向于使用 C++ 接口，而不是 Java 进行开发，可以执行此步骤；如果您仅使用 Java 语言来调用 TRTC SDK，请忽略此步。

首先需要根据上文的指引，通过导入 jar 和 so 库的方式集成 TRTC SDK。

拷贝头文件：将 SDK 中的 C++ 头文件拷贝到项目中（路径为：SDK/LiteAVSDK_TRTC_xxx/libs/include），并在 CMakeLists.txt 中配置 include 文件夹路径及 so 库的动态链接。

cmake_minimum_required(VERSION 3.6)
# 配置 C++ 接口头文件路径
include_directories(
    ${CMAKE_CURRENT_SOURCE_DIR}/include  # 拷贝自 SDK/LiteAVSDK_TRTC_xxx/libs/include
)
add_library(
    native-lib
    SHARED
    native-lib.cpp)
# 配置 libliteavsdk.so 动态库路径
add_library(libliteavsdk SHARED IMPORTED)
set_target_properties(libliteavsdk  PROPERTIES IMPORTED_LOCATION ${CMAKE_CURRENT_SOURCE_DIR}/../../../libs/${ANDROID_ABI}/libliteavsdk.so)
find_library(
    log-lib
    log)
# 配置 libliteavsdk.so 动态链接
target_link_libraries(
    native-lib
    libliteavsdk
    ${log-lib})

使用命名空间：C++ 全平台接口的方法、类型等均定义在 trtc 命名空间中，为了让代码更加简洁，建议您直接使用 trtc 命名空间
```
using namespace trtc;
```

说明：

配置 Android Studio C/C++ 开发环境具体可以参考 Android Studio 官方文档：向 Android 项目添加 C 和 C++ 代码。

目前只有 TRTC 版本的 SDK 支持 C++ 接口；对于 C++ 接口的使用方式，请参见全平台（C++）API 概览。