> 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 Body Language 模块的唯一创作资源。使用……创建一个 **Assets > Create > Convai > Embodiment > Body Language Profile**，或者让角色不分配配置文件，使用模块内置默认值运行。

### 表现力

一个统一的旋钮，可同步缩放姿态、呼吸、摆动、站姿、手势、反应、手部微动和头部手势的幅度、频率与丰富度。

| 字段       | 默认值   | 范围                                       | 控制                                       |
| -------- | ----- | ---------------------------------------- | ---------------------------------------- |
| `表现力预设`  | `自然`  | `含蓄` / `自然` / `富有表现力` / `戏剧化` / `Custom` | 解析后的表现力锚点。 `Custom` 使用 `自定义表现力` 而不是固定锚点。 |
| `自定义表现力` | `0.5` | `0`–`1`                                  | 仅在……时使用 `表现力预设` 为 `Custom`.              |

可随时通过……设置运行时值 `ConvaiBodyLanguageController.Expressiveness` (`0`–`1`），其优先级高于配置文件，直到下次配置文件热切换为止。见 [调节表现力](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/tune-expressiveness.md).

### 信号

用于快速手势通道的语音脉冲分析器调优。通常不需要为每个角色单独调整。

| 字段          | 默认值    | 范围          | 控制                         |
| ----------- | ------ | ----------- | -------------------------- |
| `起始秒数`      | `0.05` | `0.005`–`1` | 能量上升时的语音能量包络平滑时间。          |
| `释放秒数`      | `0.15` | `0.01`–`2`  | 能量下降时的语音能量包络平滑时间。          |
| `基线窗口秒数`    | `2.5`  | `0.2`–`30`  | 跟踪静态噪声水平的慢速自适应基线的时间常数。     |
| `高于基线的起始阈值` | `0.12` | `0.01`–`1`  | 包络需高出基线多少才算作语音起始。          |
| `释放滞回比例`    | `0.5`  | `0.05`–`1`  | 包络必须回落到起始阈值以下的多少比例，才会触发释放。 |
| `强调导数阈值`    | `1.6`  | `0.1`–`20`  | 可被视为强调尖峰的正包络导数（单位/秒）。      |
| `不应期秒数`     | `0.22` | `0`–`2`     | 两次触发的语音脉冲之间的最短秒数，不论类型。     |
| `维持间隔秒数`    | `0.9`  | `0.1`–`10`  | 在语音持续激活时，维持心跳的节奏。          |

### 状态策略

`状态策略` 是按……逐项`DialogueState` 表（`空闲`, `关注中`, `倾听`, `思考`, `说话`, `反应`, `Interrupted`, `平复`）。未列出的状态将回退到 `空闲` 条目。每一行提供：

| 字段          | 范围       | 控制                           |
| ----------- | -------- | ---------------------------- |
| `启用手势`      | bool     | 在此状态下，是否允许伴语手势（点头节拍、姿态脉冲）参与。 |
| `手势强度`      | `0`–`1`  | 启用时的整体手势强度。                  |
| `启用聆听姿态`    | bool     | 在此状态下，是否启用具身聆听姿态（前倾、静止）。     |
| `聆听前倾`      | `0`–`1`  | 启用聆听姿态时，在姿态范围内的前倾比例。         |
| `姿态开放偏置`    | `-1`–`1` | 正值会打开/抬起胸部；负值会使其圆拢/闭合。       |
| `矢状前倾偏置`    | `-1`–`1` | 正值向对话对象前倾；负值后撤。              |
| `环境漂移`      | `0`–`1`  | 角色在此状态下原地摆动的幅度。 `0` 使角色完全静止。 |
| `呼吸频率（次/分）` | `4`–`30` | 此状态下的呼吸频率，按每分钟循环数计。          |
| `呼吸深度`      | `0`–`1`  | 相对于配置文件呼吸校准的呼吸深度。            |
| `呼吸不规则度`    | `0`–`1`  | `0` 是稳定节奏； `1` 是保持/不均匀的呼吸。   |
| `启用小动作`     | bool     | 在此状态下，是否允许空闲微小动作参与。          |
| `小动作频率`     | `0`–`1`  | 启用小动作时的相对小动作频率。              |

`策略过渡秒数` (默认 `0.4`，范围 `0`–`20`）设置对话状态变化时策略值混合的秒数； `0` 会瞬间切换。

### 姿态

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

### 站姿与摆动

| 字段           | 默认值    | 范围         | 控制                                      |
| ------------ | ------ | ---------- | --------------------------------------- |
| `启用重心转移`     | `在`    | bool       | 周期性骨盆重心转移程序的总开关。                        |
| `重心转移间隔秒数`   | `20秒`  | `6`–`90秒`  | 重心转移周期之间的平均秒数（按状态缩放）。                   |
| `重心转移间隔方差秒数` | `8秒`   | `0`–`30秒`  | 应用于重心转移间隔的随机方差。                         |
| `重心转移传递秒数`   | `2.2秒` | `0.8`–`5秒` | 重心转移过渡到新目标所需的秒数。                        |
| `最大骨盆偏移厘米数`  | `3厘米`  | `0`–`6厘米`  | 横向重心转移行程。高于大约 `4厘米` 的数值需要腿部补偿以避免脚部滑动。   |
| `最大骨盆倾斜角度`   | `2.5°` | `0`–`6°`   | 完整 ±1 重心转移时的骨盆倾斜（抬髋）。                   |
| `最大骨盆偏航角度`   | `3°`   | `0`–`8°`   | 完整 ±1 重心转移时的骨盆偏航。                       |
| `启用腿部补偿`     | `在`    | bool       | 通过内部双骨骼腿部 IK 在重心转移时固定脚部。若腿部链未能解析，则自动失效。 |
| `启用环境摆动`     | `在`    | bool       | 连续带限姿态摆动的总开关。                           |
| `最大摆动角度`     | `0.6°` | `0`–`2°`   | 完整 ±1 姿态摆动采样对应的脊柱旋转。                    |

### 头部手势

脚本化……的峰值幅度 `点头`/`摇头`/`倾斜` 头部手势程序（见 [触发手势和反应](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/gestures-and-reactions.md)).

| 字段            | 默认值     | 范围        | 控制                   |
| ------------- | ------- | --------- | -------------------- |
| `头部点头最大俯仰角`   | `8°`    | `1`–`15°` | 满强度时的峰值俯仰， `点头` 可达到。 |
| `头部摇头最大偏航角`   | `9°`    | `1`–`15°` | 满强度时的峰值偏航， `摇头` 可达到。 |
| `头部倾斜最大横滚角`   | `6°`    | `1`–`15°` | 满强度时的峰值横滚， `倾斜` 可达到。 |
| `头部手势不应期秒数`   | `0.6秒`  | `0`–`5秒`  | 头部手势完成后，下一次开始前的最短秒数。 |
| `头部手势不应期方差秒数` | `0.25秒` | `0`–`2秒`  | 应用于不应期窗口的随机方差。       |

### 手势

伴语节拍与语义提示调优。

| 字段                                      | 默认值     | 范围            | 控制                                            |
| --------------------------------------- | ------- | ------------- | --------------------------------------------- |
| `节拍最小间隔秒数`                              | `1.2秒`  | `0.3`–`3秒`    | 快速通道伴语节拍之间的最短秒数。                              |
| `节拍间隔方差秒数`                              | `0.35秒` | `0`–`2秒`      | 添加到节拍最小间隔的随机方差。                               |
| `节拍头部强度`                                | `0.5`   | `0`–`1`       | 缩放快速通道节拍请求的头部手势幅度。                            |
| `姿势脉冲幅度`                                | `0.35`  | `0`–`1`       | 缩放节拍时姿态脉冲包络在连续前倾目标之上增加的幅度。                    |
| `姿态脉冲起始秒数`                              | `0.08秒` | `0.02`–`0.2秒` | 强调达到峰值的速度。                                    |
| `姿态脉冲衰减秒数`                              | `0.35秒` | `0.1`–`1秒`    | 姿态脉冲衰减回连续前倾目标的时间。                             |
| `能量到强度增益`                               | `1`     | `0`–`2`       | 在缩放节拍/姿态脉冲幅度之前，先乘以语音脉冲的强度。                    |
| `统计节奏间隔秒数`                              | `2.5秒`  | `1`–`6秒`      | 未注册语音能量提供器时，强调之间的平均秒数。                        |
| `统计节奏方差秒数`                              | `1秒`    | `0`–`3秒`      | 应用于统计节奏间隔的随机方差。                               |
| `Upper Body Suppression Posture Weight` | `0.75`  | `0`–`1`       | 在……下保留的姿态权重比例 `UpperBody` 手势抑制。无论如何，呼吸都保持满权重。 |
| `语义提示不应期秒数`                             | `2.5秒`  | `0.5`–`10秒`   | 语义手势提示发出之间的最短秒数。                              |
| `最大耸肩角度`                                | `4°`    | `0`–`10°`     | 由……触发的程序性一次性耸肩的峰值肩部抬起 `不确定` 手势提示。             |

### 手势：手部

| 字段          | 默认值    | 范围           | 控制                                             |
| ----------- | ------ | ------------ | ---------------------------------------------- |
| `启用手部微动`    | `在`    | bool         | 在已制作的手势之间，是否应用静止时的手腕/手指微动。                     |
| `最大手指弯曲角度`  | `2.5°` | `0`–`6°`     | 满权重时空闲手部微动的手指近端弯曲峰值。                           |
| `最大手腕微动角度`  | `2°`   | `0`–`5°`     | 满权重时空闲手部微动的手腕微动峰值。                             |
| `启用程序性手势回退` | `在`    | bool         | 当没有 Body Animation 执行器接受语义提示时，生成保守的程序性手臂/手部手势。 |
| `程序性手势幅度`   | `1`    | `0.25`–`1.5` | 程序性手势回退的幅度乘数。                                  |

### 聆听与小动作

| 字段         | 默认值    | 范围         | 控制                             |
| ---------- | ------ | ---------- | ------------------------------ |
| `小动作间隔秒数`  | `3.5秒` | `1`–`10秒`  | 满强度时，小动作重心转移周期之间的平均秒数 `小动作频率`. |
| `小动作缓动秒数`  | `0.9秒` | `0.2`–`3秒` | 单次小动作重心转移的缓入/缓出持续时间。           |
| `小动作保持秒数`  | `2.2秒` | `0.5`–`6秒` | 在小动作重心转移峰值处保持，然后缓回的持续时间。       |
| `聆听倾斜节奏秒数` | `6秒`   | `2`–`15秒`  | 启用聆听姿态时，聆听倾斜保持头部手势之间的平均秒数。     |
| `聆听倾斜强度`   | `0.5`  | `0`–`1`    | 聆听倾斜保持头部手势的强度。                 |

### 呼吸

| 字段           | 默认值    | 范围         | 控制                                                |
| ------------ | ------ | ---------- | ------------------------------------------------- |
| `最大呼吸胸部扩张角度` | `4.5°` | `0.2`–`6°` | 满深度吸气对应的胸部/上胸扩张。                                  |
| `最大呼吸肩部抬起角度` | `2.2°` | `0.1`–`4°` | 满深度吸气对应的肩部抬起。                                     |
| `启用呼吸自适应分层`  | `在`    | bool       | 在烘焙的空闲片段呼吸之上压低程序性呼吸，以防止节拍干扰。                      |
| `呼吸时头部稳定`    | `0.35` | `0`–`1`    | 头部相对于呼吸引起的胸部运动保持多平稳。                              |
| `启用喘息`       | `在`    | bool       | 当角色被打断时，允许出现一次喘息动作。                               |
| `启用叹息`       | `在`    | bool       | 当对话平静下来时，允许一次叹息长度的呼吸动作。仅动作——无音频。                  |
| `启用说话前吸气`    | `在`    | bool       | 在角色开始说话时，做一次短暂、更深、更快的吸气。                          |
| `用力频率提升`     | `0.4`  | `0`–`1.5`  | 在完全运动用力时额外的呼吸频率乘数。需要 Body Animation 的用力信号；没有它则无效。 |
| `用力深度提升`     | `0.5`  | `0`–`1.5`  | 在完全运动用力时额外的呼吸深度乘数。需要 Body Animation 的用力信号；没有它则无效。 |

### 情绪

| 字段         | 默认值                                                   | 控制                                                                                                                    |
| ---------- | ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `启用情绪调制`   | `在`                                                   | 根据角色当前情绪偏置姿态、手势和呼吸。若角色没有 Emotion 模块，则无效。                                                                              |
| `情绪修饰器`    | 手工调校的 `neutral`, `喜悦`, `悲伤`, `愤怒`, `恐惧`, `惊讶`, `厌恶` 行 | 按情绪标签 `开放偏置` / `前倾偏置` (`-1`–`1`), `肩部紧张偏置` (`-1`–`1`), `手势强度缩放` / `手势频率缩放` / `呼吸频率缩放` / `呼吸深度缩放` (`0`–`2`）在该情绪占主导时应用。 |
| `效价-唤醒度回退` | `在`                                                   | 对于在……中没有对应行的情绪标签 `情绪修饰器`，则根据其效价和唤醒度推导修饰器，而不是忽略它。                                                                      |

### 反应

| 字段         | 默认值    | 范围        | 控制                                                |
| ---------- | ------ | --------- | ------------------------------------------------- |
| `启用反应`     | `在`    | bool      | 一次性身体反应的总开关——包括自主情绪尖峰触发和脚本化 `TriggerReaction` 调用。 |
| `最大惊跳角度`   | `5°`   | `0`–`12°` | 满强度时的脊柱/肩部旋转 `惊讶一颤` 可达到。                          |
| `最大愉悦弹跳角度` | `1.2°` | `0`–`4°`  | 满强度时的胸部旋转 `愉悦弹动` 可达到。                             |

### 空闲存在感

| 字段        | 默认值 | 控制                                             |
| --------- | --- | ---------------------------------------------- |
| `启用空闲宏周期` | `在` | 在几分钟内缓慢共同漂移呼吸深度、摆动幅度和小动作节奏，使长时间空闲不会稳定成可见重复的基线。 |

### 按相机距离分级细节

| 字段                       | 默认值 | 控制                                                             |
| ------------------------ | --- | -------------------------------------------------------------- |
| `启用 Camera Distance Lod` | `在` | 根据与主摄像机的距离缩放摆动和空闲手部动作：远处略大，极近特写略微更收敛，正常对话距离则保持中性。绝不影响呼吸、姿态或手势。 |

### 诊断

| 字段       | 默认值  | 数值                               | 控制                                               |
| -------- | ---- | -------------------------------- | ------------------------------------------------ |
| `跟踪详细级别` | `关闭` | `关闭` / `State` / `详细信息` / `火力全开` | 此角色肢体语言轨迹的诊断详细程度，记录在 `LogCategory.BodyLanguage`. |

### 下一步

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

{% content-ref url="/pages/0ca05e2081622e66aa066b861879b41f4427d1c9" %}
[肢体语言脚本参考](/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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
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=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.