提交工单
咨询集成、功能及报价等问题
文档中心
体验 App 中心
API 中心
常见问题
进入控制台
立即注册
登录控制台
Avatar 虚拟形象
集成 SDK
更新时间：2023-08-12 21:26
准备环境
在开始集成 ZegoAvatar SDK 前，请确保开发环境满足以下要求：
- Xcode 5.0 或以上版本。
- iOS 11.0 或以上版本，且支持音视频功能的 iOS 真机设备。
- 设备的前置摄像头和麦克风功能正常。
集成 SDK
1（可选）新建项目
此步骤以如何创建新项目为例，如果是集成到已有项目，可忽略此步。
- 启动 Xcode，在 “Welcome to Xcode” 窗口中单击 “Create a new Xcode project” 或选择 “File > New > Project” 菜单。在出现的表单中，选择 iOS 平台，并在 “Application” 下选择 “App”，单击 “Next”。
)
填写表单并选取各个选项来配置项目，单击 “Next”。
必须提供 “Product Name” 和 “Organization Identifier”，用于创建在整个系统中标识 App 的 “Bundle Identifier”。
)
- 选择项目存储路径，单击 “Create” 创建项目。
)
2 导入 SDK
请前往 下载 页面，获取最新版本的 SDK，下载完成后进行解压。
ZEGO 目前提供的是 XCFramework 形式的 SDK ，内含 “arm64” 的架构，不包含 “armv7” 架构。
手动将 SDK 动态库文件 “ZegoAvatar.xcframework” 拷贝到开发者的项目目录下。
打开 Xcode，选择 “File > Add Files to "xxx"（xxx 为项目名）” 菜单，添加 SDK 库文件到项目。
)
选择 “TARGETS > General > Frameworks,Libraries,and Embedded Content” 菜单，添加 “ZegoAvatar.xcframework”，将 “Embed” 设置为 “Embed & Sign”。
)
选择 “TARGETS > Build Settings > Bulid Options” 菜单，找到 Enable Bitcode，改为 “NO”。
)
3 设置权限
根据实际应用需要，设置应用所需权限。
- 在 Xcode 中，选择 “TARGETS > Info > Custom iOS Target Properties” 菜单。
)
单击 “+” 添加按钮，添加摄像头和麦克风权限。
摄像头（表情随动时使用）：
Privacy - Camera Usage Description麦克风（语音驱动时使用）：
Privacy - Microphone Usage Description)
导入资源包
使用 Avatar 提供的各项 AI 能力之前，需要导入相应的资源。根据获取途径不同，资源可分为从 SDK 压缩包获取，和从 ZEGO 技术支持获取。
开发者可以通过 动态下载 或 从本地添加 两种方式，导入资源。
（推荐）动态下载
从 SDK 压缩包获取的资源
| 资源名称 | 说明 | 资源大小 | 是否支持 动态下载 |
建议下载时机 |
|---|---|---|---|---|
AIModel.bundle |
Avatar 的 AI 模型资源。当使用表情随动、声音随动、AI 捏脸等能力时，必须先将该资源的绝对路径设置给 Avatar SDK。 |
|
是 |
必须在 ZegoAvatarService 初始化前完成下载。 |
qhuman.bundle |
美术资源，包含基础 Q 版头套模型资源、资源映射表、Q 版模型默认外形等。 |
|
是 |
必须在创建 IZegoCharacter 前完成下载。 |
从 ZEGO 技术支持获取的资源
| 资源名称 | 说明 | 资源大小 | 是否支持动态下载 | 建议下载时机 |
|---|---|---|---|---|
Packages |
美妆、挂件、装饰、动画等资源。 |
每个资源 200 KB ~ 1 MB 不等，跟资源复杂度相关。 |
是 |
建议在需要使用相关资源时再去下载，不使用时可不下载，减少对本地存储空间的占用。 |
从本地添加
请前往 下载 页面，获取 ZEGO Avatar SDK 压缩包。
解压获取到的包，找到 “assets” 文件夹，拖到工程中。
)
上图仅为拖拽操作的示意，图中 assets 包含的资源可能与您实际获取的不符，请以实际资源为准。
联系 ZEGO 技术支持获取 “Packages”，并将该文件拖到工程中的上述 “assets” 文件夹下。
在弹出的对话框中，选择 “Create folder references” 选项，添加此文件。
)
添加后的目录结构如下所示。
)
上图仅为示意，图中 assets 包含的资源可能与您实际获取的不符，请以实际资源为准。
相关文档
本篇目录
- 免费试用
联系我们
文档反馈
