集成 Meta SDK

  • iOS

更新时间

了解如何快速接入声网解决方案,完成环境准备、参数配置、示例运行和核心流程验证。

本文介绍如何创建项目并将声网 Meta SDK 集成进你的项目中。

前提条件

开始前请确保你的开发环境满足如下要求:

  • Git

  • Xcode 12.0 及以上

  • iOS 设备,版本 11.0 及以上

    信息

    声网推荐使用真机运行项目。部分模拟机可能存在功能缺失或者性能问题。

  • 有效的苹果开发者账号

  • 可以访问互联网的计算机。确保你的网络环境没有部署防火墙,否则无法正常使用声网服务

  • 参考开通元语聊服务注册并登录声网控制台,创建声网项目,获取项目的 App ID、App 证书

  • 联系 sales@shengwang.cn 并提供你的声网项目的 App ID,开通声网内容中心的权限,并获取声网面部捕捉插件的 App ID 和 Certificate

创建项目并集成 SDK

创建项目

如果没有项目文件,参考如下步骤创建一个新项目:

  1. 参考创建一个新的项目文档创建,Application 选择 App,Interface 选择 Storyboard,Language 选择 Swift。

    信息

    如果你没有添加过开发团队信息,会看到 Add account… 按钮。点击该按钮并按照屏幕提示登入 Apple ID,点击 Next,完成后即可选择你的 Apple 账户作为开发团队。

  2. 为你的项目设置自动签名。

  3. 设置部署你的 App 的目标设备。

  4. 添加项目的设备权限。在项目导航栏中打开 info.plist 文件,编辑属性列表,添加以下属性:

    keytypevalue
    Privacy - Microphone Usage DescriptionString使用麦克风的目的,例如 for a live interactive streaming
    Privacy - Camera Usage DescriptionString使用摄像头的目的,例如 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 集成到你的项目中。

  1. 联系 sales@shengwang.cn 获取 Meta SDK,下载并解压。
  2. 将 SDK 包内 libs 及路径下的文件,拷贝到你的项目路径下。
  3. 打开 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

下一步

集成后,你可以参考如下文档在项目中搭建元语聊、元直播或融合场景: