注视注意力快速开始

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

在……上启用凝视注意力 UConvaiPlayerComponent，为一个世界 Actor 添加标签，使其能够接收注意力，并验证玩家将视线保持在其上后，Convai 角色会识别该对象。到最后，当玩家将目光看向该 Actor 持续 GazeAttentionDelay 持续时间（默认：1.0 秒）。

Convai 注意力中的对象操作指南

先决条件

在启用凝视注意力之前，请先确认以下事项：

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

如果你还没有给任何世界对象添加标签，请先完成 场景元数据快速入门 后再继续。凝视注意力至少需要一个 UConvaiObjectComponent ，且其中的 名称.

启用凝视注意力并给对象添加标签

1

选择玩家 Pawn

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

2

打开总开关

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

3

设置响应模式

设置 凝视应响应 (GazeShouldRespond）为 总是。默认值为 从不，它会静默更新注意力槽，而不会向角色请求语音回复。

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

4

给一个世界 Actor 添加标签

点击关卡中的任意道具——箱子、门或设备。在 详情 面板中，点击 添加组件 并搜索 Convai 对象组件。选择它以添加一个 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 已在玩家组件上启用。

下一步

注视注意力的工作原理注视注意力参考注视注意力使用示例