AudioDestinationNode

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

AudioDestinationNode 介面代表給定上下文中音訊圖的最終目的地——通常是您裝置的揚聲器。當與 OfflineAudioContext 一起使用時,它也可以是“錄製”音訊資料的節點。

AudioDestinationNode 沒有輸出(因為它輸出,音訊圖中不能再連結任何 AudioNode)但有一個輸入。輸入通道數必須在 0maxChannelCount 值之間,否則將引發異常。

可以使用 AudioContext.destination 屬性檢索給定 AudioContextAudioDestinationNode

EventTarget AudioNode AudioDestinationNode
輸入數量 1
輸出數量 0
通道計數模式 “explicit”
聲道數 2
通道解釋 “speakers”

例項屬性

繼承自其父級 AudioNode 的屬性.

AudioDestinationNode.maxChannelCount

一個 unsigned long,定義了物理裝置可以處理的最大通道數。

例項方法

無特定方法;繼承自其父級 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

瀏覽器相容性

另見