> 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/profile-reference.md).

# Gaze 配置文件参考

Convai Gaze 配置文件资源中每个设置组和字段的参考，包括每项的默认值和取值范围。

`ConvaiGazeProfile` (`Convai/Embodiment/Gaze Profile`) 是 Convai 注视系统的唯一配置资源：涵盖目标选择、各状态策略、头部/躯干求解、眼球运动模型、眨眼、身体转向、待机动作、情绪调节、对话注意力和诊断。设置分为 16 个嵌套区块，每个区块对应一项配置关注点；无论读取哪个区块，所有公共访问器的名称和类型都保持不变。

### 目标选择

哪些人或物值得注视，以及角色会对其保持兴趣多久。

| 字段                            | 类型      | 默认值                            | 范围        | 说明                                                                                        |
| ----------------------------- | ------- | ------------------------------ | --------- | ----------------------------------------------------------------------------------------- |
| `PlayerMaxDistance`           | `float` | `8` （米）                        | `>= 0`    | 超过此距离后，玩家锚点将完全失去相关性。                                                                      |
| `PlayerFullRelevanceDistance` | `float` | `4` （米）                        | `>= 0`    | 低于此距离时，玩家锚点具有完全相关性。                                                                       |
| `PlayerLineOfSight`           | `bool`  | `false`                        | —         | 仅适用于自动创建的玩家锚点：要求与玩家之间视线无遮挡。                                                               |
| `PlayerObstructionMask`       | `int`   | `Physics.DefaultRaycastLayers` | —         | 仅适用于自动创建的玩家锚点：视为视觉遮挡物的图层。                                                                 |
| `TargetTeleportThreshold`     | `float` | `1.25` （米/帧）                   | `>= 0.05` | 将目标位移视为镜头切换/瞬移的阈值：注视会通过一次扫视重新捕获目标，而不是拖动视线。                                                |
| `CommitmentAcquireSeconds`    | `float` | `0.35`                         | `>= 0.01` | 获得目标后，投入程度逐渐提升所需的秒数。                                                                      |
| `CommitmentReleaseSeconds`    | `float` | `0.9`                          | `>= 0.01` | 目标丢失或释放后，投入程度逐渐降低所需的秒数。                                                                   |
| `TargetLossHoldSeconds`       | `float` | `0.6`                          | `>= 0`    | 目标丢失后，在衰减至环境注视之前，保持最后一个目标点的秒数。                                                            |
| `InterestDecayPerSecond`      | `float` | `0.05`                         | `>= 0`    | 当前保持的目标每秒损失的兴趣值。                                                                          |
| `InterestRecoveryPerSecond`   | `float` | `0.1`                          | `>= 0`    | 未被选中的候选目标每秒恢复的兴趣值。                                                                        |
| `MaxContinuousHoldSeconds`    | `float` | `14`                           | `>= 1`    | 存在其他候选目标时，连续注视同一候选目标的最长时间。                                                                |
| `InterestBreakThreshold`      | `float` | `0.15`                         | `0`–`1`   | 低于此兴趣值时，仲裁器会强制切换到其他候选目标。                                                                  |
| `EnableTargetLossSearch`      | `bool`  | `true`                         | —         | 如果玩家目标在对话中丢失，且投入时间已达 2 秒或更长，则保持最后已知位置，并执行一小段搜索性扫视，然后再释放并进入常规衰减流程。此功能绝不会在以下状态期间生效： `Idle`. |
| `TargetLossSearchMaxSeconds`  | `float` | `3`                            | `1`–`5`   | 目标丢失后的搜索持续时间上限；达到上限后会释放目标并进入常规衰减流程。                                                       |
| `EnableLookAtActionTargets`   | `bool`  | `false`                        | —         | 在当前动作步骤持续期间，瞥向该步骤所涉及的对象。默认关闭——启用后，角色往往会显得在盯着自己的手看。不会影响行走角色的注视目标。                          |

### 对话状态

各`DialogueState` 对应的注视策略：角色在每个对话环节中对其注视目标的专注程度。有关此表所依据的八值状态模型，请参阅 [对话状态](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/core-concepts/dialogue-state.md) 。

| 字段                 | 类型                               | 默认值                              | 说明                            |
| ------------------ | -------------------------------- | -------------------------------- | ----------------------------- |
| `StatePolicies`    | `IReadOnlyList<GazeStatePolicy>` | 共 8 个预设条目，每个对应一个 `DialogueState` | 按状态设置策略。未列出的状态将回退到 `Idle` 条目。 |
| `PolicyBlendSpeed` | `float`                          | `5`                              | 范围 `0`–`20`。当前策略变更时应用的指数平滑速度。 |

