ChatdollKit

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• Unity 编辑器（ChatdollKit 为 Unity 框架，支持 Windows/Mac/Linux/iOS/Android/VR/AR/WebGL 等平
• 一个 VRM 格式的 3D 模型（用于新建带 VRM 模型的项目）
• OpenAI API Key（演示场景的对话、语音合成、语音识别都读取它）
• 可用的麦克风设备（WebGL 平台不支持麦克风，需改用 ChatdollMicrophone）

安装与启动步骤

1. 1创建 Unity 项目

   在 Unity 中新建项目。注意：不要使用 SRP（Scriptable Render Pipeline）项目模板，因为依赖的 UniVRM 不支持 SRP。

2. 2导入依赖

   按 README 说明先导入 ChatdollKit 及其依赖（README 未给出具体导入命令，请参照官方仓库与教学视频）。

3. 3打开演示场景

   导入依赖后，在项目中打开场景 Demo/Demo08，用于快速验证框架是否可用。

4. 4选择虚拟形象对象

   在 Demo08 场景的层级面板中选中名为 AIAvatarVRM 的对象，准备在 Inspector 上配置服务组件。

5. 5配置 OpenAI API Key

   在 AIAvatarVRM 对象的 Inspector 中，分别为 ChatGPTService、OpenSpeechSynthesizer、OpenAISpeechListener 三个组件填入同一个 OpenAI API Key。

6. 6在编辑器中运行

   点击 Unity 编辑器的 Play 按钮运行。若音量不合适可调整麦克风音量滑块。

7. 7说出唤醒词测试

   对麦克风说唤醒词（如 hello / こんにちは）或长度超过 3 个字符的词，模型应回复 "Hi there!" 之类的内容。

关键配置

如何确认成功

点击 Play 后模型出现待机动画与眨眼；说唤醒词或超过 3 个字符的词，模型会回复 "Hi there!"。

常见问题

注意事项

• 不要使用 SRP 项目模板，UniVRM 不支持 SRP。
• WebGL 构建需 5-10 分钟（取决于机器性能），且调试困难，错误不会显示堆栈信息。
• WebGL 中 HTTP 请求需要配置 CORS，且不支持 MP3 等压缩音频格式，语音合成请使用 WAV。
• 若要在消息窗口显示多字节字符（如日文/中文），需导入含多字节字符的字体并设置到消息窗口。