> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze/how-gaze-works.md).

# 视线工作原理

了解 Gaze 模块如何选择目标、在眼睛、头部和身体之间共享注视，并对对话的状态作出反应。

`ConvaiGazeController` 决定角色注视谁，以及注视时的专注程度，然后按固定顺序将注视动作传递到身体各部位，确保眼睛、头部和躯干始终对准同一目标。本页介绍这一决策背后的流程：如何选择目标、角色的 [对话状态](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/core-concepts/dialogue-state.md) 如何改变其专注程度，以及为什么眼部动作和身体转向会像一个连贯的动作，而不是两个独立系统各自运作。

### 三阶段流程

每次认知更新时，Gaze 都会按顺序执行相同的三个阶段。

| 阶段   | 问题           | 由什么决定                                                     |
| ---- | ------------ | --------------------------------------------------------- |
| 目标选择 | 角色应该看向谁或什么？  | 目标提供程序发布的候选目标，以及任何脚本化的 `GazeAt` 请求，按优先级进行解析。              |
| 策略   | 角色应该投入多少注意力？ | 配置文件状态策略表中当前对话状态对应的条目，并根据情绪和语音活动进行调整。                     |
| 求解器  | 注视动作如何实现？    | 先转动躯干，再转动颈部和头部，然后移动眼睛，最后调整眼睑——每一层动作都叠加在角色的 Animator 姿势之上。 |

将目标选择与策略分开，背后的原因是“看什么”和“投入多少注意力”会因不同原因而改变：任何时候都可能出现新的候选目标，但角色投入多少注意力，应由对话的进展决定，而不是由候选目标出现的时机决定。

### 如何选择目标

目标提供程序每次更新都会发布候选目标，仲裁器按优先级解析，而不是由最先注册的目标胜出。

1. **脚本化的 `GazeAt()` 请求会首先生效，** 前提是角色处于 `Natural` 或 `Social`保真度的注视模式——请参阅 [脚本化注视](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze/scripted-gaze.md)。除非启用了 `Exact`保真度的注视模式，否则会拒绝脚本化请求；若要接受此类请求，需启用 `AllowScriptedOverridesDuringExactFocus` 。
2. **除此之外，一切均由优先级层级决定。** 玩家锚点的优先级为 10，其他 Convai 角色为 7，世界物体为 5。较高层级始终会抢占较低层级。
3. **在同一层级内，当前目标具有黏性。** 只有当角色对当前目标的兴趣消退，或达到保持时间上限时，才会转而扫视优先级相同的其他目标。

由于玩家锚点处于最高优先级，只要当前对话状态的策略允许，玩家就是角色的主要目标。如需将角色的注意力转向其他位置（例如过场动画摄像机，或分屏中的第二位玩家），可以在玩家目标提供程序上设置显式锚点，或以更高优先级注册自己的 `IGazeTargetProvider` 。请参阅 [注视目标与提供程序](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze/targets-and-providers.md).

### 对话状态如何改变注意力投入程度

`ConvaiGazeController` 不会对对话中的每个时刻一视同仁。配置文件中的状态策略表会为每种 [对话状态](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/core-concepts/dialogue-state.md) 指定投入程度、玩家是否算作有效目标，以及是否允许身体转向：

| 对话状态                       | 交互程度    | 玩家是有效目标   | 允许转动身体 |
| -------------------------- | ------- | --------- | ------ |
| `Idle`                     | 最低      | 否——改为环顾四周 | 否      |
| `Attending`                | 高       | 是         | 是      |
| `Listening`                | 最高      | 是         | 是      |
| `Thinking`                 | 降低      | 是         | 否      |
| `Speaking`                 | 完全      | 是         | 是      |
| `Reacting` / `Interrupted` | 完全／接近完全 | 是         | 是      |
| `Settling`                 | 降低      | 是         | 否      |

未列在配置文件表格中的状态会回退到 `Idle` 这一行。因此，角色在 `Idle`时会忽略玩家，在 `Attending`, `Listening`期间投入交流，在 `Speaking`期间也是如此，并在 `Thinking` 和 `Settling` 期间再次减弱目光接触——每次状态转换都由同一张表驱动，而不是为每种状态单独编写规则。 [配置眼神接触](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze/configure-eye-contact.md) 介绍了 `GazeEyeContactMode` 设置；对于必须始终注视玩家的角色，此设置可以完全覆盖这张表。

### 视线如何带动身体转动

设定目标和注视投入程度后，求解器阶段会按固定顺序让角色转向目标：先转躯干，再转颈部和头部，接着转动眼睛，最后调整眼睑。眼睛会先转向新目标，头部随后片刻才跟上——这与真人先动眼、再转头的顺序相同，而不是整个身体同时突然转向。若角度足够大，例如玩家站在角色身后，角色自身也会转身，让目标重新出现在前方；具体采用角色自己的原地转身动画，还是平滑的程序化旋转，取决于角色具备哪些化身模块。

