MediaTrackSupportedConstraints

MediaTrackSupportedConstraints 字典建立了使用者代理或瀏覽器在其對 MediaStreamTrack 物件實現中所識別的可約束屬性列表。符合 MediaTrackSupportedConstraints 的物件由 MediaDevices.getSupportedConstraints() 返回。

由於 WebIDL 中介面定義的處理方式，如果在請求時指定了某個約束但該約束不受支援，則不會發生錯誤。相反，將應用指定的約束，並將任何未識別的約束從請求中移除。這可能導致難以除錯的混淆錯誤，因此，如果您需要區分靜默忽略約束和約束被接受，請務必在使用 getSupportedConstraints() 檢索此資訊後再嘗試設定約束。

實際的約束集使用基於 MediaTrackConstraints 字典的物件來描述。

要了解有關約束工作原理的更多資訊，請參閱功能、約束和設定。

例項屬性

物件上將存在以下屬性的某些組合（但不一定是全部）。

aspectRatio: 如果當前環境中支援 aspectRatio 約束，則為 true。
autoGainControl: 如果當前環境中支援 autoGainControl 約束，則為 true。
channelCount: 如果當前環境中支援 channelCount 約束，則為 true。
deviceId: 如果當前環境中支援 deviceId 約束，則為 true。
echoCancellation: 如果當前環境中支援 echoCancellation 約束，則為 true。
facingMode: 如果當前環境中支援 facingMode 約束，則為 true。
frameRate: 如果當前環境中支援 frameRate 約束，則為 true。
groupId: 如果當前環境中支援 groupId 約束，則為 true。
height: 如果當前環境中支援 height 約束，則為 true。
latency: 如果當前環境中支援 latency 約束，則為 true。
noiseSuppression: 如果當前環境中支援 noiseSuppression 約束，則為 true。
restrictOwnAudio: 如果當前環境中支援 restrictOwnAudio 約束，則為 true。
resizeMode: 如果當前環境中支援 resizeMode 約束，則為 true。
sampleRate: 如果當前環境中支援 sampleRate 約束，則為 true。
sampleSize: 如果當前環境中支援 sampleSize 約束，則為 true。
suppressLocalAudioPlayback: 如果當前環境中支援 suppressLocalAudioPlayback 約束，則為 true。
volume 已棄用非標準: 如果當前環境中支援 volume 約束，則為 true。
width: 如果當前環境中支援 width 約束，則為 true。

共享螢幕軌道特有的例項屬性

對於包含使用者螢幕影片源的軌道，除了可用於影片軌道的屬性外，可能還會包含以下附加屬性：

displaySurface: 如果當前環境中支援 displaySurface 約束，則為 true。
logicalSurface: 如果當前環境中支援 logicalSurface 約束，則為 true。

規範

規範
媒體捕獲和流 # media-track-supported-constraints

另見

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 ⁨2025 年 10 月 15 日⁩，由 MDN 貢獻者修改。

在 GitHub 上檢視此頁面 • 報告此內容的錯誤