MediaTrackSupportedConstraints

Словарь MediaTrackSupportedConstraints определяет список свойств, которые можно ограничивать, распознаваемые браузером при реализации объекта user agent или браузера при работе с объектом MediaStreamTrack. Объект, соответствующий MediaTrackSupportedConstraints возвращается методом MediaDevices.getSupportedConstraints().

Из-за особенностей определения интерфейсов в WebIDL, если ограничение запрошено, но не поддерживается, ошибка не возникнет. Вместо этого указанные ограничения будут применены, а любые нераспознанные ограничения будут исключены из запроса. Это может привести к путанице и трудно отлаживаемым ошибкам, поэтому обязательно используйте getSupportedConstraints() для получения этой информации перед попыткой установить ограничения, если вам нужно знать разницу между молчаливым игнорированием ограничения и принятием ограничения.

Набор фактических ограничений описывается с помощью объекта, основанного на словаре MediaTrackConstraints.

Чтобы узнать больше о работе с ограничениями, см. Возможности, ограничения и настройки.

На объекте может присутствовать любая комбинация, но не обязательно все, следующих свойств.

autoGainControl

Булево значение, равное true если ограничение autoGainControl поддерживается в текущей среде.

width

Булево значение, равное true если ограничение width поддерживается в текущей среде.

height

Булево значение, равное true если ограничение height поддерживается в текущей среде.

aspectRatio

Булево значение, равное true если ограничение aspectRatio поддерживается в текущей среде.

frameRate

Булево значение, равное true если ограничение frameRate поддерживается в текущей среде.

facingMode

Булево значение, равное true если ограничение facingMode поддерживается в текущей среде.

resizeMode

Булево значение, равное true если ограничение resizeMode поддерживается в текущей среде.

volume Устаревшее Нестандартное

Булево значение, равное true если ограничение volume поддерживается в текущей среде.

sampleRate

Булево значение, равное true если ограничение sampleRate поддерживается в текущей среде.

sampleSize

Булево значение, равное true если ограничение sampleSize поддерживается в текущей среде.

echoCancellation

Булево значение, равное true если ограничение echoCancellation поддерживается в текущей среде.

latency

Булево значение, равное true если ограничение latency поддерживается в текущей среде.

noiseSuppression

Булево значение, равное true если ограничение noiseSuppression поддерживается в текущей среде.

channelCount

Булево значение, равное true если ограничение channelCount поддерживается в текущей среде.

deviceId

Булево значение, равное true если ограничение deviceId поддерживается в текущей среде.

groupId

Булево значение, равное true если ограничение groupId поддерживается в текущей среде.

Для треков, содержащих видеоисточники с контентом экрана пользователя, могут быть включены следующие дополнительные свойства помимо свойств, доступных для видеотреков.

displaySurface

Булево значение, равное true если ограничение displaySurface поддерживается в текущей среде.

logicalSurface

Булево значение, равное true если ограничение logicalSurface поддерживается в текущей среде.

• API захвата медиа и потоков
• Возможности, ограничения и настройки
• API захвата экрана
• Использование API захвата экрана
• MediaTrackConstraints
• MediaDevices.getUserMedia()
• MediaStreamTrack.getConstraints()
• MediaStreamTrack.applyConstraints()
• MediaStreamTrack.getSettings()