MediaTrackSettings: echoCancellation 屬性

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2020 年 1 月⁩ 起,所有主流瀏覽器均已支援。

MediaTrackSettings 字典的 echoCancellation 屬性是一個布林值,其值指示音訊軌道上是否啟用了回聲消除。這可以幫助您確定在呼叫 getUserMedia()MediaStreamTrack.applyConstraints() 時,為了滿足您為該屬性值提供的 MediaTrackConstraints.echoCancellation 約束而選擇的值。

回聲消除是一項功能,它透過嘗試減少或消除使用者輸出裝置與其輸入裝置之間的串擾,來防止雙向音訊連線中的回聲效果。例如,它可能會應用一個過濾器,該過濾器會抵消揚聲器發出的聲音被麥克風生成的輸入軌道包含的情況。

如果需要,您可以透過呼叫 MediaDevices.getSupportedConstraints() 返回的 MediaTrackSupportedConstraints.echoCancellation 的值來確定此約束是否受支援。但是,通常這並不必要,因為瀏覽器會忽略它們不認識的任何約束。

由於 RTP 不包含此資訊,因此與 WebRTC RTCPeerConnection 關聯的軌道永遠不會包含此屬性。

一個布林值,如果軌道啟用了回聲消除功能,則為 true,如果停用了回聲消除,則為 false

示例

請參閱 Constraint exerciser 示例。

規範

規範
媒體捕獲和流
# dom-mediatrackconstraintset-echocancellation

瀏覽器相容性

另見