每个 `GazeStatePolicy` 条目包含 `State`, `Engagement` (`0`–`1`), `AllowPlayerTarget` (`bool`), `HeadContribution` (`0`–`1`), `AllowBodyTurn` (`bool`), `AversionMode` (`None`, `Cognitive`, `Natural`), `AversionStrength` (`0`–`1`），以及 `FixationLiveliness` (`0`–`2`）。预设默认值：

| 状态            | 投入程度   | 允许以玩家为目标 | 头部参与度  | 允许身体转向  | 回避模式        | 回避强度   | 注视活跃度 |
| ------------- | ------ | -------- | ------ | ------- | ----------- | ------ | ----- |
| `Idle`        | `0`    | `false`  | `0.35` | `false` | `None`      | `0`    | `1`   |
| `Attending`   | `0.9`  | `true`   | `0.85` | `true`  | `Natural`   | `0.15` | `1`   |
| `Listening`   | `0.95` | `true`   | `0.85` | `true`  | `Natural`   | `0.08` | `1.1` |
| `Thinking`    | `0.7`  | `true`   | `0.6`  | `false` | `Cognitive` | `0.7`  | `1.3` |
| `Speaking`    | `1`    | `true`   | `0.85` | `true`  | `None`      | `0`    | `1`   |
| `Reacting`    | `1`    | `true`   | `0.9`  | `true`  | `None`      | `0`    | `1.2` |
| `Interrupted` | `0.95` | `true`   | `0.9`  | `true`  | `None`      | `0`    | `1.1` |
| `Settling`    | `0.6`  | `true`   | `0.6`  | `false` | `Natural`   | `0.25` | `0.9` |

### 头部和躯干

目光会调动眼睛以外的身体部位，程度如何。

| 字段                       | 类型      | 默认值         | 范围           | 说明                                                            |
| ------------------------ | ------- | ----------- | ------------ | ------------------------------------------------------------- |
| `HeadFollowSeconds`      | `float` | `0.2`       | `0.05`–`0.8` | 头部跟随已在移动的目标的速度。数值越低，头部越贴近快速移动的目标；数值越高，头部跟随目标时的滞后越明显，由眼睛补足差距。  |
| `TorsoFollowSeconds`     | `float` | `0.35`      | `0.05`–`1.2` | 胸部跟随已在移动的目标的速度。应比头部慢——如果胸部紧跟头部，会显得不自然。                        |
| `HeadStabilization`      | `float` | `1`         | `0`–`1`      | 启用时，头部抵消动画自身头部运动的程度。在 `1` 时，头部保持水平，视线保持居中；较低的值会让动画中的头部摆动显现出来。 |
| `MaxHeadAngularSpeed`    | `float` | `150` （度/秒） | `30`–`720`   | 头部角速度的安全上限，而不是用于设置转向速度的参数。调校正确的角色永远不会达到此上限。                   |
| `MaxTorsoAngularSpeed`   | `float` | `90` （度/秒）  | `30`–`480`   | 胸部角速度的安全上限。                                                   |
| `MaxHeadYawDegrees`      | `float` | `55`        | `0`–`60`     | 颈部与头部骨骼链共同贡献的最大偏航角。                                           |
| `MaxHeadPitchDegrees`    | `float` | `32`        | `0`–`45`     | 颈部与头部骨骼链共同贡献的最大俯仰角。                                           |
| `NeckShare`              | `float` | `0.35`      | `0`–`1`      | 由颈骨承担的头部骨骼链旋转比例；其余部分由头骨承担。                                    |
| `ChainFollowThrough`     | `float` | `1`         | `0`–`1`      | 转向时，身体参与转动的程度，而非整个头部骨骼链作为一个整体转动。 `0` 会使骨骼链僵硬地转动。              |
| `EnableTorsoRecruitment` | `bool`  | `true`      | —            | 当注视幅度超出头部的舒适范围时，让胸部/上胸部参与转动。                                  |
| `MaxTorsoYawDegrees`     | `float` | `22`        | `0`–`40`     | 胸部与上胸部共同贡献的最大偏航角。                                             |
| `MaxTorsoPitchDegrees`   | `float` | `6`         | `0`–`20`     | 胸部与上胸部共同贡献的最大俯仰角。                                             |

### 注视转移阶梯

注视动作如何分配到身体各部位，以及各部位按什么顺序参与。进入角度表示注视幅度必须达到多大，该部位才会参与；启动延迟表示眼睛开始转动后多久，该部位才开始移动。

| 字段                          | 类型      | 默认值      | 范围           | 说明                                                             |
| --------------------------- | ------- | -------- | ------------ | -------------------------------------------------------------- |
| `HeadEntryDegrees`          | `float` | `12`     | `0`–`45`     | 注视方向偏离轴线多大时，头部才会参与转动。                                          |
| `TorsoEntryDegrees`         | `float` | `35`     | `0`–`90`     | 注视方向偏离轴线多大时，胸部才会参与转动。                                          |
| `FeetEntryDegrees`          | `float` | `25`     | `10`–`170`   | 头部和胸部仍无法达到的注视偏差达到多大时，脚部才会转动；此处按剩余角度计算，而非原始角度。                  |
| `HeadOnsetSeconds`          | `float` | `0.12`   | `0`–`0.5`    | 眼睛开始转动后多久，头部才开始移动。                                             |
| `TorsoOnsetSeconds`         | `float` | `0.15`   | `0`–`0.8`    | 眼睛开始转动后多久，胸部才开始移动。                                             |
| `FeetOnsetSeconds`          | `float` | `0.25`   | `0`–`1.5`    | 眼睛开始转动后多久，脚部才可能开始转向。                                           |
| `HeadTurnBaseSeconds`       | `float` | `0.45`   | `0.05`–`0.9` | 小幅转头所需的时间。与 `HeadTurnSecondsPerDegree`一起决定完整的头部速度规律。           |
| `HeadTurnSecondsPerDegree`  | `float` | `0.0125` | `0`–`0.03`   | 头部每转过一度所增加的时间（秒）。                                              |
| `TorsoTurnBaseSeconds`      | `float` | `0.55`   | `0.05`–`1.4` | 小幅转动胸部所需的时间。                                                   |
| `TorsoTurnSecondsPerDegree` | `float` | `0.018`  | `0`–`0.05`   | 胸部每转过一度所增加的时间（秒）。                                              |
| `MovementSkew`              | `float` | `0.18`   | `0`–`0.5`    | 动作的前置程度。 `0` 为对称运动；值越大，动作启动越快，缓和阶段越长。超过大约 `0.3` 时，动作看起来就像受惊抽动。 |
| `ShiftTriggerDegrees`       | `float` | `2`      | `0.5`–`10`   | 目标方向需要跳变多大角度，才会被视为一个新动作，而非微调。                                  |
| `IdleDriftTempoScale`       | `float` | `1.35`   | `0.5`–`3`    | 闲暇时四处张望的速度比有目的注视慢多少。高于 `1` 时，角色在没有注意任何事物时会懒洋洋地四处游移。            |
| `EyeComfortDegrees`         | `float` | `14`     | `0`–`40`     | 眼睛偏离中心多远后，头部才会开始进一步转动以将视线带回。                                   |
| `HeadComfortYawDegrees`     | `float` | `35`     | `0`–`60`     | 头部可以保持转向多远，角色才会想要转动双脚——即使它已经能看见正在注视的目标。                        |

### 眼睛

眼动模型：活动范围、追随运动、扫视、细微动作和面部扫描。

| 字段                                | 类型                     | 默认值         | 范围              | 说明                                              |
| --------------------------------- | ---------------------- | ----------- | --------------- | ----------------------------------------------- |
| `EyeActuationMode`                | `GazeEyeActuationMode` | `Auto`      | —               | 眼部输出后端。 `Auto` 优先使用骨骼，若不可用则回退到 `EyeLook*` 混合形状。 |
| `EyeMaxYawDegrees`                | `float`                | `35`        | `10`–`55`       | 眼动范围：眼睛相对于静止位置的最大偏航角。                           |
| `EyeMaxPitchUpDegrees`            | `float`                | `22`        | `5`–`40`        | 眼动范围：眼睛向上的最大俯仰角。                                |
| `EyeMaxPitchDownDegrees`          | `float`                | `28`        | `5`–`45`        | 眼动范围：眼睛向下的最大俯仰角。                                |
| `EyeSoftLimitFraction`            | `float`                | `0.8`       | `0.5`–`1`       | 开始进行软限位压缩时所占的眼动范围比例。                            |
| `OrbitRecenteringStrength`        | `float`                | `0.6`       | `0`–`1`         | 头部跟上时，眼睛在眼眶内重新居中的力度。                            |
| `EyeTrackingSharpness`            | `float`                | `40`        | `5`–`90`        | 平滑追踪时的眼动追踪灵敏度；数值越高，追踪越紧密。                       |
| `SaccadeMinDurationSeconds`       | `float`                | `0.03`      | `0.01`–`0.08`   | 扫视最短持续时间——主序列截距。                                |
| `SaccadeDurationPerDegree`        | `float`                | `0.0022`    | `0.0005`–`0.01` | 振幅每增加一度所增加的扫视持续时间——主序列斜率。                       |
| `SaccadeDeadzoneDegrees`          | `float`                | `0.75`      | `0.1`–`5`       | 低于此注视误差时，不会触发纠正性扫视。                             |
| `SaccadeReactionSeconds`          | `float`                | `0.12`      | `0`–`0.4`       | 扫视反应延迟：眼睛开始转向新目标或发生位移的目标之前的停顿时间。                |
| `CatchUpErrorDegrees`             | `float`                | `5`         | `1`–`20`        | 追踪误差超过此值时会触发追赶性扫视。                              |
| `PursuitLeadSeconds`              | `float`                | `0.04`      | `0`–`0.25`      | 预测性追踪提前量：眼睛沿测得的速度方向，略微瞄准移动目标前方。 `0` 禁用预测。       |
| `EnableVergence`                  | `bool`                 | `true`      | —               | 让双眼聚焦于近处目标（每只眼睛的偏航角各不相同，适用于 VR 中身体前倾的场景）。       |
| `VergenceMinDistance`             | `float`                | `0.14` （米）  | `0.05`–`1`      | 支持的最近会聚距离；更近的目标会被限制在此距离。                        |
| `MaxConvergenceDegrees`           | `float`                | `16`        | `2`–`30`        | 每只眼睛的最大向内会聚角度——限制斗鸡眼程度。                         |
| `SyntheticInterpupillaryDistance` | `float`                | `0.063` （米） | `0.05`–`0.08`   | 仅当骨骼绑定中没有眼部骨骼时使用的瞳距。                            |
| `FixationDriftDegrees`            | `float`                | `0.35`      | `0`–`2`         | 注视漂移幅度：注视时缓慢游移的程度。                              |
| `FixationDriftFrequency`          | `float`                | `0.5` （Hz）  | `0.05`–`3`      | 注视漂移频率。                                         |
| `MicroSaccadeIntervalMean`        | `float`                | `1.5`       | `0.2`–`6`       | 注视期间微扫视间隔的平均秒数。                                 |
| `MicroSaccadeIntervalJitter`      | `float`                | `0.9`       | `0`–`4`         | 应用于微扫视间隔的均匀抖动。                                  |
| `MicroSaccadeAmplitudeDegrees`    | `float`                | `0.5`       | `0`–`2`         | 微眼跳幅度。                                          |
| `EnableFaceScan`                  | `bool`                 | `true`      | —               | 注视玩家或人脸时，在推定的人脸特征点（眼睛/嘴巴）之间扫描。                  |
| `FaceScanIntervalMean`            | `float`                | `2.1`       | `0.5`–`6`       | 人脸扫描注视点切换的平均间隔（秒）。                              |
| `FaceScanIntervalJitter`          | `float`                | `1.2`       | `0`–`4`         | 应用于人脸扫描间隔的均匀抖动。                                 |
| `FaceScanRadiusDegrees`           | `float`                | `2.2`       | `0.5`–`6`       | 推定人脸特征点三角形的角半径。                                 |
| `EnableListenerMouthBias`         | `bool`                 | `true`      | —               | 玩家说话时，将人脸扫描注视点偏向嘴部特征点。                          |
| `ListenerMouthBiasStrength`       | `float`                | `2`         | `1`–`4`         | 完全启用听者嘴部偏向时，嘴部特征点选择权重的乘数。                       |

### 眨眼与眼睑

统计性眨眼和眼睑行为。

| 字段                               | 类型      | 默认值    | 范围           | 说明                                          |
| -------------------------------- | ------- | ------ | ------------ | ------------------------------------------- |
| `EnableBlink`                    | `bool`  | `true` | —            | 通过面部合成器实现统计性眨眼。                             |
| `BlinkIntervalMean`              | `float` | `4.2`  | `1`–`12`     | 自发眨眼的平均间隔（秒）。                               |
| `BlinkIntervalJitter`            | `float` | `2.2`  | `0`–`8`      | 应用于眨眼间隔的均匀抖动。                               |
| `BlinkCloseSeconds`              | `float` | `0.07` | `0.02`–`0.2` | 眼睑闭合时间。                                     |
| `BlinkOpenSeconds`               | `float` | `0.16` | `0.04`–`0.4` | 眼睑张开时间。                                     |
| `BlinkRefractorySeconds`         | `float` | `0.6`  | `0.1`–`2`    | 不允许开始新一次眨眼的不应期。                             |
| `GazeShiftBlinkThresholdDegrees` | `float` | `18`   | `0`–`90`     | 注视偏移幅度超过此值时，偏移过程中可能伴随眨眼。 `0` 禁用。            |
| `GazeShiftBlinkProbability`      | `float` | `0.55` | `0`–`1`      | 大幅注视偏移触发眨眼的概率。                              |
| `EnableEyelidFollow`             | `bool`  | `true` | —            | 眼睑随眼球垂直转动（向下看时眼睑下垂）。                        |
| `EyelidFollowStrength`           | `float` | `0.6`  | `0`–`1`      | 眼睑随眼球俯仰转动的强度。                               |
| `EnableBlinkClustering`          | `bool`  | `true` | —            | 在认知边界之后的一小段时间内提高眨眼概率，例如话语结束、收到最终转录结果或玩家暂停时。 |
| `BlinkClusterRateMultiplier`     | `float` | `3`    | `1`–`6`      | 眨眼率乘数，应用时间约为 `0.7` 秒，从聚集提示出现后开始计算。          |

### 身体转向

当一次注视变成全身转向。

| 字段                                   | 类型      | 默认值        | 范围         | 说明                                                                                                         |
| ------------------------------------ | ------- | ---------- | ---------- | ---------------------------------------------------------------------------------------------------------- |
| `EnableBodyTurn`                     | `bool`  | `true`     | —          | 允许全身转向注视目标。是否执行仍受状态策略控制。                                                                                   |
| `BodyTurnCompletionToleranceDegrees` | `float` | `8`        | `1`–`30`   | 低于此偏航误差时，转向视为完成。                                                                                           |
| `BodyTurnHeadRelief`                 | `float` | `1`        | `0`–`1`    | 身体转动时，头部保留多少注视目标的转向量。在 `1` 时，头部会始终朝向目标，并且只有当身体带动目标转过一定角度时才逐渐回正；较低的值会让头部在请求身体转向的那一刻就放弃相应比例的转向量，此时身体实际上还未移动。 |
| `ProceduralTurnSpeed`                | `float` | `90` （度/秒） | `45`–`540` | 没有可用的动画处理程序时，程序化备用转向的峰值速度。这是转向过程中最快的速度，而不是平均速度——使用默认值时，角色站立不动，转过 180° 约需三秒半。                               |

### 闲置时的行为

当没有任何事物吸引角色注意时，它的眼睛会做什么。

| 字段                                          | 类型      | 默认值           | 范围                    | 说明                                                                        |
| ------------------------------------------- | ------- | ------------- | --------------------- | ------------------------------------------------------------------------- |
| `EnableAmbientExploration`                  | `bool`  | `true`        | —                     | 没有注视目标时，启用环境性眼部/头部探索。                                                     |
| `AmbientYawRangeDegrees`                    | `float` | `26`          | `0`–`60`              | 环境性探索的偏航范围。                                                               |
| `AmbientPitchUpDegrees`                     | `float` | `8`           | `0`–`30`              | 环境性探索的向上俯仰范围。                                                             |
| `AmbientPitchDownDegrees`                   | `float` | `12`          | `0`–`30`              | 环境性探索的向下俯仰范围。                                                             |
| `AmbientIntervalMin` / `AmbientIntervalMax` | `float` | `1.7` / `4.6` | `0.4`–`10` / `1`–`20` | 环境性注视点变化的间隔范围。                                                            |
| `AmbientHeadFollow`                         | `float` | `0.35`        | `0`–`1`               | 环境性注视中由头部承担的比例；其余部分仅由眼睛完成。                                                |
| `AmbientRecenterBias`                       | `float` | `0.35`        | `0`–`1`               | 倾向于回到中心，而不是选择新的偏心注视点。                                                     |
| `EnableCuriosityGlances`                    | `bool`  | `true`        | —                     | 角色闲置时，偶尔由眼睛带动，短暂瞥向玩家。                                                     |
| `CuriosityGlanceIntervalMin` / `Max`        | `float` | `7` / `16`    | `2`–`30` / `4`–`60`   | 好奇性瞥视之间的间隔范围。                                                             |
| `CuriosityGlanceDuration`                   | `float` | `1.2`         | `0.3`–`4`             | 好奇性瞥视的持续时间。                                                               |
| `CuriosityRespondsToAttention`              | `bool`  | `false`       | —                     | 闲置时，如果 `PlayerAttentionSensor` 报告玩家正看着该角色，就更快地回望玩家。需要启用好奇性瞥视，并且场景中存在该传感器。 |

### 移动途中

角色走向某处时的注视方向。

| 字段                                     | 类型      | 默认值           | 范围                      | 说明                                                          |
| -------------------------------------- | ------- | ------------- | ----------------------- | ----------------------------------------------------------- |
| `EnableTravelGaze`                     | `bool`  | `true`        | —                       | 行走时注视前方路径，并不时查看目的地。                                         |
| `EnableDestinationGlances`             | `bool`  | `false`       | —                       | 行走时，每隔几秒瞥一眼目的地或正在跟随的对象。默认关闭，因为这类瞥视由倒计时触发，而非角色注意到什么后触发。      |
| `TravelPathPriority`                   | `int`   | `15`          | `>= 1`                  | 路径与其他注视目标竞争的优先级强度——低于玩家锚点的优先级 `10` 这是有意为之，这样跟随角色就不会一路盯着玩家看。 |
| `PathLookAheadMinMeters` / `MaxMeters` | `float` | `3` / `8`     | `0.5`–`20` / `1`–`40`   | 角色以步行速度／全速行进时向前注视的距离。                                       |
| `TravelEngageSeconds`                  | `float` | `0.35`        | `0.05`–`2`              | 切换到行进注视所需的时间。                                               |
| `TravelGlanceIntervalMin` / `Max`      | `float` | `2.5` / `5`   | `0.5`–`20` / `1`–`30`   | 角色瞥向行进目标地点的时间间隔范围。                                          |
| `CompanionGlanceIntervalMin` / `Max`   | `float` | `1.6` / `3.2` | `0.3`–`20` / `0.5`–`30` | 角色瞥向跟随对象的时间间隔范围。                                            |
| `TravelGlanceHoldSeconds`              | `float` | `0.55`        | `0.15`–`3`              | 每次行进注视持续的时间。                                                |
| `TravelGlanceConversationScale`        | `float` | `0.5`         | `0.05`–`1`              | 角色与他人交谈时，注视间隔会缩短多少。 `0.5` 表示注视频率加倍。                         |
| `ArrivalSettleEyeDropDegrees`          | `float` | `4`           | `0`–`12`                | 角色在行走结束时停下来，眼睛短暂下垂的角度。仅影响眼睛； `0` 将其禁用。                      |
| `ArrivalSettleSeconds`                 | `float` | `0.7`         | `0`–`2`                 | 从眼睛下垂到重新抬起，完成停稳动作所需的时间。                                     |
| `ArrivalApproachMeters`                | `float` | `3`           | `0.5`–`15`              | 角色距离目的地多近时开始停稳动作。                                           |
| `ArrivalReleaseMeters`                 | `float` | `1.2`         | `0.1`–`10`              | 角色距离目的地多近时完全停止注视道路。                                         |
| `TravelHeadContributionScale`          | `float` | `0.8`         | `0`–`1`                 | 与面部相比，头部跟随道路注视的程度。行走时的注视比交谈时更依赖眼睛。                          |

### 交谈手势

点头和受打断时的惊吓反应。

| 字段                                | 类型      | 默认值         | 范围                  | 说明                                                                                      |
| --------------------------------- | ------- | ----------- | ------------------- | --------------------------------------------------------------------------------------- |
| `EnableListeningNods`             | `bool`  | `true`      | —                   | 角色聆听时轻轻点头示意。角色说话时绝不会点头。                                                                 |
| `NodPitchDegrees`                 | `float` | `3`         | `1`–`10`            | 聆听时点头向下的最大角度。                                                                           |
| `NodDurationSeconds`              | `float` | `0.55`      | `0.3`–`2`           | 一次点头的持续时间——先向下点一下，再较慢地抬回。                                                               |
| `ListeningNodIntervalMin` / `Max` | `float` | `3.5` / `8` | `1`–`20` / `2`–`30` | 聆听点头之间的间隔范围。                                                                            |
| `AcknowledgeNodProbability`       | `float` | `0.7`       | `0`–`1`             | 在 `Listening` 开始时点头的概率。                                                                 |
| `EnableInterruptionReaction`      | `bool`  | `true`      | —                   | 角色在句中被打断时，播放一次约 1 秒的受惊微反应（重新捕捉目标的扫视、眨眼、轻微歪头）（`Speaking` → `Interrupted`）。角色再次开口前不会重复触发。 |
| `InterruptionReactionIntensity`   | `float` | `0.7`       | `0`–`1`             | 打断时受惊反应的幅度，主要影响歪头程度。                                                                    |

### 对话节奏

角色持有发言权时的轮流发言编排。

| 字段                         | 类型      | 默认值     | 说明                                                                                                  |
| -------------------------- | ------- | ------- | --------------------------------------------------------------------------------------------------- |
| `EnableTurnTakingGaze`     | `bool`  | `true`  | 在 `Speaking` (`Natural` （自然眼神交流模式）期间的轮流发言眼神编排：对简短或即时回应保持直接眼神接触，对较长回答偶尔进行有限度的视线移开，并在说话结束后给出让出发言权的提示。 |
| `PlanningBreakProbability` | `float` | `0.7`   | 范围 `0`–`1`。符合条件时进行思考停顿的倾向。简短或即时回应不会出现视线停顿。                                                          |
| `EnableYieldBlink`         | `bool`  | `true`  | 在话语接近结束时，作为让出发言权提示的一部分，播放一次刻意的眨眼。                                                                   |
| `EnableYieldHeadDip`       | `bool`  | `false` | 说话结束后，在让出发言权的提示中加入轻微低头动作。默认禁用，以避免看起来像表示认可的点头。                                                       |

### 情绪调制

主导情绪如何影响眼神行为。

| 字段                        | 类型                                   | 默认值                                 | 说明                                                                   |
| ------------------------- | ------------------------------------ | ----------------------------------- | -------------------------------------------------------------------- |
| `EnableEmotionModulation` | `bool`                               | `true`                              | 根据主导情绪调整眼神行为。如果不存在 Emotion 模块，调制器会读取中性情绪并生成单位缩放值，因此对没有情绪的角色不会产生任何开销。 |
| `EmotionModifiers`        | `IReadOnlyList<EmotionGazeModifier>` | 内置 3 个条目（`sadness`, `joy`, `anger`) | 对应情绪占主导时应用的逐情绪修饰项。                                                   |

每个 `EmotionGazeModifier` 都包含 `EmotionLabel` (`string`), `EngagementScale` (`0`–`1.5`), `AversionScale` (`0`–`2`), `BlinkRateScale` (`0.25`–`2`), `LidApertureScale` (`0.5`–`1.5`), `AversionBias` (`GazeAversionBias`), `SaccadeTempoScale` (`0.7`–`1.3`），以及 `FixationLivelinessScale` (`0.25`–`2`）。默认配置会将 `EngagementScale`, `AversionScale`, `BlinkRateScale`，并且 `LidApertureScale` 中性（`1`），仅调整方向和速度字段：

| 情绪标签      | 厌恶偏差               | 扫视速度缩放 | 注视活跃度缩放 |
| --------- | ------------------ | ------ | ------- |
| `sadness` | `Down`             | `0.8`  | `1`     |
| `joy`     | `CognitiveDefault` | `1.15` | `1.2`   |
| `anger`   | `Side`             | `1.2`  | `1`     |

### 人际距离调节

玩家靠近时，眼神接触如何逐渐减弱。

| 字段                            | 类型      | 默认值    | 范围          | 说明                                                                           |
| ----------------------------- | ------- | ------ | ----------- | ---------------------------------------------------------------------------- |
| `EnableProxemicRegulation`    | `bool`  | `true` | —           | 玩家（在 VR 中）靠近时，减弱眼神接触，而不是始终凝视：距离越近，厌避下限越高、面部扫描半径越大、眨眼频率越快。眼神接触锁定生效时，此功能会完全停用。 |
| `ProxemicCloseDistanceMeters` | `float` | `0.6`  | `0.2`–`1.5` | 玩家开始被视为“靠近”的距离——低于此距离时，减弱效果会逐渐增强。                                            |
| `ProxemicIntensity`           | `float` | `1`    | `0`–`1`     | 人际距离调节减弱效果的整体强度。 `0` 会在保持开关开启的情况下禁用该效果。                                      |

### 对话注意力

角色在自己尚未发言时，如何关注当前发言者。开关位于 `ConvaiGazeController.AttendToSpeaker`；这些参数用于设置关注方式和限制，因此整个角色阵容共用一个配置文件。请参阅 [注视的工作方式](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze/how-gaze-works.md#following-the-conversation).

| 字段                                         | 类型      | 默认值        | 范围                  | 说明                                                                |
| ------------------------------------------ | ------- | ---------- | ------------------- | ----------------------------------------------------------------- |
| `SpeakerAttentionEngagement`               | `float` | `0.6`      | `0`–`1`             | 听者注意力的投入程度。此值刻意设得低于实际被交谈角色的投入程度——旁观者会看着发言者，但不会一直盯着对方。             |
| `SpeakerAttentionHeadContribution`         | `float` | `0.7`      | `0`–`1`             | 转向过程中由头部承担的比例；其余由眼睛完成，因此眼睛先转，头部随后跟上。                              |
| `SpeakerAttentionAllowBodyTurn`            | `bool`  | `false`    | —                   | 允许听者将整个身体转向发言者。默认关闭：旁观者只会转移视线，不会改变站位。启用后，角色也可以关注位于舒适头部转动角度之外的发言者。 |
| `SpeakerAttentionMaxAngleDegrees`          | `float` | `100`      | `20`–`180`          | 发言者相对于角色正前方的最大角度；超过此角度，角色便不会转向关注发言者，除非允许转动身体。                     |
| `SpeakerAttentionMaxDistance`              | `float` | `10` （米）   | `1`–`40`            | 超过此距离，发言者在注意力判定中就会被视为听不见。                                         |
| `ConversationReactionMedianSeconds`        | `float` | `0.28`     | `0.1`–`1`           | 听者对新发言者作出反应的典型延迟。实际延迟会按听者、按事件分别随机抽取，因此一群角色不会整齐划一地同时转头。            |
| `ConversationReactionSpread`               | `float` | `0.35`     | `0`–`1`             | 反应延迟的随机值围绕中位数的分散范围。 `0` 会使所有听者在同一时刻作出反应。                          |
| `ConversationAttentionDecaySeconds`        | `float` | `6`        | `1`–`30`            | 听者的注意力会持续减弱，逐渐从上次注视的对象移开，最终进入闲置状态。这不是超时，而是一个连续渐变的过程。              |
| `ConversationReactionMinSeparationSeconds` | `float` | `0.35`     | `0`–`0.5`           | 限制两名听者对同一段话语起始的反应之间的最短间隔，避免房间里的人同时转头。                             |
| `SpeakerAttentionHoldSeconds`              | `float` | `2.5`      | `0`–`8`             | 说话者停止讲话后，仍能保持发言权的时长；在一次发言的停顿间继续吸引听者的目光。                           |
| `SpeakerAttentionAversionStrength`         | `float` | `0.2`      | `0`–`1`             | 听者在专注聆听时，视线游移的程度。 `0` 表示目不转睛地盯着看。                                 |
| `SpeakerAttentionInterruptionSeconds`      | `float` | `0.6`      | `0.05`–`5`          | 其他人必须持续讲话多久，才能从当前持有发言权的人那里接过话轮。短于此时长的发言属于插话，房间里的人不会转头。            |
| `EnableAudienceChecks`                     | `bool`  | `true`     | —                   | 除了在话轮结束时看向对话对象外，也允许在话轮中途偶尔瞥向对话对象。                                 |
| `AudienceCheckIntervalMin` / `Max`         | `float` | `9` / `22` | `3`–`30` / `4`–`60` | 话轮中途进行听众确认注视的间隔范围。                                                |
| `AudienceCheckDuration`                    | `float` | `0.6`      | `0.2`–`3`           | 一次听众确认注视持续的时长，之后注意力会回到说话者身上。                                      |

### 性能

用于拥挤场景的细节层级调节项。

| 字段                  | 类型      | 默认值      | 范围       | 说明                                                 |
| ------------------- | ------- | -------- | -------- | -------------------------------------------------- |
| `EnableGazeLod`     | `bool`  | `false`  | —        | 人群的细节层级调节项：远处角色降低思考频率，画面外角色则完全跳过求解器阶段。默认关闭（需主动启用）。 |
| `LodFarDistance`    | `float` | `12` （米） | `2`–`60` | 超过此距离后，认知更新频率将降至远距离速率（带有 1 米迟滞）。                   |
| `LodFarCognitionHz` | `float` | `10`     | `1`–`30` | 超过远距离阈值的角色的认知更新频率。                                 |
| `SkipWhenInvisible` | `bool`  | `true`   | —        | 当角色的所有渲染器都未被摄像机看到时，跳过 `LateUpdate` 求解器阶段。          |

### 诊断

此角色的视线系统向控制台输出的内容。

| 字段               | 类型                   | 默认值   | 说明                                                                                            |
| ---------------- | -------------------- | ----- | --------------------------------------------------------------------------------------------- |
| `TraceVerbosity` | `GazeTraceVerbosity` | `Off` | 此角色视线跟踪的诊断详细程度。 `Off` 是正式发布版本的默认值——无论如何，警告和错误始终会记录。可用值： `Off`, `State`, `Detail`, `Firehose`. |
| `FirehoseHz`     | `float`              | `10`  | 范围 `1`–`60`。Firehose 转储的最大频率，仅在设为 `Firehose` 详细程度。                                            |

### 相关参考

{% content-ref url="/pages/e18fef943d7f4b642c516d5b9e2c689030154ddf" %}
[Gaze 脚本参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/gaze/scripting-reference.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 %}


---

# 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/profile-reference.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.
