导入并运行示例场景

导入捆绑的示例场景，并在构建你自己的场景之前验证 SDK 已正确安装并连接。

Convai 面向 Unity 的 SDK 附带两个示例场景。在开始构建自己的场景之前，运行其中一个是确认安装、API 密钥和音频设置是否正常工作的最快方法。

示例	说明
基础示例	与机器人角色的基础对话
唇形同步示例	具有实时唇形同步的高质量角色

查找这些示例的步骤因你安装 SDK 的方式而异。

包管理器

1

打开包管理器

在 Unity 编辑器中，打开 窗口 > 包管理器。在左上角下拉菜单中，选择 项目内，然后选择 适用于 Unity 的 Convai SDK 从列表中。

2

导入示例

在右侧详细信息面板中，点击 示例 选项卡。点击 导入 要运行的示例旁边的。

Unity 会将示例资源复制到 Assets/Samples/Convai SDK for Unity/<version>/。一个新文件夹会出现在 Assets/Samples/ 下方，位于项目窗口中。

3

打开场景

在项目窗口中，导航到已导入的示例文件夹并打开其中的 .unity 场景文件。

资源商店

场景打开后：

1

进入播放模式

按 播放。随着 SDK 初始化，Unity 控制台会记录以下几行内容：

• [ConvaiRuntime] 启动成功 — SDK 已初始化所有内部服务
• [RoomConnectionRuntimeAdapter] Character <character-id> 连接成功（模式=create）。 — 角色已连接到 Convai

对着麦克风说话。角色会以语音和文本输出进行回应。

如果没有出现响应且控制台显示警告，请检查 验证你的设置 以获取诊断清单。

示例渲染管线说明

示例场景是使用通用渲染管线（URP）构建的。如果你的项目使用不同的渲染管线，导入后材质可能会显示为粉色。使用 编辑 > 渲染 > 材质将材质转换为与你当前活动的渲染管线相匹配，然后选择适合你的管线的转换选项。

下一步

现在你已经确认 SDK 正常工作，在构建自己的设置之前，先了解每个场景组件的作用。

场景组件参考