集成 Meta SDK
- Android
更新时间不可用
了解如何快速接入声网解决方案，完成环境准备、参数配置、示例运行和核心流程验证。
本文介绍如何创建项目并将声网 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.**下一步
集成后，你可以参考如下文档在项目中搭建元语聊、元直播或融合场景：