文档反馈
文档反馈

集成SDK(Android)

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

前提条件

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

集成 SDK

Maven集成(推荐)

  1. 网易云信 SDK 下载中心查看 NERTC SDK 最新版本的版本号。

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

    其中,x.x.x 为 NERTC SDK 最新版本的版本号。

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

    注意:如果需要集成 V3.7.X 版本的 NERTC SDK,请额外加入以下内容。后续集成其他版本时,建议删除该行。

     implementation 'com.netease.yunxin:report:2.0.3'

手动集成

  1. 下载最新版本 SDK
  2. 解压后将对应的文件拷贝至项目路径中。
    无特殊情况,可忽略 part 文件夹。

    文件/文件夹 项目路径
    nertc-sdk-x.x.x.jar /app/libs/
    arm64-v8a
    arm64-v7a
    x86
    /app/src/main/jniLibs/
  3. app/build.gradle 文件中设置 libs 路径。

     android {
           ...
         compileOptions {
             // SDK 依赖的JDK版本为Java 8
             sourceCompatibility JavaVersion.VERSION_1_8
             targetCompatibility JavaVersion.VERSION_1_8
         }
         ...
    
         dependencies {
             implementation fileTree(dir: "libs", include: ["*.jar"])
             ...
         }
     }
  4. 单击 File > Sync Project With Gradle Files 按钮,直到同步完成。

添加权限

打开 app/src/main/AndroidManifest.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"/>
 <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
 <uses-permission android:name="android.permission.BROADCAST_STICKY"/>
 <uses-permission android:name="android.permission.READ_PHONE_STATE"/>

 <!-- Android Q(10.0) 及后续版本还需要额外添加以下权限 -->
 <uses-permission android:name="android.permission.READ_PRIVILEGED_PHONE_STATE" />

 <uses-feature android:name="android.hardware.camera"/>
 <uses-feature android:name="android.hardware.camera.autofocus"/>

防止代码混淆

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

-keep class com.netease.lava.** {*;}
-keep class com.netease.yunxin.** {*;}

后续步骤

实现音视频通话

×

反馈成功

非常感谢您的反馈,我们会继续努力做得更好。