播放声音 KJ(PlaySoundKJ)

描述

当执行到达此节点时，在浏览器中播放音频。音频可通过 audio 输入（AUDIO 类型）提供，或通过 audio_path 字符串输入指定文件路径（在未连接 audio 输入时使用）。该节点提供三种播放模式：always（每次执行都播放）、on_empty_queue（仅在队列完成时播放）和 on_change（仅在音频内容发生变化时播放）。时长参数限制播放长度；设置为 0.0 可播放完整音频文件。

输入

输出

使用说明

• 音频来源优先级：当 audio 输入已连接时，其优先级高于 audio_path。如果两者都提供，则使用 audio 输入。
• 模式行为：
  • always – 适用于测试或连续播放。
  • on_empty_queue – 适用于在批处理生成完成后播放通知声音。
  • on_change – 仅当实际音频数据（或使用 audio_path 时的文件路径）与上一个执行不同时播放。这避免了在节点多次执行相同音频时重复播放。
• 时长：值为 0.0 时播放整个音频片段。否则，播放会在指定的秒数后截断（最长 300 秒）。
• 音量：音量是应用于音频的线性增益。不允许超过 1.0 的值；如需放大，请在其他地方预处理音频。
• 输出：any_input 直通功能允许您在不影响数据流的情况下链入此节点（例如，将其并联到您希望通过音频监控输出的节点）。
• 浏览器环境：音频通过浏览器的音频系统播放。请确保浏览器已启用音频播放，并满足任何自动播放策略（此节点在首次执行时可能需要用户手势）。