集成 Meta SDK
- iOS
更新时间
了解如何快速接入声网解决方案,完成环境准备、参数配置、示例运行和核心流程验证。
本文介绍如何创建项目并将声网 Meta SDK 集成进你的项目中。
前提条件
开始前请确保你的开发环境满足如下要求:
-
Xcode 12.0 及以上
-
iOS 设备,版本 11.0 及以上
信息
声网推荐使用真机运行项目。部分模拟机可能存在功能缺失或者性能问题。
-
有效的苹果开发者账号
-
可以访问互联网的计算机。确保你的网络环境没有部署防火墙,否则无法正常使用声网服务
-
联系 sales@shengwang.cn 并提供你的声网项目的 App ID,开通声网内容中心的权限,并获取声网面部捕捉插件的 App ID 和 Certificate
创建项目并集成 SDK
创建项目
如果没有项目文件,参考如下步骤创建一个新项目:
-
参考创建一个新的项目文档创建,Application 选择 App,Interface 选择 Storyboard,Language 选择 Swift。
信息
如果你没有添加过开发团队信息,会看到 Add account… 按钮。点击该按钮并按照屏幕提示登入 Apple ID,点击 Next,完成后即可选择你的 Apple 账户作为开发团队。
-
为你的项目设置自动签名。
-
设置部署你的 App 的目标设备。
-
添加项目的设备权限。在项目导航栏中打开
info.plist文件,编辑属性列表,添加以下属性: 表格内容超出当前宽度,可横向滚动查看更多列。key type value Privacy - Microphone Usage Description String 使用麦克风的目的,例如 for a live interactive streaming Privacy - Camera Usage Description String 使用摄像头的目的,例如 for a live interactive streaming
信息
- 如果你的项目中需要添加第三方插件或库(例如第三方摄像头),且该插件或库的签名与项目的签名不一致,你还需勾选 Hardened Runtime > Runtime Exceptions 中的 Disable Library Validation。
- 更多注意事项,可以参考 Preparing Your App for Distribution。
2. 集成 SDK
声网 Meta SDK 是基于声网 RTC SDK 4.0.1 版开发的元系列特殊版 SDK。参考如下步骤获取并将 SDK 集成到你的项目中。
- 联系 sales@shengwang.cn 获取 Meta SDK,下载并解压。
- 将 SDK 包内
libs及路径下的文件,拷贝到你的项目路径下。 - 打开 Xcode,添加对应动态库,确保添加的动态库 Embed 属性设置为 Embed & Sign。
信息
- 根据 Apple 官方要求,App 的 Extension 中不允许包含动态库。如果项目中的 Extension 需要集成 SDK,则添加动态库时需将文件状态改为 Do Not Embed。
- 声网 SDK 默认使用 libc++ (LLVM),如需使用 libstdc++ (GNU),请联系 sales@shengwang.cn。SDK 提供的库是 FAT Image,包含 32/64 位模拟器、32/64 位真机版本。
3. 添加第三方库和依赖
参考添加依赖库文档添加如下依赖库,并将状态修改为 Embed & Sign:
libcrypto.alibssl.alibz.tbd
下一步
集成后,你可以参考如下文档在项目中搭建元语聊、元直播或融合场景: