Spec-Zone.ru › Web APIs

MediaStreamTrack: метод getConstraints()

Базовый Широко доступный

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с сентября 2017 года.

  • Узнать больше
  • Полная совместимость
  • Отправить отзыв

Метод getConstraints() интерфейса MediaStreamTrack возвращает объект MediaTrackConstraints, содержащий набор ограничений, установленных для дорожки последним вызовом applyConstraints(). Эти ограничения указывают значения и диапазоны значений, которые веб-сайт или приложение указали как необходимые или допустимые для свойств, подлежащих ограничению.

Ограничения могут использоваться для обеспечения соответствия медиа определённым требованиям. Например, вы можете предпочесть видео высокой чёткости, но потребовать немного низкую частоту кадров, чтобы снизить скорость передачи данных и не перегрузить сеть. Ограничения также могут указывать идеальные и/или допустимые размеры или диапазоны размеров. Подробнее о работе со свойствами, подлежащими ограничению, см. Возможности, ограничения и настройки.

Синтаксис

getConstraints()

Параметры

Нет.

Возвращаемое значение

Объект MediaTrackConstraints, указывающий свойства, подлежащие ограничению, которые веб-сайт или приложение установили последним вызовом applyConstraints(). Свойства в возвращаемом объекте перечислены в том же порядке, что и при их установке, и включают только те свойства, которые были специально установлены сайтом или приложением.

Примечание: Возвращаемый набор ограничений необязательно описывает фактическое состояние медиа. Даже если некоторые ограничения не могут быть выполнены, они всё равно включаются в возвращаемый объект, как изначально установлено кодом сайта. Чтобы получить текущие настройки всех свойств, подлежащих ограничению, вы должны вместо этого вызвать getSettings().

Примеры

В этом примере извлекаются текущие ограничения для дорожки, устанавливается facingMode, и применяются обновлённые ограничения.

function switchCameras(track, camera) {
  const constraints = track.getConstraints();
  constraints.facingMode = camera;
  track.applyConstraints(constraints);
}

Спецификации

Спецификация
Media Capture and Streams
# dom-mediastreamtrack-getconstraints

Совместимость с браузерами

Десктопные Мобильные
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari на iOS Samsung Internet WebView Android
getConstraints 53 12 50 40 11 52 50 41 11 6.0 53

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/MediaStreamTrack/getConstraints

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API