ChannelSplitterNode: ChannelSplitterNode() コンストラクター

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

ウェブオーディオ API の ChannelSplitterNode() コンストラクターは、新しい ChannelSplitterNode オブジェクトのインスタンスを作成します。これは、入力の音声チャンネルそれぞれを別々の出力に分離するノードを表します。

構文

js
new ChannelSplitterNode(context)
new ChannelSplitterNode(context, options)

引数

context

このノードを関連付ける音声コンテキストを表す BaseAudioContext です。

options 省略可

ChannelSplitterNode に持たせるプロパティを定義するオブジェクトです。

numberOfOutputs 省略可

ChannelSplitterNode の出力の数を決める数値です。指定しない場合の既定の値は 6 です。

channelCount 省略可

このノードの入力についてアップミキシングとダウンミキシングを行う際に用いるチャンネル数を決める整数です。 (詳しくは AudioNode.channelCount を参照してください) 使用法と正確な定義は channelCountMode の値によります。

channelCountMode 省略可

ノードの入力と出力でチャンネルを対応付ける方法を表す文字列です。 (デフォルト値など詳しくは AudioNode.channelCountMode を参照してください)

channelInterpretation 省略可

チャンネルの意味を表す文字列です。 この意味により、音声のアップミキシングとダウンミキシングを行う方法が決まります。 取りうる値は "speakers" と "discrete" です。 (デフォルト値など詳しくは AudioNode.channelCountMode を参照してください)

返値

新しい ChannelSplitterNode オブジェクトのインスタンスを返します。

例

js
const ac = new AudioContext();

const options = {
  numberOfOutputs: 2,
};

const mySplitter = new ChannelSplitterNode(ac, options);

仕様書

Specification
Web Audio API
# dom-channelsplitternode-constructor-channelsplitternode

ブラウザーの互換性

BCD tables only load in the browser