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

# 肢体语言配置文件参考

Convai 角色肢体语言配置文件资产上的每个字段，按部分分组，并附带默认值和数值范围。

以下是 `ConvaiBodyLanguageProfile`中每个字段的参考说明。它是 Convai 身体语言模块唯一的创作资源。使用 **Assets > Create > Convai > Embodiment > Body Language Profile**创建资源；也可以不为角色分配配置文件，让其使用模块内置的默认值运行。

### 表现力

唯一的调节项，可协调地调整姿势、呼吸、摇摆、站姿、手势、反应、手部微动作和头部动作的幅度、频率与丰富度。

| 字段                      | 默认值       | 范围                                                            | 控制项                                                      |
| ----------------------- | --------- | ------------------------------------------------------------- | -------------------------------------------------------- |
| `Expressiveness Preset` | `Natural` | `Subtle` / `Natural` / `Expressive` / `Theatrical` / `Custom` | 已解析的表现力基准值。 `Custom` 使用 `Custom Expressiveness` 而非固定基准值。 |
| `Custom Expressiveness` | `0.5`     | `0`–`1`                                                       | 仅在 `Expressiveness Preset` 为 `Custom`.                   |

可随时使用 `ConvaiBodyLanguageController.Expressiveness` (`0`–`1`）设置运行时值；此值优先于配置文件，直到下次热切换配置文件。请参阅 [调整表现力](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/tune-expressiveness.md).

### 信号

用于快速手势通道的语音脉冲分析器调优。通常无需针对每个角色进行调整。

| 字段                               | 默认值    | 范围          | 控制项                          |
| -------------------------------- | ------ | ----------- | ---------------------------- |
| `Attack Seconds`                 | `0.05` | `0.005`–`1` | 语音能量上升时，对语音能量包络进行平滑处理。       |
| `Release Seconds`                | `0.15` | `0.01`–`2`  | 语音能量下降时，对语音能量包络进行平滑处理。       |
| `Baseline Window Seconds`        | `2.5`  | `0.2`–`30`  | 缓慢自适应基线的时间常数，该基线用于跟踪静息噪声水平。  |
| `Onset Threshold Above Baseline` | `0.12` | `0.01`–`1`  | 包络必须高于基线多少才会被判定为语音起始。        |
| `Release Hysteresis Fraction`    | `0.5`  | `0.05`–`1`  | 触发释放事件前，包络必须回落到低于起始阈值的比例。    |
| `Emphasis Derivative Threshold`  | `1.6`  | `0.1`–`20`  | 符合强调峰值条件的包络正导数（单位/秒）。        |
| `Refractory Seconds`             | `0.22` | `0`–`2`     | 两次触发的语音脉冲之间的最短间隔秒数，无论脉冲类型为何。 |
| `持续间隔秒数`                         | `0.9`  | `0.1`–`10`  | 语音持续处于活动状态时，持续心跳的触发间隔。       |

### 状态策略

`State Policies` 是一个按每个`DialogueState` 划分的表（`Idle`, `Attending`, `Listening`, `Thinking`, `Speaking`, `Reacting`, `Interrupted`, `Settling`）。未列出的状态将回退到 `Idle` 条目。每行包含：

| 字段                          | 范围       | 控制项                             |
| --------------------------- | -------- | ------------------------------- |
| `Gesticulation Enabled`     | 布尔值      | 此状态下是否允许伴随语音的手势动作（头部节拍动作、姿势脉冲）。 |
| `Gesticulation Intensity`   | `0`–`1`  | 启用时的整体手势动作强度。                   |
| `Listening Posture Enabled` | 布尔值      | 此状态下是否启用具身聆听姿势（身体前倾、保持静止）。      |
| `Listening Lean In`         | `0`–`1`  | 启用聆听姿势时，前倾幅度占姿势范围的比例。           |
| `Posture Openness Bias`     | `-1`–`1` | 正值使胸部打开、抬起；负值使胸部蜷缩、收拢。          |
| `Sagittal Lean Bias`        | `-1`–`1` | 正值表示身体向交谈对象倾斜；负值表示身体后撤。         |
| `Ambient Drift`             | `0`–`1`  | 此状态下角色原地摇摆的幅度。 `0` 会使角色完全保持静止。  |
| `Breath Rate Cpm`           | `4`–`30` | 此状态下每分钟的呼吸周期数。                  |
| `Breath Depth`              | `0`–`1`  | 相对于配置文件呼吸校准值的呼吸深度。              |
| `Breath Irregularity`       | `0`–`1`  | `0` 表示呼吸节奏平稳； `1` 表示屏息或呼吸不均匀。   |
| `Fidgets Enabled`           | 布尔值      | 此状态下是否允许出现静止时的细微小动作。            |
| `Fidget Rate`               | `0`–`1`  | 启用小动作时的相对动作频率。                  |

`Policy Transition Seconds` （默认值 `0.4`，范围 `0`–`20`) 设置对话状态变化时策略值混合的秒数； `0` 跳变。

