> 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/tune-expressiveness.md).

# 调节表现力

使用表现力预设、运行时覆盖和按行为增益，让 Convai 角色的肢体语言看起来更含蓄或更戏剧化。

通过选择 `ExpressivenessPreset` ，设置角色肢体语言表现的幅度、频率和丰富程度；该预设可以设置在 `ConvaiBodyLanguageProfile`上，也可以在运行时通过 `ConvaiBodyLanguageController.Expressiveness`覆盖此设置。当内置的 `Natural` 预设对于戏剧化表演者显得过于平淡，或对于沉稳内敛的角色显得过于活跃时，请参阅本页。

***

### 前提条件

* 已添加 `ConvaiBodyLanguageController` 的角色 — 请参阅 [肢体语言快速入门](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/quick-start.md).
* 一个 `ConvaiBodyLanguageProfile` 已分配给该组件；如果你希望在资源上设置预设，而不只是运行时覆盖，请创建一个。创建路径： **Assets > Create > Convai > Embodiment > Body Language Profile**.

***

### 选择表现力预设

`ExpressivenessPreset` 是配置文件「Expressiveness」部分中的唯一调节项。配置文件中的其他所有幅度、节奏和可选行为开关，都会根据你在此处设置的值进行缩放：

| 预设                | 解析后的值                                        | 表现效果                            |
| ----------------- | -------------------------------------------- | ------------------------------- |
| `Subtle`          | 0.25                                         | 动作幅度小、节奏较慢且内敛克制——大多不启用可选行为。     |
| `Natural` （内置默认值） | 0.5                                          | 在正常的 2 米对话镜头距离下清晰可见，但不会显得刻意表演。  |
| `Expressive`      | 0.75                                         | 动作幅度更大、频率更高、变化更多——角色生动活泼。       |
| `Theatrical`      | 1.0                                          | 动作幅度、频率和丰富程度达到最大——表现宽泛、戏剧化的表演者。 |
| `Custom`          | 配置文件自身的 `Custom Expressiveness` 字段，取值范围为 0–1 | 可由作者精确控制解析后的值，而不必使用四个固定档位之一。    |

在配置文件 Inspector 的 Expressiveness 部分设置 **Expressiveness Preset** 。选择 `Custom` 并设置 **Custom Expressiveness** ，适用于四个固定档位都不完全合适的情况。

***

### 在运行时覆盖表现力

在脚本中设置 `ConvaiBodyLanguageController.Expressiveness` ，即可更改角色的表现力，而无需替换其配置文件——这适用于角色在压力下应表现得更沉稳，或在兴奋时更活泼的情况：

```csharp
using UnityEngine;
using Convai.Modules.BodyLanguage.Components;

public class SetCharacterExpressiveness : MonoBehaviour
{
    [SerializeField] private ConvaiBodyLanguageController bodyLanguage;

    private void Start()
    {
        bodyLanguage = GetComponent<ConvaiBodyLanguageController>();
        bodyLanguage.Expressiveness = 0.75f;
    }
}
```

`Expressiveness` 是一个 `0..1` 浮点数。设置后，其值会覆盖配置文件自身解析出的值，直到下一次热切换配置文件；此时覆盖值会清除，控制器将回退到新配置文件解析出的值。读取此属性时，始终会返回最近一次更新时的有效值——如果设置了覆盖值，则返回覆盖值；否则返回配置文件自身解析出的值。

***

### 了解此滑块实际改变的内容

解析后的 `0..1` 值会导出三个独立的增益，每种行为类别对它们的响应方式各不相同，而不是由一个统一的乘数进行缩放：

| 增益  | 缩放的内容                                       | 设为 `Subtle` | 设为 `Natural` | 设为 `Theatrical` |
| --- | ------------------------------------------- | ----------- | ------------ | --------------- |
| 幅度  | 度数和厘米数上限——姿势、呼吸、摇摆、站姿、反应、手部细微动作、节拍和脉冲强度     | 0.62×       | 1×           | 1.75×           |
| 频率  | 计划行为的发生频率——随着该值升高，节拍、重心转移、小动作和倾身聆听会更频繁地出现   | 0.75×       | 1×           | 1.5×            |
| 丰富度 | 可选行为库中实际呈现的行为种类——耸肩、空闲时手部和腕部的细微动作、调整站姿的小步移动 | 0.45×       | 1×           | 1.5×            |

幅度增益不会对姿势进行均匀缩放。持续姿势轮廓——角色整体的开放程度、身体倾斜和肩部紧张度——与幅度的耦合强度减半，因此即使是 `Subtle` 角色仍会保持清晰可辨的姿态。瞬时动作——配合说话节拍的姿势脉动、聆听时的身体前倾、重心转移——则会获得完整的幅度增益，因此 `Subtle` 在每个瞬间看起来仍明显更为平静。

呼吸频率绝不会随表现力缩放。呼吸被视为生理活动，而非表演效果，因此 `Theatrical` 角色不会因此呼吸得异常急促，尽管它的其他动作幅度都更大。

***

### 应用气质预设，一次性调整角色个性

配置文件检查器中的 **气质** 一行—— `Composed`, `Warm`, `Energetic`, `Reserved` ——在你选择某个选项时，会对配置文件中的姿势倾向、小动作、摇摆、节拍强度和重心转移频率字段应用一次乘数调整。这只是普通且可撤销的资源编辑，并非像 `Expressiveness`.

{% hint style="info" %}
情绪配置文件和身体动画配置中也会出现同样的四种气质名称，因此 `Warm` 在三个检查器中都是同一个词。不过，各模块仍会按照各自的方式解读气质；在此配置文件上应用某种气质，不会将其应用到其他任何位置。
{% endhint %}

***

### 验证设置

进入播放模式并开始对话。将角色设为 `Subtle` 应呈现明显更沉稳、动作幅度更小的姿态，同时保持姿势清晰可辨；设置为 `Theatrical` 的角色则应更频繁地转换重心和做手势，动作幅度也明显更大。在运行时调整 `Expressiveness` 应平滑地逐步拉开差异，而不是让角色的表现突然切换。

***

### 后续步骤

{% content-ref url="/pages/b0a834d0e9425d60d0788646a7b3343330f88cf0" %}
[触发手势与反应](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/gestures-and-reactions.md)
{% endcontent-ref %}

{% content-ref url="/pages/aa2dfbd502cd5beea5e136b8b51781cf4aa0c88c" %}
[肢体语言配置文件参考](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/profile-reference.md)
{% endcontent-ref %}

{% content-ref url="/pages/201180ea8488e6cfc5bfa3fafd0e21ce57652c6c" %}
[肢体语言如何运作](https://docs.convai.com/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/how-body-language-works.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/tune-expressiveness.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.
