自定义场景设置

简介

先决条件

• 已安装 Convai SDK
• API 密钥配置成功
• 您的场景已在 Unity 中打开

分步骤

1

添加 Convai Manager

• 在 Unity 顶部菜单中，前往 GameObject → Convai → 设置所需组件 或 在其中右键单击 层级 → Convai → 设置所需组件

• 在弹出窗口中确认并继续。
• 预期结果： 一个 Convai Manager 对象存在于您的场景中。

2

创建或选择您的 Player 对象

• 选择您现有的玩家 GameObject，或创建一个空的。
• 添加 Convai Player 组件.
• 设置 玩家名称.
• 预期结果： 场景中恰好配置了一个 Convai Player。

3

添加 Convai Character 组件

对于您想让其具备对话能力的每个角色 GameObject：

• 添加 Convai Character 组件
• 设置 角色 ID

4

从 Convai 获取您的角色 ID

• 在 Convai 控制台中，打开您的角色并复制其 ID。

5

验证您的场景设置

• 使用以下验证选项之一：

  • 顶部菜单： GameObject → Convai → 验证场景设置
  • 层级右键： Convai → 验证场景设置

• 预期结果： 类似以下的成功消息：

  • “场景设置正确！”以及找到的 Convai Characters 数量。

6

运行对话测试

• 按 播放
• 使用麦克风说话，或在存在时使用 Chat UI
• 预期结果： 角色会响应。麦克风对话是 免手持 （无需按住说话）。

故障排查

• 验证失败

  • 确认一个 Convai Manager 对象存在于场景中。
  • 确保您已添加 Convai Player 组件 到玩家对象中。
  • 确保每个角色都有有效的 角色 ID.
• 角色没有响应

  • 确认已设置 API 密钥。
  • 检查 Console 中的网络/身份验证错误。

结论