Gaze 使用示例
通过四个完整的 Convai Gaze 使用示例,配置眼神接触、脚本化瞥视,并协调多角色视线。
这些场景展示了如何 ConvaiGazeController 以及其支持组件如何组合以满足真实的应用需求。每个场景都是自包含的:首先描述 Inspector 设置,随后给出完成该行为所需的任何运行时代码。字段引用见 凝视配置文件参考;完整的脚本接口见 凝视脚本参考.
场景 1:在解释时保持眼神交流
情况: 安全简报模拟中的一名讲解员 NPC 必须在整个程序讲解过程中与学员保持稳定的眼神交流,而不会在简报之间变成僵硬的凝视。
运行时脚本
using Convai.Modules.Gaze.Components;
using UnityEngine;
public sealed class SafetyBriefingGazeDirector : MonoBehaviour
{
[SerializeField] private ConvaiGazeController instructorGaze;
public void BeginExplanation()
{
instructorGaze.EyeContactMode = GazeEyeContactMode.ConversationLock;
instructorGaze.FocusFidelity = GazeFocusFidelity.Social;
}
public void EndExplanation() =>
instructorGaze.EyeContactMode = GazeEyeContactMode.Natural;
}GazeEyeContactMode.ConversationLock 会将全部注意力投入到玩家锚点——参与度固定为 1,没有回避,完整头部参与——贯穿每个对话状态,而 空闲 在简报之间则保留配置文件中预设的环境行为,而不是一直盯视。 GazeFocusFidelity.Social 会在接触锥内保留细微的注视活动,因此这种锁定仍会显得有生气而不是机械。
预期结果: 讲解员会在整个解释过程中对学员保持完整且投入的眼神交流,并在接触锥内保留细微的注视活动,使这种锁定看起来有生气而非机械化,并在 EndExplanation() 运行时恢复为普通对话行为。
场景 2:先看文件,再回到访客
情况: 在访谈模拟中,一名谈判员 NPC 在学员举起合同时,应先低头看一眼桌上的合同,然后再把注意力转回学员身上,同时不丢失对话脉络。
运行时脚本
GlanceAt 是一种有投入但低优先级的脚本请求:它绝不会转动身体,并且角色会在两秒停留结束后立刻回到策略所规定的行为——无需额外记账。此场景中请保持 EyeContactMode 在 自然 (默认值);在 对话锁定 或 始终锁定 使用 LockBlocksGlances 开启时(默认值),这个瞥视会被吸收,谈判员也就永远不会把目光移开学员,这对一个需要打破眼神接触并查看文件的角色来说是不对的表现。
预期结果: 谈判员会低头看合同两秒钟,且不会转动身体,停留结束后会自动把注意力转回学员。
场景 3:群体场景中的多角色倾听
情况: 一场企业入职场景中有三个 NPC 站在一起。某人发言时,另外两人应转向倾听;三人都处于空闲时,他们应偶尔交换眼神,而不是呆呆地直视前方。
组件设置
添加 CharacterGazeTargetProvider (Add Component > Convai > Gaze > Advanced > Character Target) 添加到每个参与角色,并同时添加其 ConvaiGazeController. 保持 发布自身 和 注视他人 开启,这样每个角色既能把自己提供为目标,也能为其他角色生成候选。默认的 优先级 的 7 位于玩家锚点的 10 与世界对象的 5之间,因此倾听者会转向正在发言的同事,但如果与玩家对话,仍会以玩家优先。
将每个角色的 关注说话者 (ConvaiGazeController.AttendToSpeaker,一个 GazeSpeakerAttention 值保持为 关闭, Player, 角色,或 Anyone)的默认值, Anyone。正是该设置会让倾听角色转向当前掌握发言权的人—— CharacterGazeTargetProvider 上面的设置只会让角色有资格被注视。 Anyone 会同时对玩家的发言轮次和另一角色的发言轮次做出反应,这正是这个场景所需要的。
验证每个角色都具有提供器
ConvaiManager.ActiveManager.Characters 列出管理器当前拥有的每一个 ConvaiCharacter ,这使它成为一个方便的一次性审计,适用于在不同时刻添加了多个 NPC 的场景。无论基于距离的相关性衰减如何,正在发言的角色对其他角色始终是完全相关的,这正是倾听者会转向当前发言者的原因; 空闲瞥视 (默认开启)负责在所有角色同时空闲时,调节他们之间偶尔的眼神交流。
预期结果: 两个倾听角色会转身面向正在发言的人,而当场景进入空闲时,三名角色会偶尔交换眼神,而不是呆呆地直视前方。
场景 4:先看目标,再回答问题
情况: 在设备培训模拟中,一名技术员 NPC 被要求读取表盘数值。它应在报告读数前明显先看向表盘,而不是头仍朝向学员就立即作答。
动作执行器
GazeAt 配合显式的 投入度 的 1 可用于任何对话状态,包括 空闲,并且优先于所有自动目标。等待 handle.Settled 会在角色确实已经看过去之后才放行回答—— Settled 会在凝视明显对准目标后才完成,因此报告的数值绝不会在眼神到位之前出现。 ConvaiActionExecutionResult.Answered 是唯一会告知角色本身的结果部分;是否说出答案会在 Actions Editor 中按动作单独决定。
预期结果: 技术员会在报告读数前明显先看向表盘——在角色的凝视落定到目标之前,答案绝不会返回。
下一步
脚本控制的视线视线目标与提供器排查视线问题最后更新于
这有帮助吗?