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

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.

MediaElementAudioSourceNode() コンストラクターは、新しい MediaElementAudioSourceNode オブジェクトのインスタンスを生成します。

構文

js
new MediaElementAudioSourceNode(context, options)

引数

context

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

options

MediaElementAudioSourceNode が持つ性質を定義するオブジェクトです。

mediaElement

音声の音源として用いる HTMLMediaElement です。

channelCount

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

channelCountMode

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

channelInterpretation

チャンネルの意味を表す文字列です。この解釈は、アップミキシングとダウンミキシングを行う方法を決めます。取りうる値は "speakers" および "discrete" です。(デフォルト値を含む詳細は AudioNode.channelInterpretation を参照してください)

返値

新しい MediaElementAudioSourceNode オブジェクトのインスタンスです。

例

js
const ac = new AudioContext();
const mediaElement = document.createElement("audio");

const myAudioSource = new MediaElementAudioSourceNode(ac, {
  mediaElement,
});

仕様書

Specification
Web Audio API
# dom-mediaelementaudiosourcenode-mediaelementaudiosourcenode

ブラウザーの互換性

BCD tables only load in the browser