集成SDK（音视频） - 音视频通话 2.0

开发者中心

音视频通话 2.0

集成开发

集成SDK（音视频）

更新时间： 2025/12/16 10:15:43

本文为您介绍了 Android 端集成网易云信音视频通话 NERTC SDK 的操作步骤，帮助您快速集成 SDK 并实现实时音视频通话的基本功能。

前提条件

在开始运行工程之前，请您准备以下开发环境：

Android SDK API 等级 19 或以上。
Android Studio 3.0 或以上版本。
Android 系统 4.4 或以上版本的移动设备。
Gradle 6.7.1 以及以上版本。

第一步：获取 SDK

网易云信音视频通话 2.0 NERTC SDK 提供了以下三种方式获取 SDK，版本更新内容请参考更新日志：

方式一：您可以通过 Maven 便捷获取 SDK。集成方式请参考下文 Maven 集成。
方式二：您可以在 SDK 下载中心获取最新的 NERTC SDK 并查看版本号。集成方式请参考下文手动集成。
方式三：若要使用其他版本，例如特殊版本或者定制版本，请提交工单联系网易云信技术支持工程师获取对应的版本号。

若您对包体积大小有要求，推荐您集成 4.6.20 及之后版本的 NERTC SDK，实现以插件化的方式按需集成动态库。

SDK 目录

获取了 SDK 后，您会查看到如下 SDK 目录：

Android
|
|-- lib                      //推荐放置在 /app/libs/ 目录
|   |
|   |-- nertc-sdk-4.x.xx.jar    
|
|-- partlib                  //推荐放置在 /app/libs/ 目录（若仅集成 NERTC SDK，可忽略此文件夹）
|   |
|   |-- nertc-sdk-part-4.x.xx.jar
|   |-- yunxin-catcher-1.0.2.jar
|   |-- yunxin-nos-1.0.3.jar
|   |-- yunxin-report-2.1.0.jar
|   |-- GrowDevice-1.7.2.4.jar
|
|-- jniLibs                  //推荐放置在 /app/src/main/jniLibs/ 目录
|   |
|   |-- armeabi-v7a
|       |
|       |   |-- libnertc_sdk.so
|       |   |-- libgrowease.so
|       |   |-- libNERtcnn.so
|       |   |-- libNERtcBeauty.so
|       |   |-- libNERtcFaceDetect.so
|       |   |-- libNERtcPersonSegment.so
|       |   |-- libNERtcAiDenoise.so
|       |   |-- libNERtcAiHowling.so
|       |   |-- libNERtcFaceEnhance.so
|       |   |-- libNERtcSuperResolution.so
|       |   |-- libNERtcVideoDenoise.so
|       |   |-- libNERtcAudio3D.so
|   |
|   |-- arm64-v8a
|       |
|       |   |-- libnertc_sdk.so
|       |   |-- libgrowease.so
|   |
|   |-- x86
|       |
|       |   |-- libnertc_sdk.so
|       |   |-- libgrowease.so

动态库

NERTC SDK 详细的动态库介绍如下表所示：

文件/文件夹名称	是否必选	说明	版本变化
lib-nertc-sdk	是	音视频库	一直提供
libnertc_sdk.so	是	音视频库	一直提供
partlib-nertc-sdk-part	是	音视频通话 1.0 兼容库	一直提供
~~partlib-yunxin-catcher~~	是	~~崩溃捕获。~~	5.3.1 起删除
~~partlib-yunxin-nos~~	是	~~日志上报。~~	5.3.1 起删除
~~partlib-yunxin-report~~	是	~~日志上报。~~	5.3.1 起删除
partlib-GrowDevice	是	音视频基础库	一直提供
libgrowease.so	是	音视频基础库	4.6.20 起提供
libNERtcnn.so	否	神经网络库 4.6.20 ～V4.6.x：`libNERtcnn.so` 动态库必选。 5.3.1 及之后版本：集成美颜、虚拟背景、音频啸叫检测、音频 AI 降噪或人脸增强插件时，`libNERtcnn.so` 动态库必选。	4.6.40 起提供
libNERtcBeauty.so	否	美颜库	4.6.20 起提供
libNERtcFaceDetect.so	否	人脸检测库	4.6.20 起提供
libNERtcPersonSegment.so	否	背景分割库	4.6.20 起提供
libNERtcAiDenoise.so	否	AI 降噪库	4.6.40 起提供
libNERtcAiHowling.so	否	AI 啸叫检测库	4.6.40 起提供
libNERtcFaceEnhance.so	否	人脸增强库	5.3.0 起提供
libNERtcSuperResolution.so	否	视频超分库	5.3.0 起提供
libNERtcVideoDenoise.so	否	视频降噪库	5.3.0 起提供
libNERtcAudio3D.so	否	空间音效库	5.4.0 起提供

