AudioWorkletNode: port プロパティ

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2021年4月⁩.

AudioWorkletNode インターフェイスの読み取り専用プロパティport は、関連付けられたMessagePort を返します。これにより、ノードと対応するAudioWorkletProcessor の間で双方向通信ができます。

メモ:チャネルのもう一方の端にあるポートは、処理器のport プロパティから参照できます。

値

このAudioWorkletNode と対応するAudioWorkletProcessor を繋ぐMessagePort オブジェクトです。

例

双方向通信でできることのデモのため、無音を出力し、AudioWorkletNode からの ping 要求に応えるAudioWorkletProcessor を作成します。

まず、独自のAudioWorkletProcessor を定義し、登録します。これは別のファイルで行うことに注意してください。

// ping-pong-processor.jsclass PingPongProcessor extends AudioWorkletProcessor {  constructor(...args) {    super(...args);    this.port.onmessage = (e) => {      console.log(e.data);      this.port.postMessage("pong");    };  }  process(inputs, outputs, parameters) {    return true;  }}registerProcessor("ping-pong-processor", PingPongProcessor);

そして、メインスクリプトファイルで処理器をロードし、処理器の名前を渡してAudioWorkletNode のインスタンスを作成し、このノードを音声グラフに接続します。

const audioContext = new AudioContext();await audioContext.audioWorklet.addModule("ping-pong-processor.js");const pingPongNode = new AudioWorkletNode(audioContext, "ping-pong-processor");// 毎秒、AudioWorkletNode から// 文字列 'ping' が入ったメッセージを AudioWorkletProcessor に送るsetInterval(() => pingPongNode.port.postMessage("ping"), 1000);pingPongNode.port.onmessage = (e) => console.log(e.data);pingPongNode.connect(audioContext.destination);

このプログラムは、コンソールに毎秒文字列"ping" と"pong" を出力します。