Play Sound KJ(PlaySoundKJ)

説明

実行がこのノードに到達したときに、ブラウザでオーディオを再生します。オーディオは audio 入力（AUDIO 型）から提供するか、audio_path 文字列入力にファイルパスを指定して提供できます（audio 入力が接続されていない場合に使用されます）。このノードは3つの再生モードを提供します：always（実行ごとに再生）、on_empty_queue（キューが完了したときのみ再生）、on_change（オーディオコンテンツが変更されたときにのみ再生）。duration パラメータで再生時間を制限します。0.0 に設定するとオーディオファイル全体を再生します。

入力

出力

使用上の注意

• オーディオソースの優先順位: audio 入力が接続されている場合は、audio_path よりも優先されます。両方とも指定されている場合、audio 入力が使用されます。
• モードの動作:
  • always – テストや連続再生に適しています。
  • on_empty_queue – バッチ生成完了後の通知音の再生などに便利です。
  • on_change – 実際のオーディオデータ（または audio_path を使用する場合はファイルパス）が前回の実行と異なる場合にのみ再生します。これにより、同じオーディオでノードが複数回実行される場合の重複再生を回避します。
• duration: 0.0 を指定するとオーディオクリップ全体を再生します。それ以外の場合は、指定された秒数（最大300秒）で再生が停止します。
• 音量: 音量はオーディオに適用されるリニアゲインです。1.0 を超える値は許可されません。増幅が必要な場合は、他の場所でオーディオを前処理してください。
• 出力: any_input パススルーにより、データフローに影響を与えずにこのノードをチェーンできます（例：音声的に監視したいノードの出力に並列接続）。
• ブラウザ環境: オーディオはブラウザのオーディオシステムを通じて再生されます。ブラウザでオーディオ再生が有効になっており、自動再生ポリシーが満たされていることを確認してください（このノードは最初の実行時にユーザーの操作が必要になる場合があります）。