实时音视频 Android-无 UI 集成-文档中心-腾讯云

本文介绍如何将 SDK 导入到您的项目中：
﻿
﻿
开发环境要求
Android Studio 3.5 及以上。
Android 4.1（API level 16）及以上系统。
第一步：导入SDK
方案一：自动加载（aar）
TRTC SDK 已经发布到 mavenCentral 库，您可以通过配置 gradle 自动下载更新。
1. 在 dependencies 中添加 TRTC SDK 的依赖。
//TRTC 精简版 SDK
﻿
dependencies {
     implementation 'com.tencent.liteav:LiteAVSDK_TRTC:latest.release'
}
﻿
//TRTC 全功能版（Professional）SDK
dependencies {
    implementation 'com.tencent.liteav:LiteAVSDK_Professional:latest.release'
}
2. 在 defaultConfig 中，指定 App 使用的 CPU 架构。
defaultConfig {
     ndk {
             abiFilters "armeabi-v7a", "arm64-v8a"
     }
}
说明：
目前 TRTC SDK 支持 armeabi-v7a、arm64-v8a、x86 和 x86_64。
3. 单击
﻿
Sync Now，自动下载 SDK 并集成到工程里。
方案二：下载 SDK 并手动导入
1. 下载 SDK 并解压到本地。
2. 将解压的 aar 文件拷贝到工程的 app/libs 目录下。
3. 在工程根目录下的 build.gradle 中，添加 flatDir，指定本地仓库路径。
﻿
﻿
4. 在 app/build.gradle 中，添加引用 aar 包的代码。
﻿
﻿
5. 在 app/build.gradle的defaultConfig 中，指定 App 使用的 CPU 架构。
defaultConfig {
     ndk {
             abiFilters "armeabi-v7a", "arm64-v8a"
     }
}
说明：
目前 TRTC SDK 支持 armeabi-v7a、arm64-v8a、x86 和 x86_64。
6. 单击
﻿
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.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-feature android:name="android.hardware.camera.autofocus" />
注意：
 请勿设置android:hardwareAccelerated="false"，关闭硬件加速之后，会导致对方的视频流无法渲染。
若 Android 项目 targetSdkVersion 为 31 或者目标设备涉及到 Android 12 及更高系统版本并且集成 10.3 以下 TRTC SDK 版本，官方要求需要在代码中动态申请 android.permission.BLUETOOTH_CONNECT权限，以正常使用蓝牙功能，具体信息请参见 Android 官方说明。
若 Android 项目 targetSdkVersion 为 30 或者目标设备涉及到 Android 10 及更高系统版本，官方要求 App 退后台保持音频采集需启动前台服务并指定该服务类型为android:foregroundServiceType:microphone，以确保退后台可以保持麦克风正常采集。若 Android 项目 targetSdkVersion 为 34 及以上，还需要在 manifest 中配置 FOREGROUND_SERVICE_MICROPHONE 权限：<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MICROPHONE"/>，具体信息请参见 Android 官方说明。
第三步：设置混淆规则
在 proguard-rules.pro 文件，将 TRTC SDK 相关类加入不混淆名单：
-keep class com.tencent.** { *; }
通过 C++ 接口使用 SDK（可选）
如果您更倾向于使用 C++ 接口，而不是 Java 进行开发，可以执行此步骤；如果您仅使用 Java 语言来调用 TRTC SDK，请忽略此步。
1. 首先需要根据上文的指引，通过导入 jar 和 so 库的方式集成 TRTC SDK。
2. 拷贝头文件：将 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})
3. 使用命名空间：C++ 全平台接口的方法、类型等均定义在 trtc 命名空间中，为了让代码更加简洁，建议您直接使用 trtc 命名空间。
using namespace trtc;
说明：
配置 Android Studio C/C++ 开发环境具体可以参考 Android Studio 官方文档：向 Android 项目添加 C 和 C++ 代码 。 
目前只有 TRTC 版本的 SDK 支持 C++ 接口；对于 C++ 接口的使用方式，请参见 全平台（C++）API 概览。
Android

本页目录：

开发环境要求

第一步：导入SDK

方案一：自动加载（aar）

方案二：下载 SDK 并手动导入

第二步：配置 App 权限

第三步：设置混淆规则

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