调整表现力

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

通过选择一个来设置角色肢体语言在幅度、频率和丰富度上的表现 ExpressivenessPreset 在其 ConvaiBodyLanguageProfile，或者通过在运行时覆盖该旋钮来 ConvaiBodyLanguageController.Expressiveness。当出厂提供的 自然 调校显得对戏剧化表演者来说过于平淡，或对冷静、克制的角色来说过于忙乱时，请使用本页。

---

前提条件

• 具有 ConvaiBodyLanguageController 已添加——请参见 身体语言快速入门.
• 某个 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 可通过脚本在不切换其配置文件的情况下更改角色的表现力——这对于需要在压力下显得更冷静、或在兴奋时更活跃的角色很有用：

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 字段应用一次性的乘数调整。这只是普通的、可撤销的资源编辑，而不是像 表现力.

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

---

验证设置

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

---

下一步

触发手势与反应肢体语言配置文件参考肢体语言如何工作