大网数据广告活动
Web 标准与前端开发

MediaStreamTrackAudioSourceNode: MediaStreamTrackAudioSourceNode() constructor

· 52CE 我爱测

The Web Audio API's **`MediaStreamTrackAudioSourceNode()`** constructor creates and returns a new MediaStreamTrackAudioSourceNode object whose audio is taken from the MediaStreamTrack specified in the given options object.

Web Audio API

The Web Audio API's MediaStreamTrackAudioSourceNode() constructor creates and returns a new MediaStreamTrackAudioSourceNode object whose audio is taken from the MediaStreamTrack specified in the given options object.

Another way to create a MediaStreamTrackAudioSourceNode is to call the AudioContext.createMediaStreamTrackSource() method, specifying the MediaStreamTrack from which you want to obtain audio.

Syntax

new MediaStreamTrackAudioSourceNode(context, options)

Parameters

  • context
    • : An AudioContext representing the audio context you want the node to be associated with.
  • options
    • : An object defining the properties you want the MediaStreamTrackAudioSourceNode to have:
      • mediaStreamTrack
        • : The MediaStreamTrack from which to take audio data for this node's output.

Return value

A new MediaStreamTrackAudioSourceNode object representing the audio node whose media is obtained from the specified media track.

Exceptions

  • NotSupportedError DOMException
    • : Thrown if the specified context is not an AudioContext.
  • InvalidStateError DOMException
    • : Thrown if the specified MediaStreamTrack isn't an audio track (that is, its MediaStreamTrack.kind property isn't audio).

Example

This example uses MediaDevices.getUserMedia to obtain access to the user's camera, then creates a new MediaStreamAudioSourceNode from the first audio track provided by the device.

const audioCtx = new AudioContext();

if (navigator.mediaDevices.getUserMedia) {
  navigator.mediaDevices
    .getUserMedia({
      audio: true,
      video: false,
    })
    .then((stream) => {
      const options = {
        mediaStreamTrack: stream.getAudioTracks()[0],
      };

      const source = new MediaStreamTrackAudioSourceNode(audioCtx, options);
      source.connect(audioCtx.destination);
    })
    .catch((err) => {
      console.error(`The following gUM error occurred: ${err}`);
    });
} else {
  console.log("new getUserMedia not supported on your browser!");
}

Specifications

Browser compatibility

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。