AudioDestinationNode

基线 广泛可用

此功能已得到很好的确立,并且可在许多设备和浏览器版本中使用。它自以下日期起在浏览器中可用 2021 年 4 月.

AudioDestinationNode 接口表示给定上下文中音频图的最终目标 - 通常是设备的扬声器。当与 OfflineAudioContext 一起使用时,它也可以是“录制”音频数据的节点。

AudioDestinationNode 没有输出(因为它输出,因此在音频图中不能在它之后链接更多 AudioNode)和一个输入。输入中的通道数必须介于 0maxChannelCount 值之间,否则会引发异常。

可以使用 AudioContext.destination 属性检索给定 AudioContextAudioDestinationNode

EventTarget AudioNode AudioDestinationNode
输入数量 1
输出数量 0
通道数模式 "显式"
通道数 2
通道解释 "扬声器"

实例属性

继承自其父级 AudioNode 的属性.

AudioDestinationNode.maxChannelCount

一个 无符号长整数,定义物理设备可以处理的最大通道数。

实例方法

没有特定方法;继承自其父级 AudioNode 的方法.

示例

使用 AudioDestinationNode 没有复杂的设置 - 默认情况下,这表示用户系统的输出(例如,他们的扬声器),因此您只需几行代码即可将其连接到音频图中

js
const audioCtx = new AudioContext();
const source = audioCtx.createMediaElementSource(myMediaElement);
source.connect(gainNode);
gainNode.connect(audioCtx.destination);

要查看更完整的实现,请查看我们的 MDN Web Audio 示例之一,例如 Voice-change-o-maticViolent Theremin

规范

规范
Web Audio API
# AudioDestinationNode

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