第二步：创建项目

本步骤是可选步骤，如果您需要集成到已有的项目，请忽略该步骤。单击展开查看创建 Android Studio 新项目的步骤。

在 Android Studio 里，在顶部菜单依次选择 File > New > New Project 新建工程，再依次选择 Phone and Tablet > Empty Activity，单击 Next。
创建 Android 项目成功后，Android Studio 会自动开始同步 gradle, 您需要等同步成功后再进行下一步操作。

第三步：集成 SDK

Maven 集成（推荐）

配置项目的 Gradle 文件。

进入项目根目录，打开 app/build.gradle 文件，在 allprojects 中加入以下代码。

Groovyallprojects {
    repositories {
        mavenCentral()
        maven { url 'https://www.jitpack.io' }
        google()

    }
}

在 app/build.gradle 文件中设置 Java 编译版本。

Groovyandroid {
        compileOptions {
        // SDK 依赖的 JDK 版本为 Java 8
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
        }

    }

引入 NERTC Android SDK。

请在项目对应模块的 build.gradle 中加入以下代码。

Javaapi 'com.netease.yunxin:nertc:x.x.x'

其中，x.x.x 为待集成的 NERTC SDK 版本号。建议使用最新版本，您可以在网易云信 SDK 下载中心查看 NERTC SDK 最新版本的版本号。若要使用其他版本，请联系网易云信技术支持获取对应的版本号。

若您对包体积大小有要求，请集成 V4.6.20 及之后版本的 NERTC SDK，实现以插件化的方式按需集成动态库，您可以参考以下代码实现：

//集成 SDK 但不使用任何插件
api 'com.netease.yunxin:nertc-base:x.x.x'

//V4.6.20~V4.6.X 版本，集成 SDK 且使用部分插件，以美颜为例
implementation 'com.netease.yunxin:nertc-base:4.6.20'
implementation 'com.netease.yunxin:nertc-beauty:4.6.20'
implementation 'com.netease.yunxin:nertc-facedetect:4.6.20'

//V5.3.0 及以后版本，集成 SDK 且使用部分插件，以美颜为例
implementation 'com.netease.yunxin:nertc-base:5.3.1'
implementation 'com.netease.yunxin:nertc-nenn:5.3.1'
implementation 'com.netease.yunxin:nertc-beauty:5.3.1'
implementation 'com.netease.yunxin:nertc-facedetect:5.3.1'

artifactId 中请填入待引入的动态库的名称，具体说明如下表所示。

功能/插件	`artifactId` 的值	集成的动态库
音视频	`com.netease.yunxin:nertc-base`	必选基础库（`libnertc_sdk.so`、`libgrowease.so` 等）
神经网络	`com.netease.yunxin:nertc-nenn`	神经网络库: `libNERtcnn.so` V5.3.1 及之后版本，只有集成美颜、虚拟背景、音频啸叫检测、音频 AI 降噪、人脸增强插件时，才需要集成 `libNERtcnn.so` 库文件。基础音视频不需要集成该库文件。 V4.6.20 ～V4.6.x 版本：集成 `com.netease.yunxin:nertc-base` 时自动集成了 `libNERtcnn.so` 库，不需要单独集成。
美颜	`com.netease.yunxin:nertc-beauty`	美颜库：`libNERtcBeauty.so`
美颜	`com.netease.yunxin:nertc-facedetect`	人脸检测库：`libNERtcFaceDetect.so`
虚拟背景	`com.netease.yunxin:nertc-segment`	背景分割库：`libNERtcPersonSegment.so`
AI 降噪	`com.netease.yunxin:nertc-aidenoise`	AI 降噪库：`libNERtcAiDenoise.so`
AI 啸叫检测	`com.netease.yunxin:nertc-aihowling`	AI 啸叫检测库：`libNERtcAiHowling.so`
人脸增强	`com.netease.yunxin:nertc-faceenhance`	人脸增强库：`libNERtcFaceEnhance.so`
视频超分	`com.netease.yunxin:nertc-superresolution`	视频超分库：`libNERtcSuperResolution.so`
视频降噪	`com.netease.yunxin:nertc-videodenoise`	视频降噪库：`libNERtcVideoDenoise.so`
空间音效	`com.netease.yunxin:nertc-audio3d`	空间音效库：`libNERtcAudio3D.so`

