本文件介绍如何集成声网 Meta SDK。
前提条件
声网推荐使用真机运行项目。部分模拟机可能存在功能缺失或者性能问题。
创建声网项目
- 进入声网控制台的项目管理页面。
- 在项目管理页面,点击创建按钮。
- 在弹出的对话框内输入项目名称、使用场景,然后选择安全模式:APP ID + Token。
- 点击提交按钮。新建的项目会显示在项目管理页中。
开通服务
- 创建项目后,从控制台获取以下信息:
- App ID:声网项目的 App ID。详见获取 App ID。
- App Certificate:声网项目的 App 证书。详见获取 App 证书。
- 频道名称:用于标识直播频道的字符串。
- 联系 sales@shengwang.cn 并供你的声网项目 App ID,以开通声网内容中心的权限并获取声网面部捕捉插件的 App ID 和 Certificate。
创建项目并集成 SDK
1. 创建项目
如果你没项目文件,你需要创建新项目。参考创建一个新的项目文档创建,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 |
2. 集成 SDK
声网 Meta SDK 是基于声网 RTC SDK 4.0.1 版开发的元系列特殊版 SDK。
- 联系销售获取该 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.a
libssl.a
libz.tbd
下一步
集成后,你可以参考下一篇文档实现元语聊、元直播。