> 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`。当出厂提供的 `自然` 调校显得对戏剧化表演者来说过于平淡，或对冷静、克制的角色来说过于忙乱时，请使用本页。

***

### 前提条件

* 具有 `ConvaiBodyLanguageController` 已添加——请参见 [身体语言快速入门](/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 部分的唯一调节旋钮。配置文件中的其他所有幅度、节奏和可选行为开关，都会按你在此设置的值进行缩放：

| 预设           | 解析后的值                    | 显示为                                 |
| ------------ | ------------------------ | ----------------------------------- |
| `含蓄`         | 0.25                     | 最少、低调的动作——幅度较小、节奏较慢，而且大多数可选行为都不会出现。 |
| `自然` （出厂默认值） | 0.5                      | 在正常 2 米的对话镜头距离下清晰可见，但不会显得刻意表演。      |
| `富有表现力`      | 0.75                     | 更大、更频繁、更多样的动作——一个活泼、生动的角色。          |
| `戏剧化`        | 1.0                      | 最大幅度、频率和丰富度——一个夸张而具有戏剧感的表演者。        |
| `Custom`     | 该配置文件自身的 `自定义表现力` 字段，0–1 | 可完全由作者控制最终解析值，而不是使用四个固定锚点之一。        |

将 **表现力预设** 在配置文件 Inspector 的 Expressiveness 部分中。选择 `Custom` 并设置 **自定义表现力** 当四个固定锚点都不完全合适时使用。

***

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

将 `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;
    }
}
```

`表现力` 是一个 `0..1` float。将其设定为高于配置文件自身解析值时，会一直生效，直到下一次配置文件热切换；此时覆盖会清除，控制器会回退到新配置文件的解析值。读取该属性时，始终返回最近一次 tick 的有效值——如果你设置了覆盖值，则返回覆盖值；否则返回配置文件自身的解析值。

***

### 了解这个旋钮实际改变了什么

解析后的 `0..1` 值会派生出三种不同的增益，而且每个行为类别对它们的响应方式都不同，而不是由一个统一的乘数来缩放：

| 增益  | 它缩放的内容                                      | 在 `含蓄` | 在 `自然` | 在 `戏剧化` |
| --- | ------------------------------------------- | ------ | ------ | ------- |
| 幅度  | 角度和厘米级最大值——姿态、呼吸、摆动、站姿、反应、手部微动作、节拍和脉冲强度     | 0.62×  | 1×     | 1.75×   |
| 频率  | 计划行为发生的频率——随着该值升高，节拍、重心转移、小动作、倾听时的倾斜会更频繁地触发 | 0.75×  | 1×     | 1.5×    |
| 丰富度 | 可选行为库中有多少会真正出现——耸肩、闲置时的手和手腕微动作、站姿调整步        | 0.45×  | 1×     | 1.5×    |

幅度增益不会均匀作用于姿态。持续姿态轮廓——角色整体的开放程度、倾斜和肩部紧张度——只获得半强度的幅度耦合，因此即使是一个 `含蓄` 角色仍然会保持可辨识的形态。瞬时动作——说话节拍上的姿态脉动、倾听时的前倾、重心转移——会获得完整的幅度增益，因此 `含蓄` 在逐个瞬间看起来仍然明显更平静。

呼吸频率从不会随表现力缩放。它被视为生理而非表演，因此一个 `戏剧化` 角色不会呼吸得异常快，即使其其他表现都更夸张。

***

### 应用一种气质预设，进行一次性的性格调整

配置文件 Inspector 的 **气质** 行—— `沉稳`, `温暖`, `充满活力`, `内敛` ——在你选择它时，会对配置文件的 posture bias、fidget、sway、beat-intensity 和 weight-shift-cadence 字段应用一次性的乘数调整。这只是普通的、可撤销的资源编辑，而不是像 `表现力`.

{% hint style="info" %}
相同的四个气质名称也出现在 Emotion 配置文件和 Body Animation 配置中，因此 `温暖` 在这三个 Inspector 中都是同一个词。每个模块仍会以自己的方式解释气质，而在此配置文件上应用一个气质，不会把它应用到其他任何地方。
{% endhint %}

***

### 验证设置

进入 Play 模式并开始对话。设置为 `含蓄` 的角色应保持明显更平静、动作更小的轮廓，同时仍保有可辨识的姿态；设置为 `戏剧化` 的角色应更频繁地转移重心和做手势，且动作明显更大。更改 `表现力` 在运行时应当平滑地放大这种差异，而不是在不同外观之间突然切换角色。

***

### 下一步

{% content-ref url="/pages/b0a834d0e9425d60d0788646a7b3343330f88cf0" %}
[触发手势与反应](/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" %}
[肢体语言配置文件参考](/api-docs/zh/cha-jian-yu-ji-cheng/convai-unity-sdk/embodiment/body-language/profile-reference.md)
{% endcontent-ref %}

{% content-ref url="/pages/201180ea8488e6cfc5bfa3fafd0e21ce57652c6c" %}
[肢体语言如何运作](/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 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/tune-expressiveness.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.