集成 SDK

---

1 准备环境

在开始集成 ZegoEffects SDK 前，请确保开发环境满足以下要求：

• Xcode 5.0 或以上版本。
• iOS 13.0 或以上版本，且支持音视频功能的 iOS 真机设备。

2 集成 SDK

2.1 （可选）新建项目

此步骤以如何创建新项目为例，如果是集成到已有项目，可忽略此步。

1. 启动 Xcode，在 “Welcome to Xcode” 窗口中单击 “Create a new Xcode project” 或选择 “File > New > Project” 菜单。在出现的表单中，选择 iOS 平台，并在 “Application” 下选择 “App”，单击 “Next”。
   

2. 填写表单并选取各个选项来配置项目，单击 “Next”。

   必须提供 “Product Name” 和 “Organization Identifier”，用于创建在整个系统中标识 App 的 “Bundle Identifier”。

   

3. 选择项目存储路径，单击 “Create” 创建项目。
   

2.2 导入 SDK

1. 请在 下载 页面，获取最新版本的 SDK，下载完成后进行解压。

   ZEGO 目前提供的是 XCFramework 形式的 SDK ，内含 “arm64” 和 “x86_64” 的架构，不包含 “armv7” 架构。

2. 打开 Xcode，选择 “File > Add Files to "xxx"（xxx 为项目名）” 菜单，添加 SDK 库文件到项目。

   

3. 选择 “TARGETS > General > Frameworks,Libraries,and Embedded Content” 菜单，添加 “ZegoEffects.xcframework”，将 “Embed” 设置为 “Embed & Sign”。

   

3 设置权限

根据实际应用需要，设置应用所需权限。

1. 在 Xcode 中，选择 “TARGETS > Info > Custom iOS Target Properties” 菜单。

   

2. 单击 “+” 添加按钮，输入 “Key” 为 Privacy - Camera Usage Description，添加摄像头权限。
   

   

4 导入资源和模型

请根据 导入资源和模型 文档，导入 SDK 内的 AI 模型和资源。

相关文档

• 如何获取 SDK 的堆栈信息？
• 如何获取 SDK 的日志信息？
• Xcode Archive 时提示 “Undefined symbols for architecture armv7: "_OBJC_CLASS_$_ZegoEffects"”，该如何处理？