### 姿势

| 字段         | 默认值     | 范围            | 控制项                                   |
| ---------- | ------- | ------------- | ------------------------------------- |
| `最大开放角度`   | `14°`   | `1`–`30°`     | 完整 ±1 开放度偏差对应的脊柱旋转角度。                 |
| `最大倾斜角度`   | `12°`   | `1`–`30°`     | 完整 ±1 矢状面倾斜偏差对应的脊柱旋转角度。               |
| `最大张力角度`   | `8°`    | `1`–`30°`     | 完整 ±1 肩部张力偏差对应的肩部旋转角度。                |
| `姿势弹簧锐度`   | `4`     | `0.5`–`20`    | 姿势弹簧的稳定速度——数值越高，稳定越快。                 |
| `姿势最大角速度`  | `90°/s` | `10`–`720°/s` | 姿势弹簧的角速度硬性上限。                         |
| `姿势目标渐变秒数` | `1.5s`  | `0.1`–`10s`   | 姿势目标逐渐趋向新状态/情绪目标所需的秒数。                |
| `姿势淡出秒数`   | `0.6s`  | `0.05`–`5s`   | 禁用或抑制全身动作时，姿势/呼吸主权重淡出的秒数。             |
| `最大横向偏移角度` | `5°`    | `1`–`15°`     | 完整 ±1 横向重心转移（小动作/思考时的不对称）目标对应的脊柱旋转角度。 |

### 站姿与摇摆

| 字段                              | 默认值    | 范围         | 控制项                                        |
| ------------------------------- | ------ | ---------- | ------------------------------------------ |
| `启用重心转移`                        | `on`   | 布尔值        | 骨盆周期性重心转移程序的总开关。                           |
| `重心转移间隔秒数`                      | `20s`  | `6`–`90s`  | 重心转移周期之间的平均秒数（按状态缩放）。                      |
| `重心转移间隔变化秒数`                    | `8s`   | `0`–`30s`  | 应用于重心转移间隔的随机变化量。                           |
| `Weight Shift Transfer Seconds` | `2.2s` | `0.8`–`5s` | 重心转移到新目标所需的秒数。                             |
| `Max Pelvis Offset Centimeters` | `3cm`  | `0`–`6cm`  | 横向重心转移距离。超过大约 `4cm` 的值需要腿部补偿，以避免脚部滑动。      |
| `Max Pelvis Obliquity Degrees`  | `2.5°` | `0`–`6°`   | 重心转移达到完整 ±1 时的骨盆倾斜（抬髋）角度。                  |
| `Max Pelvis Yaw Degrees`        | `3°`   | `0`–`8°`   | 重心转移达到完整 ±1 时的骨盆偏航角度。                      |
| `Enable Leg Compensation`       | `on`   | 布尔值        | 通过内部双骨骼腿部 IK 在重心转移时固定双脚。如果腿部骨骼链无法解析，则自动停用。 |
| `Enable Ambient Sway`           | `on`   | 布尔值        | 持续带限姿态摇摆效果的总开关。                            |
| `Max Sway Degrees`              | `0.6°` | `0`–`2°`   | 完整 ±1 姿态摇摆采样值所对应的脊柱旋转角度。                   |

### 头部动作

脚本化 `Nod`/`Shake`/`Tilt` 头部动作程序的峰值幅度（参见 [触发动作和反应](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/gestures-and-reactions.md)).

| 字段                                         | 默认值     | 范围        | 控制项                      |
| ------------------------------------------ | ------- | --------- | ------------------------ |
| `Head Gesture Nod Max Pitch Degrees`       | `8°`    | `1`–`15°` | 满强度 `Nod` 达到的最大俯仰角。      |
| `Head Gesture Shake Max Yaw Degrees`       | `9°`    | `1`–`15°` | 满强度 `Shake` 达到的最大偏航角。    |
| `Head Gesture Tilt Max Roll Degrees`       | `6°`    | `1`–`15°` | 峰值滚转达到全强度 `Tilt` 。       |
| `Head Gesture Refractory Seconds`          | `0.6s`  | `0`–`5s`  | 头部动作完成后，下一次动作开始前的最短间隔秒数。 |
| `Head Gesture Refractory Variance Seconds` | `0.25s` | `0`–`2s`  | 应用于不应期窗口的随机变化量。          |