（可选）如果您使用的是 V3.7.x 或 V4.5.0 版本的 NERTC Android SDK，需要额外添加 report 库依赖。
- V3.7.x：
```
Javaimplementation 'com.netease.yunxin:report:2.0.3'
```
- V4.5.0：
```
Javaimplementation 'com.netease.yunxin:report:2.1.0'
```
  后续集成其他版本时，建议删除该行。
指定 App 使用的 CPU 架构

请在项目对应模块的 build.gradle 的 defaultConfig 中加入以下代码。
```
GroovydefaultConfig {
    ndk {
            abiFilters "armeabi-v7a", "arm64-v8a", "x86",
    }
}
```
- 目前 NERTC Android SDK 支持 armeabi-v7a、arm64-v8a 和 x86 架构。
- 建议根据实际情况决定要支持的架构。通常在发布 App 时只需要保留 "armeabi-v7a" 和 "arm64-v8a" 即可，可以减少 APK 包大小。

手动集成

前往 SDK 下载页面获取当前最新版本 SDK，或联系网易云信技术支持获取对应版本的 SDK。

解压后将对应的文件拷贝至项目路径中。

文件/文件夹	项目路径
nertc-sdk-x.x.x.jar	/app/libs/
arm64-v8a arm64-v7a x86	/app/src/main/jniLibs/

若无对应文件夹，您需要在对应路径下新建文件夹。
无特殊情况，可忽略 part 文件夹。
自 V4.6.20 版本起，armeabi-v7a 目录下的动态库包括美颜等可选库，请按需拷贝到对应的目录，具体请参考下表。

功能/插件	集成的动态库
音视频	必选基础库：`libnertc_sdk.so`、`libgrowease.so`、`partlib-nertc-sdk-part`、`partlib-yunxin-catcher`、`partlib-yunxin-nos`、`partlib-yunxin-report`、`partlib-GrowDevice`、`libgrowease.so`、`libNERtcnn.so` V4.6.20 ～V4.6.x 版本：`libNERtcnn.so` 动态库必选。 V5.3.1 及之后版本，只有集成美颜、虚拟背景、音频啸叫检测、人脸增强插件时，才需要集成 `libNERtcnn.so` 库文件。基础音视频不需要集成该库文件。 V5.3.1 及之后版本，去掉了 `partlib-yunxin-catcher`、`partlib-yunxin-nos`、`partlib-yunxin-report` 库文件。
美颜	美颜库：`libNERtcBeauty.so`
美颜	人脸检测库：`libNERtcFaceDetect.so` 神经网络库: `libNERtcnn.so`
虚拟背景	背景分割库：`libNERtcPersonSegment.so` 神经网络库: `libNERtcnn.so`
AI 降噪	AI 降噪库：`libNERtcAiDenoise.so`
AI 啸叫检测	AI 啸叫检测库：`libNERtcAiHowling.so` 神经网络库: `libNERtcnn.so`
人脸增强	人脸增强库：`libNERtcFaceEnhance.so` 神经网络库: `libNERtcnn.so`
视频超分	视频超分库：`libNERtcSuperResolution.so`
视频降噪	视频降噪库：`libNERtcVideoDenoise.so`
空间音效	空间音效库：`libNERtcAudio3D.so`

在 app/build.gradle 文件中设置 libs 路径。