这种分层顺序也解释了为什么视线系统不会与角色的 Animator 姿势冲突：每个求解器阶段都会在 Animator 为该帧摆好骨骼姿势后运行，因此，由视线驱动的头部旋转会调整动画姿势，而不是与之争夺控制权。有关所有化身模块共用的每帧执行顺序，请参阅 [化身的工作原理](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/how-embodiment-works.md) 。

### 跟随对话

`ConvaiGazeController.AttendToSpeaker` (`GazeSpeakerAttention`）用于控制角色是否会转头看向房间里当前正在说话的其他人；这就是多人对话中“大家都看向说话者”的行为。此功能仅在角色轮到别人发言时生效，因此不会与角色自身对话时的眼神接触行为冲突。

| 模式           | 行为                                       |
| ------------ | ---------------------------------------- |
| `Off`        | 该角色从不跟随其他人的回合。                           |
| `Player`     | 玩家说话时转向玩家；忽略其他角色的回合。                     |
| `Characters` | 其他角色说话时转向该角色；从不转向玩家。                     |
| `任何人` （默认）   | 转向当前发言者，无论是玩家还是角色。玩家打断正在说话的角色时，会立即获得发言权。 |

#### 注意力会逐渐消退，而不是到时限后突然结束

每个倾听者都会追踪其他参与者当前各自占据了多少注意力。开始说话、被直接称呼或被期待作答，都会提高相应数值；除此之外，数值不会上升。在这些事件之间，注意力会持续逐渐消退，而不是一直保持到固定期限后再一次性释放。倾听者会看向数值最高的人，因此，即使对话在停顿后继续，注意力也会自然地转向周遭的日常活动，而不是像灯光开关一样突然熄灭。对于同一事件，每个倾听者都会根据说话者与自己的距离及其重要程度，独立计算反应延迟，因此一群倾听者不会在同一帧转头。此外，场景还会强制要求任意两名倾听者对同一事件的反应之间至少间隔一段时间；如果独立计算出的反应时间过于接近，就会将它们错开。这四项设置——典型反应延迟、延迟变化幅度、注意力消退所需时间，以及倾听者之间的最小间隔——位于配置文件的 [对话注意力](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze/profile-reference.md#conversation-attention) 组中。

当前正在被称呼的角色不受此系统影响：它的眼神交流由自身的对话状态策略控制，因此看起来像是正在被交谈的对象，而不是又一个倾听者。眼神交流锁定（`GazeEyeContactMode.ConversationLock` 或 `AlwaysLock`）会完全覆盖注意力系统——锁定意味着角色会一直看着玩家。

#### 跟随发言权，而不是语音标记

当前说话者拥有发言权，而且发言权会延续：说话者在自己的停顿期间仍保有发言权，因此倾听者不会在对方刚换气时就移开视线。要从当前持有者手中接过发言权，需要持续说话——咳嗽、一声“嗯”，或语音检测的一次误报，都短暂得更像插话，而不是回合变化，因此不会让房间里的所有人都转头。系统会在本地通过玩家自己的麦克风判断发言权，而不只是等待服务端往返确认，因此房间会在玩家开口的第一个字时开始转头，无须等待网络往返。玩家发送文字消息时，也会像开口说话一样获得发言权。

#### 轻微移动不会触发重新规划

每个注视目标都会先经过平滑处理，再由移动检测器进行评估，因此普通的交谈时身体摇摆和摄像机抖动不会触发新的头部移动计划。大幅度、突然的位置变化——例如镜头切换或传送——仍会立即触发重新锁定目标，而不会造成拖沓、不自然的跟随。

#### 各个人格预设自行设定参数

ConvaiGazeProfile `ConvaiGazeProfile` — `Default`, `Confident`, `Warm`, `Attentive`, `Shy`, `Stoic` — 中的每个人格预设都会为“对话注意力”组自行设定参数，其他所有影响整体感受的字段也同样如此。 `Confident` 例如，某个预设的反应更慢，并且比 `Warm` 更长时间保持对说话者的注意力；这也是两种预设在群体场景中呈现不同效果的原因之一。

在 Play 模式下， `ConvaiGazeController` 检查器的 Live 部分、Gaze 编辑器窗口以及 `Convai.DiagnoseGaze` 助手工具都会各自报告一行信息，指出角色正在看谁，或者是哪道条件——距离、角度或视线——使角色没有转向某位说话者。

### 后续步骤

{% content-ref url="/pages/516efa6367dbd72ce53d95eaab31db343afd4757" %}
[Gaze 快速开始](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze/quick-start.md)
{% endcontent-ref %}

{% content-ref url="/pages/3e45c80fb1153e604c743a1f3a0a835d39719b0e" %}
[配置眼神接触](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze/configure-eye-contact.md)
{% endcontent-ref %}

{% content-ref url="/pages/864133eda5776302d8f8f9afeef2de62388e08bc" %}
[视线目标与提供器](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze/targets-and-providers.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze/how-gaze-works.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
