MediaStreamTrack: метод applyConstraints()

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

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

constraints Необязательно

Объект MediaTrackConstraints, перечисляющий ограничения, применяемые к ограниченным свойствам трека; все существующие ограничения заменяются новыми значениями, указанными в этом объекте, а любые ограниченные свойства, не включенные в него, восстанавливаются до своих значений по умолчанию. Если этот параметр опущен, все настроенные пользовательские ограничения сбрасываются. Этот объект представляет собой базовый набор ограничений, который должен применяться для разрешения Promise. Объект может содержать расширенное свойство, содержащее массив дополнительных MediaTrackConstraints объектов, которые обрабатываются как точные требования.

Объект Promise, который разрешается, когда ограничения успешно применены. Если ограничения не могут быть применены, промис отклоняется с помощью объекта OverconstrainedError, который является исключением DOMException с именем OverconstrainedError и дополнительными параметрами, указывающими, что ограничения не могут быть выполнены. Это может произойти, если указанные ограничения слишком строги, чтобы найти соответствие при попытке настроить трек.

В следующем примере показано, как указать базовый и расширенный наборы ограничений. Указывается, что страница или веб-приложение нуждается в ширине от 640 до 1280 и высоте от 480 до 720, причем последнее число в каждой паре предпочтительнее. Расширенное свойство дополнительно указывает, что предпочтительный размер изображения составляет 1920 на 1280 или соотношение сторон 1,333, если это значение недоступно. Обратите внимание, что эти ограничения также иллюстрируют то, что спецификация называет стратегией понижения требований.

const constraints = {
  width: { min: 640, ideal: 1280 },
  height: { min: 480, ideal: 720 },
  advanced: [{ width: 1920, height: 1280 }, { aspectRatio: 1.333 }],
};

navigator.mediaDevices.getUserMedia({ video: true }).then((mediaStream) => {
  const track = mediaStream.getVideoTracks()[0];
  track
    .applyConstraints(constraints)
    .then(() => {
      // Do something with the track such as using the Image Capture API.
    })
    .catch((e) => {
      // The constraints could not be satisfied by the available devices.
    });
});

• MediaStream Image Capture API