API захвата изображений MediaStream

API захвата изображений MediaStream — это API для захвата изображений или видео с фотоустройства. Помимо захвата данных, он также позволяет получать информацию о возможностях устройства, таких как размер изображения, уменьшение эффекта красных глаз, наличие и текущие настройки вспышки. Наоборот, API позволяет настраивать возможности в рамках ограничений, накладываемых устройством.

Процесс получения потока изображения или видео происходит следующим образом. Приведенный пример кода адаптирован из примеров захвата изображений Chrome.

Сначала получите ссылку на устройство, вызвав MediaDevices.getUserMedia(). В примере ниже сказано, что нужно взять любое доступное видеоустройство, хотя метод getUserMedia() позволяет запросить более конкретные возможности. Этот метод возвращает Promise, который разрешается объектом MediaStream.

navigator.mediaDevices.getUserMedia({ video: true }).then((mediaStream) => {
  // Do something with the stream.
});

Далее, изолируйте визуальную часть потока медиа, вызвав MediaStream.getVideoTracks(). Это возвращает массив объектов MediaStreamTrack. В приведенном ниже коде предполагается, что первый элемент в массиве MediaStreamTrack — тот, который нужно использовать. Вы можете использовать свойства объектов MediaStreamTrack для выбора нужного.

const track = mediaStream.getVideoTracks()[0];

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

let zoom = document.querySelector("#zoom");
const capabilities = track.getCapabilities();
// Check whether zoom is supported or not.
if (!capabilities.zoom) {
  return;
}
track.applyConstraints({ advanced: [{ zoom: zoom.value }] });

Наконец, передайте объект MediaStreamTrack в конструктор ImageCapture(). Хотя MediaStream содержит несколько типов треков и предоставляет несколько методов для их получения, конструктор ImageCapture выбросит исключение DOMException типа NotSupportedError , если MediaStreamTrack.kind не равен "video".

let imageCapture = new ImageCapture(track);

ImageCapture Экспериментально

Интерфейс для захвата изображений с фотоустройства, на которое ссылается допустимый объект MediaStreamTrack.

• MediaStream
• MediaStreamTrack