集成 SDK
本文介绍如何创建项目并将声网 Meta SDK 集成进你的项目中。
前提条件
开始前请确保你的开发环境满足如下要求:
-
Android Studio 4.1 及以上
-
Android API 级别 22 及以上
-
Android 设备,版本 Android 5.1 及以上
信息声网推荐使用真机运行项目。部分模拟机可能存在功能缺失或者性能问题。
-
可以访问互联网的计算机。如果你的网络环境部署了防火墙,参考应对防火墙限制以正常使用声网服务
-
联系 sales@shengwang.cn 并提供你的声网项目的 App ID,开通声网内容中心的权限,并获取声网面部捕捉插件的 App ID 和 Certificate
创建项目并集成 SDK
1 创建项目
参考以下步骤创建项目,详见 Create a project。
-
打开 Android Studio,选择 New Project。
-
选择 Phone and Tablet > Empty Views Activity,点击 Next。
-
设置项目名称和存储路径,选择语言为 Java,点击 Finish 创建 Android 项目。
信息创建项目后,Android Studio 会自动开始同步 gradle,稍等片刻至同步成功后再进行下一步操作。
2 集成 SDK
声网 Meta SDK 是基于声网 RTC SDK 4.0.1 版开发的元系列特殊版 SDK。参考如下步骤获取并将 SDK 集成到你的项目中。
-
联系 sales@shengwang.cn 获取 Meta SDK,下载并解压。
-
打开解压文件,将以下文件或文件夹复制到你的项目路径中。
文件或子文件夹 项目路径 agora-rtc-sdk.jar
文件/app/libs/
AgoraMetaKit.aar
文件/app/libs/
face_capture.jar
文件/app/libs/
FaceCapture.aar
文件/app/libs/
metakit.jar
文件/app/libs/
arm64-v8a
文件夹/app/src/main/jniLibs/
armeabi-v7a
文件夹/app/src/main/jniLibs/
x86_64
文件夹/app/src/main/jniLibs/
x86
文件夹/app/src/main/jniLibs/
3 添加第三方库和依赖
在项目的 build.gradle
文件中的 dependencies
节点中添加行,以添加第三方库和依赖。
dependencies {
...
implementation fileTree(dir: "libs", include: ["*.jar", "*.aar"])
implementation(['com.squareup.okhttp3:logging-interceptor:3.9.0',
'com.squareup.retrofit2:retrofit:2.3.0',
'com.squareup.retrofit2:adapter-rxjava2:2.3.0',
'com.squareup.retrofit2:converter-gson:2.3.0'])
implementation(["io.reactivex.rxjava2:rxandroid:2.0.1",
"io.reactivex.rxjava2:rxjava:2.1.3"])
}
如下图所示:
4 添加网络和设备权限
在 /app/Manifests/AndroidManifest.xml
文件中,在 </application>
后面添加如下权限:
<uses-permission android:name="android.permission.INTERNET"/>
<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.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.BLUETOOTH"/>
<!-- 对于 Android 12.0 及以上且集成 v4.1.0 以下声网 SDK 的设备,还需要添加以下权限 -->
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT"/>
<!-- 对于 Android 12.0 及以上设备,还需要添加以下权限 -->
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.BLUETOOTH_SCAN"/>
5 代码防混淆
在 /Gradle Scripts/proguard-rules.pro
文件中添加如下行,以防止声网 SDK 的代码被混淆:
-keep class io.agora.**{*;}
-dontwarn javax.**
-dontwarn com.google.devtools.build.android.**
下一步
集成后,你可以参考如下文档在项目中搭建元语聊、元直播或融合场景: