本文介绍 Android 端集成 NERoom SDK 的操作步骤，帮助您快速集成 NERoom SDK。

环境要求

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

• Android SDK API 等级 21 或以上。
• Android Studio 3.0 或以上版本。
• Android 系统 5.0 或以上版本的移动设备。

集成SDK

1. 在网易云信文档中心的 更新日志页面，查看 NERoom SDK 最新版本的版本号。

2. 在项目对应模块的 build.gradle 中加入以下行。

   implementation 'com.netease.yunxin.kit.room:roomkit:x.x.x'
   

   若需要使用音视频通话的虚拟背景功能和美颜功能，需要单独添加对应依赖。

   //美颜
   implementation 'com.netease.yunxin:nertc-beauty:x.x.x'
   implementation 'com.netease.yunxin:nertc-facedetect:x.x.x'
   
   //虚拟背景
   implementation 'com.netease.yunxin:nertc-segment:x.x.x'
   

   按照 NERoom SDK 适配的对应版本引入相关的依赖，具体适配的版本号请参考更新日志。

   例如：引入 NERoom 1.22.2，那么适配的 NERTC（音视频通话）版本为 V5.5.203-SNAPSHOT。

3. 在项目对应的根目录的build.gradle 中加入以下行。

allprojects {
    repositories {
        mavenCentral()
        google()

        // 该仓库为 Maven Snapshot 仓库，按需添加
        maven {
            url  "https://oss.sonatype.org/content/repositories/snapshots/"
        }
    }
}

如果当前版本的依赖库中包含有 SNAPSHOT 版本依赖，则还需要配置添加 Maven Snapshot 仓库地址。

例如：引入 NERoom 1.22.2，其适配的 NERTC（音视频通话）版本为 V5.5.203-SNAPSHOT，所以需要添加  Maven Snapshot 仓库地址，否则会造成构建失败。

添加设备权限

在 app/src/main/AndroidManifest.xml 文件中添加类似如下代码，添加相应的设备权限。

例如：

java//网络相关
<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"/>
//获取设备信息
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>

//允许应用程序使用camera硬件资源
<uses-feature android:name="android.hardware.camera"/>
//自动对焦
<uses-feature android:name="android.hardware.camera.autofocus"/>
        ......//APP需要的其他设备权限