MediaTrackConstraints: echoCancellation 屬性
MediaTrackConstraints 字典的 echoCancellation 屬性是一個 ConstrainBooleanOrDOMString,用於描述在 echoCancellation 可約束屬性值上設定的請求或強制約束。
如果需要,您可以透過呼叫 MediaDevices.getSupportedConstraints() 返回的 MediaTrackSupportedConstraints.echoCancellation 的值來確定此約束是否受支援。然而,通常這沒有必要,因為瀏覽器會忽略它們不認識的任何約束。
值
一個布林值、一個字串或一個 ConstrainBooleanOrDOMString 物件。
如果瀏覽器支援特定的回聲消除型別,則可以將值設定為以下選項之一:
"all"Experimental-
移除使用者麥克風捕獲的所有使用者系統生成的音訊。這在您希望避免捕獲隱私敏感音訊(如螢幕閱讀器輸出和系統通知)的情況下非常有用。
"remote-only"Experimental-
僅移除使用者麥克風從遠端源(由來自
RTCPeerConnection的MediaStreamTrack表示)捕獲的使用者系統生成的音訊。當您想消除與遠端對等方的通訊回聲,但仍共享本地音訊時,這很有用,例如在音樂課中,老師想聽學生跟隨音軌演奏,同時仍能與他們清晰地交流。 true-
瀏覽器決定從麥克風錄製的訊號中移除哪些音訊。它必須嘗試消除至少與
remote-only一樣多的音訊,並應嘗試消除與all一樣多的音訊。 false-
不移除任何音訊;不進行回聲消除。
如果瀏覽器不支援特定的回聲消除型別,則該值可以是 true 或 false。
如果設定為上述值之一,使用者代理將嘗試在可能的情況下啟用或停用回聲消除來獲取媒體,但如果無法完成,則不會失敗。
如果值是帶有 exact 欄位的物件,則該欄位的值表示回聲消除功能的必需設定;如果無法滿足,則請求將導致錯誤。
示例
請參閱 Constraint exerciser 示例。
規範
| 規範 |
|---|
| 媒體捕獲和流 # dom-mediatrackconstraintset-echocancellation |
瀏覽器相容性
載入中…