注视注意力快速入门

在 Convai Player Component 上启用注视注意力，并验证当玩家看向带标签的世界对象时角色会作出响应。

在其上启用凝视注意力 UConvaiPlayerComponent，标记一个世界 Actor，使其可以接收注意力，并验证玩家将视线停留在其上后，Convai 角色会识别该对象。最后，当玩家注视该 Actor 达到 GazeAttentionDelay 持续时间（默认值：1.0 秒）。

先决条件

在启用凝视注意力之前，请确认以下内容：

• Convai Unreal Engine 插件已安装，并且 API 密钥已配置。参见 安装 Convai 插件.
• 你的关卡包含一个 UConvaiChatbotComponent 位于 AI 角色上，以及一个 UConvaiPlayerComponent 位于玩家 Pawn 上，并且具有有效的 CharacterID 以及一个可用的麦克风会话。
• 启用操作 在聊天机器人上已勾选。请选择该聊天机器人在 大纲视图，打开 UConvaiChatbotComponent 在 Details 面板，展开 Convai | 操作 → 环境，并确认 启用操作 (bEnableActions）已开启。凝视注意力会写入聊天机器人的注意力槽，这要求在会话连接时操作系统处于激活状态。如果尚未设置操作，请遵循 角色动作快速入门 。

如果你还没有标记任何世界对象，请先完成 场景元数据快速入门 后再继续。凝视注意力至少需要一个 UConvaiObjectComponent 并带有非空 名称.

启用凝视注意力并标记一个对象

1

选择玩家 Pawn

在 大纲视图 （或者 内容浏览器，如果正在编辑 Blueprint），打开包含该内容的 Actor 或 Blueprint UConvaiPlayerComponent.

2

打开总开关

选择 UConvaiPlayerComponent 在 Details 面板。在 Convai | 凝视注意力，勾选 启用凝视注意力 (bEnableGazeAttention）。默认值为 false；在此开启之前，其余所有凝视设置都会保持灰显。

3

设置响应模式

设置 凝视应响应 (GazeShouldRespond）为 始终。默认值为 从不，这会静默更新注意力槽，而不会请求角色进行语音回复。

在 凝视注意力文本 (GazeAttentionText），输入一句简短的话，例如 "玩家正在看这个对象。"。当注意力提升时，Convai 会将此文本用作叙事事件。

4

标记一个世界 Actor

点击关卡中的任意道具——例如箱子、门或一件设备。在 Details 面板中，点击 添加组件 并搜索 Convai Object Component。选择它以添加一个 UConvaiObjectComponent.

展开 Convai | 对象 并设置：

• 名称 ——一个简短标签，例如 "SafetyValve".
• 说明 ——一句话，例如 "西侧墙上的红色紧急阀门。"

在 Convai | 对象 | 凝视，确认 可凝视 (bGazeable）已勾选时。当 bGazeable 为 false时，该对象将完全从凝视管线中排除。

5

进入播放模式并注视该对象

按 播放。将准星对准已标记的 Actor，并保持在那里。

你应该会看到三个阶段的反馈：

1. 立即 ——对象上会出现视觉高亮（UE 5.3+ 显示浅黄色覆盖层，UE 5.0–5.2 显示线框框），而中心光标点会变为白色。
2. 在……之后 GazeAttentionDelay 秒 （默认 1.0 秒）—— OnAttentionGained 会触发，并更新聊天机器人的注意力槽。
3. 不久之后 ——角色开始说话，因为 GazeShouldRespond 被设置为 始终.

当凝视注意力正常工作时：准星一进入对象就会出现高亮，光标点变为白色，并且——在凝视保持 GazeAttentionDelay 秒后——角色开始说出回应。

如果高亮从未出现，请参阅 排查凝视注意力问题。如果高亮出现但角色保持沉默，请确认 启用操作, GazeShouldRespond，以及 GazeAttentionText 在玩家组件上。

下一步

注视注意力如何工作注视注意力参考注视注意力使用示例