Unity3D 虚拟形象demo示例源码运行指南

即构虚拟形象引擎（Zego Avatar）支持自定义管理人物的虚拟形象，通过默认的虚拟形象或者自定义生成的专有虚拟形象，以表情随动、声音驱动等方式与真人实时互动，可广泛应用于语聊直播、社交互动、在线培训等多种场景中。

本文介绍如何快速跑通示例源码，体验 Avatar 虚拟形象服务。

准备环境

在运行示例源码前，请确保开发环境满足以下要求。

安装 Unity

下载并安装 Unity 2021.3.2f1c1 版本。
根据自身需要运行到的平台，勾选对应的 Plaforms 模块一同下载，以在 macOS 上安装为例；
1. 打开 Unity Hub 2，单击左侧的“安装”选项，选择需要安装的 Unity 2021.3.2f1c1 版本。
2. 单击右上角图标选择 “添加模块” 选项。
3. 勾选需要需要的 Plaforms 模块，进行下载。

运行平台版本要求

根据示例代码需要运行到的平台，选择对应的开发环境或设备，并确保所运行设备的网络连接正常。

运行平台	环境要求
iOS	iOS 11.0 或以上版本。
Android	Android 5.1 或以上版本。

前提条件

已在 ZEGO 控制台创建项目，并申请有效的 AppID 和 AppSign，详情请参考控制台 – 项目管理中的“项目信息”。
已联系 ZEGO 商务人员，获取 ZegoAvatar Unity SDK 相关资源包，并开通相关权限。
已经搭建好 Unity 2021.3.2f1c1 版本，且在已有项目或者新项目中集成了 ZegoAvatar Unity SDK。

示例源码目录结构

下列结构为 Avatar 源码文件的子目录结构，下文所涉及的文件路径均为相对于此目录的路径。

.
├── Editor
│   └── Utils
├── PipelineSettings
├── Plugins                      #一些依赖库
│   ├── Android
│   └── iOS
├── Resources                    #一些场景配置的资源和配置文件
│   └── ZegoAvatarConfig
├── Settings                     #项目配置
├── StreamingAssets              #运行 Avatar 所需要的一些资源和模型
│   ├── ZegoAIRes                #AI 资源
│   └── ZegoAvatarRes            #模型资源
├── TutorialInfo                 #一些信息说明
│   ├── Icons
│   └── Scripts
└── ZegoAvatarExample            #示例场景和一些脚本
    ├── ReadMe
    ├── Scenes
    └── Scripts

运行示例代码

请在您的项目中集成 ZegoAvatar Unity SDK，详情可参考集成 SDK。
在 “Assets/ZegoAvatarExample/ZegoAvatarLicense.cs” 文件中，填写所获取的正确的 AppID 和 AppSign。

/Pics/ZegoAvatar/unity3d/2022092_154940.png

打开已集成的 ZegoAvatar Unity SDK 的项目目录，双击 “Project > Assets > Scenes > ZegoAvatarExample > Scenes” 目录下的 “ZegoDemoRoom.unity”，可以看到示例源码的主场景。

/Pics/ZegoAvatar/unity3d/20220926_190544.png

单击“运行”按钮，即可在编辑器中运行示例源码，并展示和操作 ZegoAvatar。

/Pics/ZegoAvatar/unity3d/20220922_160118.png

将示例源码运行在移动端设备上。

Android
1. 导入 Android 的 SDK 资源包，并连接好移动设备，打开可调试选项。
2. 在编译器中选择 “File > Build Settings > Player Settings”，Platform 选择 Android, 如果是切换平台到 Android, 单击 “Switch Platform” 按钮。
3. 设置颜色空间为 Gamma。
4. 设置读写权限为外部 “External(SDCard)”。
5. 在打开的二级子窗口中，选择 “Player> Other Settings > Identfication > Package Name”, 并填入自己的包名。
6. 在打开的二级子窗口中，选择 “Player> Resolution and presentation > Default Orientation”, 选择横屏模式。
7. 选择 “File > Build Settings” 并勾选 ZegoDemoRoom 场景（若没有则单击 “Add Open Scenes” 进行添加），同时选择平台类型，单击 “Build And Run“ 进行编译运行。
iOS
1. 导入 iOS 的 SDK 资源包，并连接好移动设备，打开可调试选项。
2. 在编译器中选择 “File > Build Settings > Player Settings”，Platform 选择 iOS, 如果是切换平台到 iOS, 单击 “Switch Platform”。
3. 设置颜色空间为 Gamma。
4. 在打开的二级子窗口中，选择 “Player > Other Settings > Identification > Bundle Identifier”, 并填入自己的包名。
5. 在打开的二级子窗口中，选择 “Player > Other Settings > Configuration”, 填入权限申请描述。
6. 在打开的二级子窗口中，选择 “Player> Resolution and presentation > Default Orientation”, 选择横屏模式。
7. 选择 “File > Build Settings” 并勾选 ZegoDemoRoom 场景（若没有则单击 “Add Open Scenes” 进行添加），同时选择平台类型，单击 “Build And Run” 进行编译运行。
8. 编译运行后会自动打开 Xcode, 请选择账号和确认 Bundle Identifier。
9. 关闭 Target 中的 Unity-iPhone 和 UnityFramework 的 Bitcode 选项。
10. 在 Target 的 UnityFramework 里面链接依赖库，并单击“Build And Run”进行编译运行。