MediaTrackConstraints:suppressLocalAudioPlayback 屬性

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

實驗性: 這是一項實驗性技術
在生產中使用此技術之前,請仔細檢查瀏覽器相容性表格

MediaTrackConstraints 字典的 suppressLocalAudioPlayback 屬性是一個 ConstrainBoolean,用於描述應用於 suppressLocalAudioPlayback 可約束屬性值請求或強制約束。此屬性控制在捕獲選項卡時,選項卡中播放的音訊是否會繼續透過使用者的本地揚聲器播放。

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

一個 ConstrainBoolean 值。

如果此值為簡單的 truefalse,則使用者代理將嘗試在可能的情況下啟用或停用指定的本地音訊播放來獲取媒體,但如果無法做到這一點,也不會失敗。

如果該值指定為 ideal,則該欄位的布林值表示本地音訊播放抑制功能的理想設定;如果無法滿足,則請求將導致錯誤。

示例

js
let isLocalAudioSuppressed = displayStream
  .getVideoTracks()[0]
  .getSettings().suppressLocalAudioPlayback;

約束執行器》示例展示瞭如何使用媒體軌道約束。

規範

規範
螢幕捕獲
# dom-mediatrackconstraintset-suppresslocalaudioplayback

瀏覽器相容性

另見