在开始集成 ZegoAvatar SDK 前,请确保开发环境满足以下要求:
填写表单并选取各个选项来配置项目,单击 “Next”。
必须提供 “Product Name” 和 “Organization Identifier”,用于创建在整个系统中标识 App 的 “Bundle Identifier”。
请前往 下载 页面,获取最新版本的 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”。
根据实际应用需要,设置应用所需权限。
单击 “+” 添加按钮,添加摄像头和麦克风权限。
摄像头(表情随动时使用):Privacy - Camera Usage Description
麦克风(语音驱动时使用):Privacy - Microphone Usage Description
使用 Avatar 提供的各项 AI 能力之前,需要导入相应的资源。根据获取途径不同,资源可分为从 SDK 压缩包获取,和从 ZEGO 技术支持获取。
开发者可以通过 动态下载
或 从本地添加
两种方式,导入资源。
资源名称 | 说明 | 资源大小 | 是否支持 动态下载 |
建议下载时机 |
---|---|---|---|---|
AIModel.bundle |
Avatar 的 AI 模型资源。当使用表情随动、声音随动、AI 捏脸等能力时,必须先将该资源的绝对路径设置给 Avatar SDK。 |
|
是 |
必须在 ZegoAvatarService 初始化前完成下载。 |
qhuman.bundle |
美术资源,包含基础 Q 版头套模型资源、资源映射表、Q 版模型默认外形等。 |
|
是 |
必须在创建 IZegoCharacter 前完成下载。 |
资源名称 | 说明 | 资源大小 | 是否支持动态下载 | 建议下载时机 |
---|---|---|---|---|
Packages |
美妆、挂件、装饰、动画等资源。 |
每个资源 200 KB ~ 1 MB 不等,跟资源复杂度相关。 |
是 |
建议在需要使用相关资源时再去下载,不使用时可不下载,减少对本地存储空间的占用。 |
请前往 下载 页面,获取 ZEGO Avatar SDK 压缩包。
解压获取到的包,找到 “assets” 文件夹,拖到工程中。
上图仅为拖拽操作的示意,图中 assets 包含的资源可能与您实际获取的不符,请以实际资源为准。
联系 ZEGO 技术支持获取 “Packages”,并将该文件拖到工程中的上述 “assets” 文件夹下。
在弹出的对话框中,选择 “Create folder references” 选项,添加此文件。
添加后的目录结构如下所示。
上图仅为示意,图中 assets 包含的资源可能与您实际获取的不符,请以实际资源为准。
联系我们
文档反馈