### 手势动作

协同语音节拍和语义提示调节。

| 字段                                      | 默认值     | 范围            | 控制项                                      |
| --------------------------------------- | ------- | ------------- | ---------------------------------------- |
| `Beat Min Interval Seconds`             | `1.2s`  | `0.3`–`3s`    | 快速通道协同语音节拍之间的最短间隔秒数。                     |
| `Beat Interval Variance Seconds`        | `0.35s` | `0`–`2s`      | 添加到节拍最短间隔的随机变化量。                         |
| `Beat Head Intensity`                   | `0.5`   | `0`–`1`       | 缩放快速通道节拍所请求的头部动作幅度。                      |
| `Posture Pulse Amplitude`               | `0.35`  | `0`–`1`       | 缩放节拍时姿势脉冲包络在持续倾斜目标基础上增加的幅度。              |
| `Posture Pulse Attack Seconds`          | `0.08s` | `0.02`–`0.2s` | 强调动作达到峰值的速度。                             |
| `Posture Pulse Decay Seconds`           | `0.35s` | `0.1`–`1s`    | 姿势脉冲衰减并回到持续倾斜目标所需的时间。                    |
| `Energy To Intensity Gain`              | `1`     | `0`–`2`       | 在语音脉冲强度缩放节拍/姿势脉冲幅度之前，对其进行乘法缩放。           |
| `Statistical Cadence Interval Seconds`  | `2.5s`  | `1`–`6s`      | 未注册语音能量提供程序时，强调动作之间的平均间隔秒数。              |
| `Statistical Cadence Variance Seconds`  | `1s`    | `0`–`3s`      | 应用于统计节奏间隔的随机变化量。                         |
| `Upper Body Suppression Posture Weight` | `0.75`  | `0`–`1`       | 在 `UpperBody` 手势抑制。呼吸始终保持满权重。            |
| `语义提示不应期（秒）`                            | `2.5s`  | `0.5`–`10s`   | 语义手势提示之间的最短间隔秒数。                         |
| `最大耸肩角度`                                | `4°`    | `0`–`10°`     | 由 `Uncertain` 手势提示触发的程序化单次耸肩动作的肩部最大抬升幅度。 |

### 手势动作：手部

| 字段          | 默认值    | 范围           | 控制项                                  |
| ----------- | ------ | ------------ | ------------------------------------ |
| `启用手部微动作`   | `on`   | 布尔值          | 在编排好的手势之间，是否应用空闲状态下的手腕/手指微动作。        |
| `最大手指弯曲角度`  | `2.5°` | `0`–`6°`     | 满权重时，空闲手部微动作中手指近端的最大弯曲幅度。            |
| `最大手腕微动角度`  | `2°`   | `0`–`5°`     | 满权重时，空闲手部微动作中的最大手腕微动幅度。              |
| `启用程序化手势回退` | `on`   | 布尔值          | 当没有身体动画执行器接受语义提示时，生成幅度保守的程序化手臂/手部手势。 |
| `程序化手势幅度`   | `1`    | `0.25`–`1.5` | 程序化手势回退的幅度乘数。                        |

### 聆听与小动作

| 字段           | 默认值    | 范围         | 控制项                              |
| ------------ | ------ | ---------- | -------------------------------- |
| `小动作间隔（秒）`   | `3.5s` | `1`–`10s`  | 满权重时，重心转移小动作周期之间的平均间隔秒数 `小动作频率`. |
| `小动作缓动时长（秒）` | `0.9s` | `0.2`–`3s` | 单次重心转移小动作的缓入/缓出时长。               |
| `小动作保持时长（秒）` | `2.2s` | `0.5`–`6s` | 重心转移小动作到达峰值后，缓动回退前的保持时长。         |
| `聆听倾斜间隔（秒）`  | `6s`   | `2`–`15s`  | 启用聆听姿势时，聆听过程中头部倾斜并保持动作之间的平均间隔秒数。 |
| `聆听倾斜强度`     | `0.5`  | `0`–`1`    | 聆听时头部倾斜并保持动作的强度。                 |

### 呼吸

