# 集成 Meta SDK (/zh-CN/solutions/meta-world/get-started/integrate-sdk)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
<_PlatformTabsGroup>
<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="android" />
本文介绍如何创建项目并将声网 Meta SDK 集成进你的项目中。
## 前提条件 [#前提条件]
开始前请确保你的开发环境满足如下要求:
- [Git](https://git-scm.com/downloads)
- [Java Development Kit](https://www.oracle.com/java/technologies/javase-downloads.html)
- [Android Studio](https://developer.android.com/studio/) 4.1 及以上
- Android API 级别 22 及以上
- Android 设备,版本 Android 5.1 及以上
:::info[信息]
声网推荐使用真机运行项目。部分模拟机可能存在功能缺失或者性能问题。
:::
- 可以访问互联网的计算机。如果你的网络环境部署了防火墙,参考[应对防火墙限制](/zh-CN/realtime-media/rtc/build/setup-and-access/firewall)以正常使用声网服务
- 参考[开通元语聊服务](/zh-CN/solutions/meta-world/build/enable-service)注册并登录[声网控制台](http://console.shengwang.cn),创建声网项目,获取项目的 App ID、App 证书
- 联系 sales@shengwang.cn 并提供你的声网项目的 App ID,开通声网内容中心的权限,并获取声网面部捕捉插件的 App ID 和 Certificate
## 创建项目并集成 SDK [#创建项目并集成-sdk]
### 1 创建项目 [#1-创建项目]
参考以下步骤创建项目,详见 [Create a project](https://developer.android.com/studio/projects/create-project)。
1. 打开 **Android Studio**,选择 **New Project**。
2. 选择 **Phone and Tablet > Empty Views Activity**,点击 **Next**。
3. 设置项目名称和存储路径,选择语言为 **Java**,点击 **Finish** 创建 Android 项目。
:::info[信息]
创建项目后,**Android Studio** 会自动开始同步 gradle,稍等片刻至同步成功后再进行下一步操作。
:::
### 2 集成 SDK [#2-集成-sdk]
声网 Meta SDK 是基于声网 RTC SDK 4.0.1 版开发的元系列特殊版 SDK。参考如下步骤获取并将 SDK 集成到你的项目中。
1. 联系 sales@shengwang.cn 获取 Meta SDK,下载并解压。
2. 打开解压文件,将以下文件或文件夹复制到你的项目路径中。
| 文件或子文件夹 | 项目路径 |
|:-------------------------|:-----------|
| `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 添加第三方库和依赖 [#3-添加第三方库和依赖]
在项目的 `build.gradle` 文件中的 `dependencies` 节点中添加行,以添加第三方库和依赖。
```java
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 添加网络和设备权限 [#4-添加网络和设备权限]
在 `/app/Manifests/AndroidManifest.xml` 文件中,在 `` 后面添加如下权限:
```xml
```
### 5 代码防混淆 [#5-代码防混淆]
在 `/Gradle Scripts/proguard-rules.pro` 文件中添加如下行,以防止声网 SDK 的代码被混淆:
```java
-keep class io.agora.**{*;}
-dontwarn javax.**
-dontwarn com.google.devtools.build.android.**
```
## 下一步 [#下一步]
集成后,你可以参考如下文档在项目中搭建元语聊、元直播或融合场景:
<_PlatformProcessedMarker close="true" />
<_PlatformProcessedMarker groupMode="structured" canonicalPlatform="android" platform="ios" />
本文介绍如何创建项目并将声网 Meta SDK 集成进你的项目中。
## 前提条件 [#前提条件-1]
开始前请确保你的开发环境满足如下要求:
- [Git](https://git-scm.com/downloads)
- [Xcode](https://apps.apple.com/cn/app/xcode/id497799835?mt=12) 12.0 及以上
- iOS 设备,版本 11.0 及以上
:::info[信息]
声网推荐使用真机运行项目。部分模拟机可能存在功能缺失或者性能问题。
:::
- 有效的苹果开发者账号
- 可以访问互联网的计算机。确保你的网络环境没有部署防火墙,否则无法正常使用声网服务
- 参考[开通元语聊服务](/zh-CN/solutions/meta-world/build/enable-service)注册并登录[声网控制台](http://console.shengwang.cn),创建声网项目,获取项目的 App ID、App 证书
- 联系 sales@shengwang.cn 并提供你的声网项目的 App ID,开通声网内容中心的权限,并获取声网面部捕捉插件的 App ID 和 Certificate
## 创建项目并集成 SDK [#创建项目并集成-sdk-1]
### 创建项目 [#创建项目]
如果没有项目文件,参考如下步骤创建一个新项目:
1. 参考[创建一个新的项目](https://help.apple.com/xcode/mac/current/#/dev07db0e578)文档创建,**Application** 选择 **App**,**Interface** 选择 **Storyboard**,**Language** 选择 **Swift**。
:::info[信息]
如果你没有添加过开发团队信息,会看到 **Add account…** 按钮。点击该按钮并按照屏幕提示登入 Apple ID,点击 **Next**,完成后即可选择你的 Apple 账户作为开发团队。
:::
2. 为你的项目设置[自动签名](https://help.apple.com/xcode/mac/current/#/dev23aab79b4)。
3. 设置部署你的 App 的[目标设备](https://help.apple.com/xcode/mac/current/#/deve69552ee5)。
4. 添加项目的设备权限。在项目导航栏中打开 `info.plist` 文件,编辑[属性列表](https://help.apple.com/xcode/mac/current/#/dev3f399a2a6),添加以下属性:
| key | type | value |
| ------------------- | ------ | ------------------------------------------------------------ |
| Privacy - Microphone Usage Description | String | 使用麦克风的目的,例如 for a live interactive streaming |
| Privacy - Camera Usage Description | String | 使用摄像头的目的,例如 for a live interactive streaming |
:::info[信息]
- 如果你的项目中需要添加第三方插件或库(例如第三方摄像头),且该插件或库的签名与项目的签名不一致,你还需勾选 **Hardened Runtime** > **Runtime Exceptions** 中的 **Disable Library Validation**。
- 更多注意事项,可以参考 [Preparing Your App for Distribution](https://developer.apple.com/documentation/xcode/preparing_your_app_for_distribution)。
:::
### 2. 集成 SDK [#2-集成-sdk-1]
声网 Meta SDK 是基于声网 RTC SDK 4.0.1 版开发的元系列特殊版 SDK。参考如下步骤获取并将 SDK 集成到你的项目中。
1. 联系 sales@shengwang.cn 获取 Meta SDK,下载并解压。
2. 将 SDK 包内 `libs` 及路径下的文件,拷贝到你的项目路径下。
3. 打开 Xcode,[添加对应动态库](https://help.apple.com/xcode/mac/current/#/dev51a648b07),确保添加的动态库 **Embed** 属性设置为 **Embed & Sign**。
:::info[信息]
- 根据 Apple 官方要求,App 的 Extension 中不允许包含动态库。如果项目中的 Extension 需要集成 SDK,则添加动态库时需将文件状态改为 **Do Not Embed**。
- 声网 SDK 默认使用 libc++ (LLVM),如需使用 libstdc++ (GNU),请联系 sales@shengwang.cn。SDK 提供的库是 FAT Image,包含 32/64 位模拟器、32/64 位真机版本。
:::
### 3. 添加第三方库和依赖 [#3-添加第三方库和依赖-1]
参考[添加依赖库](https://help.apple.com/xcode/mac/current/#/dev51a648b07)文档添加如下依赖库,并将状态修改为 **Embed & Sign**:
- `libcrypto.a`
- `libssl.a`
- `libz.tbd`
## 下一步 [#下一步-1]
集成后,你可以参考如下文档在项目中搭建元语聊、元直播或融合场景:
<_PlatformProcessedMarker close="true" />