凝视快速入门

将 Gaze 模块添加到现有的 Convai 角色中，并确认它在 Play 模式下会立即与玩家进行眼神接触。

添加 ConvaiGazeController 到一个现有的 Convai 角色上，并确认它在播放模式下会与玩家进行眼神接触。等你已经有一个可正常工作的 ConvaiCharacter 位于你的场景中，并且想在调整其任何设置之前先查看 Gaze 是否正在运行。

前提条件

• 一个 ConvaiCharacter 在你的场景中已经可以连接并响应的——完整 验证你的设置 如果还没有，请先这样做。
• 一个带有可解析头骨骼的 rig：一个 Humanoid rig 会自动解析，而 Generic 或不带动画器的 rig 在你添加一个 角色 rig 绑定 并至少分配头部。

Gaze 不需要一个 ConvaiGazeProfile 资源即可工作。仅添加该组件就会使用 SDK 内置的调优来运行它——配置文件是用于之后重塑行为的，不是用来开启该模块的。

添加 Gaze 组件

1

选择角色

在层级中，选择 游戏对象 所携带的 ConvaiCharacter 组件上。

2

添加 Gaze 组件

在检查器中，选择 添加组件，然后 Convai > 具身化 > Gaze。这会添加 ConvaiGazeController 到角色上。

Convai 还会自动添加该模块所需的基础设施——一个 EmbodimentContext下方，有一个 StandardRigBinding，以及内部的 GazeAttentionRequests 控制器所需的组件——会自动添加。你无需自行添加其中任何一个。

3

检查就绪状态

“ ConvaiGazeController 检查器会报告该组件是否可以运行： 就绪 表示 Gaze 已解析出头骨骼，并且在你按下播放时就会正常工作。 无法工作 仅在该 rig 没有可供 Gaze 旋转的头骨骼时出现，且检查器会指出修复方法。

验证设置

进入播放模式并与角色开始对话。Gaze 的默认眼神接触模式是 自然，它会跟随角色的对话状态：角色在 空闲期间会专注保持眼神接触 关注中, 倾听中以及 说话中，并在 思考中期间短暂中断接触以进行思考。 在对话过程中移动到角色身后，它就会转身面对你。

预期结果： 对话开始后不久，角色的眼睛和头部会转向你，在你说话以及它回应时保持眼神接触；如果你在对话中移动到它身后，角色会转身面对你。

故障排查

如果角色的眼睛和头部没有移动，请打开 ConvaiGazeController 检查器，并先检查就绪状态—— 无法工作 会直接指出缺失的骨骼。如果状态显示 就绪 但在播放模式下没有任何移动，请查看 排查 Gaze 故障 以了解其余的故障模式。

下一步

凝视工作原理配置眼神接触凝视故障排查