| 字段           | 默认值    | 范围         | 控制项                                                        |
| ------------ | ------ | ---------- | ---------------------------------------------------------- |
| `最大呼吸胸部扩张角度` | `4.5°` | `0.2`–`6°` | 一次全深度吸气对应的胸部/上胸部扩张幅度。                                      |
| `最大呼吸肩部抬升角度` | `2.2°` | `0.1`–`4°` | 一次全深度吸气对应的肩部抬升幅度。                                          |
| `启用呼吸自适应分层`  | `on`   | 布尔值        | 降低程序化呼吸相对于烘焙的待机片段呼吸的权重，以避免节拍干扰。                            |
| `呼吸时头部稳定`    | `0.35` | `0`–`1`    | 呼吸引起胸部运动时，头部保持水平的程度。                                       |
| `启用喘息`       | `on`   | 布尔值        | 允许角色被打断时出现喘息动作。                                            |
| `启用叹气`       | `on`   | 布尔值        | 对话平息时允许出现持续一口气的呼吸动作。仅有动作，没有音频。                             |
| `启用说话前吸气`    | `on`   | 布尔值        | 角色开始说话时，进行一次短暂、较深且较快的吸气。                                   |
| `运动强度速率增益`   | `0.4`  | `0`–`1.5`  | 在最大运动强度下额外增加的呼吸频率乘数。需要 Body Animation 的运动强度信号；没有该信号时不产生效果。 |
| `运动强度深度增益`   | `0.5`  | `0`–`1.5`  | 在最大运动强度下额外增加的呼吸深度乘数。需要 Body Animation 的运动强度信号；没有该信号时不产生效果。 |

### 情绪

| 字段          | 默认值                                               | 控制项                                                                                                                        |
| ----------- | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `启用情绪调节`    | `on`                                              | 根据角色当前情绪调整姿势、手势和呼吸。角色未配置 Emotion 模块时不产生效果。                                                                                 |
| `情绪修饰项`     | 手动精细调整 `中性`, `喜悦`, `悲伤`, `愤怒`, `恐惧`, `惊讶`, `厌恶` 行 | 按情绪标签 `开放度偏置` / `身体倾斜偏置` (`-1`–`1`), `肩部紧张度偏置` (`-1`–`1`), `手势强度比例` / `手势频率比例` / `呼吸频率比例` / `呼吸深度比例` (`0`–`2`)，在该情绪占主导时应用。 |
| `效价-唤醒度回退值` | `on`                                              | 对于在 `情绪修饰项`，根据其效价和唤醒度推导出修正值，而不是忽略它。                                                                                        |

### 反应

| 字段                             | 默认值    | 范围        | 控制项                                                  |
| ------------------------------ | ------ | --------- | ---------------------------------------------------- |
| `Enable Reactions`             | `on`   | 布尔值       | 单次身体反应的总开关——包括自主触发的情绪峰值反应和脚本化的 `TriggerReaction` 调用。 |
| `Max Flinch Degrees`           | `5°`   | `0`–`12°` | 达到全强度时脊柱/肩部旋转的幅度 `SurpriseFlinch` 。                  |
| `Max Amusement Bounce Degrees` | `1.2°` | `0`–`4°`  | 达到全强度时胸部旋转的幅度 `AmusementBounce` 。                    |

### 空闲状态表现

| 字段                         | 默认值  | 控制项                                                   |
| -------------------------- | ---- | ----------------------------------------------------- |
| `Enable Idle Macro Cycles` | `on` | 在几分钟内缓慢改变呼吸深度、摇摆幅度和小动作频率，让角色长时间处于空闲状态时也不会呈现明显重复的基准动作。 |

### 摄像机距离 LOD

| 字段                           | 默认值  | 控制项                                                                    |
| ---------------------------- | ---- | ---------------------------------------------------------------------- |
| `Enable Camera Distance Lod` | `on` | 根据与主摄像机的距离调整摇摆幅度和空闲时的手部动作：远距离时略微放大，极近距离时略微减弱，正常交谈距离时保持自然。不会影响呼吸、姿势或手势。 |

### 诊断

| 字段                | 默认值   | 数值                                      | 控制项                                                  |
| ----------------- | ----- | --------------------------------------- | ---------------------------------------------------- |
| `Trace Verbosity` | `Off` | `Off` / `State` / `Detail` / `Firehose` | 此角色肢体语言跟踪日志的诊断详细程度，日志记录在 `LogCategory.BodyLanguage`. |

### 后续步骤

{% content-ref url="/pages/652efa54160d6791ad8f9dfe70dc962fa595d73a" %}
[调节表现力](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/tune-expressiveness.md)
{% endcontent-ref %}

{% content-ref url="/pages/0ca05e2081622e66aa066b861879b41f4427d1c9" %}
[肢体语言脚本参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/scripting-reference.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/body-language/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.
