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

AudioContext: sinkId property

· 52CE 我爱测

The **`sinkId`** read-only property of the AudioContext interface returns the sink ID of the current output audio device.

Web Audio API

The sinkId read-only property of the AudioContext interface returns the sink ID of the current output audio device.

Value

This property returns one of the following values, depending on how the sink ID was set:

  • An empty string
    • : If a sink ID has not explicitly been set, the default system audio output device will be used, and sinkId will return an empty string.
  • A string
    • : If the sink ID is set as a string value (using AudioContext.setSinkId, or the sinkId AudioContext.AudioContext constructor option), sinkId will return that same string value.
  • An AudioSinkInfo object
    • : If the sink ID is set as an options object (using AudioContext.setSinkId, or the sinkId AudioContext.AudioContext constructor option), sinkId will return an AudioSinkInfo object reflecting the same values set in the initial options object.

Examples

In our SetSinkId test example (check out the source code), we create an audio graph that generates a three-second burst of white noise via an AudioBufferSourceNode, which we also run through a GainNode to quiet things down a bit. We also provide the user with a dropdown menu to allow them to change the audio output device.

When the Play button is clicked, we assemble the audio graph and start it playing, and we also log information about the current device to the console based on the value of sinkId:

  • An empty string means the default device is still being used.
  • If the value is an object, the audio will not be playing on any device because we set an options object containing type: 'none'.
  • Otherwise the value will be a sink ID string, so we log that.
playBtn.addEventListener("click", () => {
  const source = audioCtx.createBufferSource();
  source.buffer = myArrayBuffer;
  source.connect(gain);
  gain.connect(audioCtx.destination);
  source.start();

  if (audioCtx.sinkId === "") {
    console.log("Audio playing on default device");
  } else if (
    typeof audioCtx.sinkId === "object" &&
    audioCtx.sinkId.type === "none"
  ) {
    console.log("Audio not playing on any device");
  } else {
    console.log(`Audio playing on device ${audioCtx.sinkId}`);
  }
});

Specifications

Browser compatibility

See also

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

资料来源与适用范围

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

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

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