MediaTrackConstraints：restrictOwnAudio 屬性
MediaTrackConstraints 字典的 restrictOwnAudio 屬性是一個 ConstrainBoolean，用於指定對 restrictOwnAudio 可約束屬性值所做的請求或強制約束。
此屬性控制是否從螢幕捕獲中過濾掉源自捕獲標籤的系統音訊，以便在某些情況下獲得更清晰的螢幕錄製。例如，如果捕獲的網頁本身正在播放嵌入式音訊或影片，該音訊將被包含在捕獲中。由於這可能會導致不期望的回聲或干擾其他標籤或應用程式的預期音訊源，因此從捕獲中刪除它是可取的。
如果需要，可以透過檢查 MediaDevices.getSupportedConstraints() 返回的 MediaTrackSupportedConstraints.restrictOwnAudio 的值來確定此約束是否受支援。但是，這很少有必要，因為瀏覽器通常會忽略它們不識別的任何約束。
值
一個 ConstrainBoolean 值。
如果值為 true，則使用者代理將嘗試刪除源自呼叫 MediaDevices.getDisplayMedia() 來啟動螢幕捕獲的標籤的任何音訊。如果透過處理無法刪除音訊，使用者代理可能會排除源自捕獲標籤的所有音訊。
注意：如果捕獲的顯示錶面不包含系統音訊，則此設定將無效。
如果值為 exact，則該欄位的布林值表示對 restrictOwnAudio 功能的嚴格要求；如果使用者代理無法滿足此要求，則請求將導致錯誤。
如果值為 false，則使用者代理將不會嘗試限制源自捕獲標籤的任何系統音訊。
示例
js
let isCapturingTabSystemAudioRestricted = displayStream
.getAudioTracks()[0]
.getSettings().restrictOwnAudio;
Constraint exerciser 示例顯示瞭如何使用媒體軌道約束。
規範
| 規範 |
|---|
| 螢幕捕獲 # dom-mediatrackconstraintset-restrictownaudio |
瀏覽器相容性
載入中…