Groovyandroid {
      ...
    compileOptions {
        // SDK 依赖的 JDK 版本为 Java 8
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    ...

    dependencies {
        implementation fileTree(dir: "libs", include: ["*.jar"])
        ...
    }
}

指定 App 使用的 CPU 架构。

请在项目对应模块的 build.gradle 的 defaultConfig 中加入以下代码。
```
GroovydefaultConfig {
    ndk {
            abiFilters "armeabi-v7a", "arm64-v8a", "x86",
    }
}
```
- 目前 NERTC Android SDK 支持 armeabi-v7a、arm64-v8a 和 x86 架构。
- 建议根据实际情况决定要支持的架构。通常在发布 App 时只需要保留 "armeabi-v7a" 和 "arm64-v8a" 即可，可以减少 APK 包大小。
单击 File > Sync Project With Gradle Files 按钮，直到同步完成。

第四步：添加权限

打开 app/src/main/AndroidManifest.xml 文件，添加必要的设备权限。

例如：

XML//网络相关
 <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.CHANGE_WIFI_STATE"/>
//防止通话过程中锁屏
 <uses-permission android:name="android.permission.WAKE_LOCK"/>
//视频权限
 <uses-permission android:name="android.permission.CAMERA"/>
//录音权限
 <uses-permission android:name="android.permission.RECORD_AUDIO"/>
//修改音频设置
 <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>
//蓝牙权限
 <uses-permission android:name="android.permission.BLUETOOTH"/>
//蓝牙连接权限，此权限还需在运行应用时动态申请，否则 Android 12 及以上的设备蓝牙无法正常工作
 <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
//外置存储卡写入权限
 <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
//蓝牙 startBluetoothSco 会用到此权限
 <uses-permission android:name="android.permission.BROADCAST_STICKY"/>
// V5.4.0 及之后版本需要，更改设备的网络状态，如打开或关闭网络连接、更改网络类型等。
 <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE"/>
 //获取设备信息
 <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 targetSdkVersion 大于等于 31，需要添加以下标签，否则虚拟背景功能无法使用
 <application>
 <uses-native-library android:name="libOpenCL.so" android:required="false"/>
 </application>
 ......//App 需要的其他设备权限

权限说明如下表所示。

必要性	获取的权限	使用目的
必要权限	访问网络权限（INTERNET）	SDK 基本功能都需要在联网的情况下才可以使用
	网络连接状态（ACCESS_NETWORK_STATE）	判断网络连接状态及网络是否可用
	Wifi 网络状态（ACCESS_WIFI_STATE 和 CHANGE_WIFI_STATE）	判断网络连接状态及网络是否可用
	摄像头（CAMERA 和 camera.autofocus）	视频通话时，用于采集视频画面
	麦克风（RECORD_AUDIO）	音视频通话时，用于采集声音
	修改音频设置（MODIFY_AUDIO_SETTINGS）	修改音频设备配置时需要使用该权限
非必要权限	设备存储（WRITE_EXTERNAL_STORAGE）	存储 SDK 配置文件和日志文件
	设备存储（READ_EXTERNAL_STORAGE）	读取 SDK 配置文件和日志文件
	蓝牙（BLUETOOTH 和 BLUETOOTH_CONNECT）	连接蓝牙耳机和耳麦时需要该权限 BLUETOOTH_CONNECT 权限：您需要在代码中动态申请 `android.permission.BLUETOOTH_CONNECT` 权限，否则 Android 12 及以上系统版本的设备会无法使用蓝牙功能，具体信息请参考 Android 官方说明。 BLUETOOTH_CONNECT 权限：SDK V4.6.56 及之后版本，若用户未赋予该权限，SDK 会通过手机麦克风采集声音。但通话时需要要离手机比较近，对方才能听清声音。 BLUETOOTH 权限：仅 Android 6.0 以下版本需要声明，Android 6.0 及以上版本无需声明。
	WAKE_LOCK	防止通话过程中锁屏
	设备信息（READ_PHONE_STATE）	SDK 需要监听电话的打断，在电话呼入时，停止音频的采集，电话结束时，恢复音频采集
	更改设备的网络状态（CHANGE_NETWORK_STATE）	SDK 操作多网卡集成 SDK V5.4.0 及之后版本，需要该权限。

第五步：代码混淆

代码混淆是指使用简短无意义的名称重命名类、方法、属性等，增加逆向工程的难度，保障 Android 程序源码的安全性。为了避免因重命名类，导致调用 NERTC SDK 异常，您需要配置防代码混淆。

在 proguard-rules.pro 文件中，为 NERTC SDK 添加 -keep 类的配置，防止混淆 NERTC SDK 公共类名称。

Proguard-keep class com.netease.** {*;}

下一步

实现音视频通话

常见问题

如何减小集成 SDK 后的 App 包体积？
集成编译过程中出现 <uses-native-library> 标签找不到

问题现象

使用 Maven 下载的包进行集成 V5.3.0 及以上版本的 SDK 时，出现编译错误，提示：AAPT: error: unexpected element <uses-native-library> found in <manifest><application>。

问题解决

将 Gradle 版本升级到 6.7.1 或更高版本。由于旧版 Gradle 不支持 <uses-native-library> 标签，升级到新版本后即可解决该问题。

此文档是否对你有帮助？

有帮助

去反馈

前提条件
第一步：获取 SDK
SDK 目录
动态库
第二步：创建项目
第三步：集成 SDK
Maven 集成（推荐）
手动集成
第四步：添加权限
第五步：代码混淆
下一步
常见问题