配置角色音频

调整角色语音播放音量，启用空间音频衰减，并在 Convai Chatbot 组件上配置中断淡出时长。

角色语音通过以下方式播放 UConvaiAudioStreamer，它扩展了 Unreal Engine 的 UAudioComponent。因此，所有标准的 Unreal 音频设置——音量倍数、空间音频、衰减——都可以直接在 Convai Chatbot 组件的 Details 面板中访问，同时还有一个用于中断淡出行为的 Convai 特定属性。

默认音频行为

设置	默认值	说明
播放音量	1.0	全音量。由继承的 音量倍数 在 声音 类别下。
空间音频	已禁用	AttenuationSettings 为 null ——语音以相同音量播放，不受距离影响。
中断淡出时长	可配置	请参见 配置中断淡出时长.

调整播放音量

1

打开角色蓝图

在蓝图编辑器中打开角色蓝图。

2

选择 Convai Chatbot 组件

选择 Convai 聊天机器人 组件在 组件 面板。

3

展开 Sound 部分

在 Details 面板，展开 声音 部分（继承自 UAudioComponent).

4

调整音量倍数

设置 音量倍数 到所需级别。 1.0 是全音量； 0.0 是静音。

要在运行时从蓝图中将角色语音静音或取消静音，请调用 SetVolumeMultiplier(0.0) 或 SetVolumeMultiplier(1.0) 于 Convai Chatbot 组件引用上。此操作仅调整播放音量——不会影响角色是否接收或处理语音。

启用空间音频

默认情况下，角色语音不会随距离衰减。要添加基于距离的衰减：

1

创建 Sound Attenuation 资源

在 内容浏览器，右键单击并选择 Sounds > Sound Attenuation。将其命名（例如， SA_ConvaiCharacter）。打开它并配置衰减形状、衰减距离和音量曲线，以匹配你的场景比例。

2

将衰减分配给聊天机器人组件

打开角色蓝图并选择 Convai 聊天机器人 组件。在 Details 面板，展开 衰减 部分（继承自 UAudioComponent）。启用 覆盖衰减 并分配你的 SA_ConvaiCharacter 资源。

3

测试衰减

进入播放模式。向角色走近再走远。语音音量应根据衰减曲线随距离变化。

当空间音频正常工作时，角色的声音会随距离减弱。如果音量没有变化，请确认 覆盖衰减 已在该组件上启用，并且衰减资源的内半径小于你期望的交互距离。

配置中断淡出时长

当 InterruptSpeech 在以下对象上调用 UConvaiChatbotComponent，角色语音会在可配置的时长内淡出，而不是突然中断。

属性	类别	说明
InterruptVoiceFadeOutDuration	Convai	语音在被中断后淡出至静音所需的秒数。较短的值更灵敏；较长的值听起来更自然。

要进行配置，请选择 Convai 聊天机器人 组件并找到 打断语音淡出时长 在 Convai 类别中 Details 面板。你还可以通过传递以下参数为每次调用覆盖淡出时长： InVoiceFadeOutDuration 直接传递给 InterruptSpeech 在蓝图中——该次调用的值优先于该次中断的组件默认值。

故障排查

角色语音过于安静或听不见

症状： 角色的声音正在播放，但非常小声或根本听不到。

原因： 音量倍数 在聊天机器人组件上的数值已降低到低于 1.0，或者空间衰减资源配置的衰减在较短距离内就降为零。

修复： 选择 Convai 聊天机器人 组件并检查 音量倍数 在 声音 类别。将其重置为 1.0。如果已启用衰减，请检查衰减曲线并增大内半径和外半径。

验证： 进入播放模式并确认角色的声音能以正常音量听到。

角色语音不会随距离衰减

症状： 无论玩家距离角色多远，听到的音量都相同。

原因： 空间衰减默认处于禁用状态（AttenuationSettings = null).

修复： 按照 启用空间音频 上述步骤。

验证： 在播放模式下向角色走近再走远，并确认音量会随距离变化。

中断时语音直接切断，而不是淡出

症状： 当 InterruptSpeech 被调用时，角色音频会立即停止，没有淡出。

原因： InterruptVoiceFadeOutDuration 被设置为 0 或一个非常小的值。

修复： 选择 Convai 聊天机器人 组件并增大 打断语音淡出时长 在 Convai 类别下。

验证： 触发器 InterruptSpeech 在角色语音播放期间，并确认音频会在配置的时长内淡出。

下一步

配置对话输入