InputDeviceInfo: метод getCapabilities()

Метод getCapabilities() интерфейса InputDeviceInfo возвращает объект MediaTrackCapabilities, описывающий основной аудио- или видеопоток устройства MediaStream.

Нет.

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

deviceId

Объект ConstrainDOMString, содержащий идентификатор устройства.

groupId

Объект ConstrainDOMString, содержащий идентификатор группы.

autoGainControl

Объект ConstrainBoolean, сообщающий, может ли источник выполнить автоматическую регулировку усиления. Если функция может контролироваться скриптом, источник будет сообщать как значение true, так и false.

channelCount

Объект ConstrainULong, содержащий количество каналов или диапазон значений количества каналов.

echoCancellation

Объект ConstrainBoolean, сообщающий, может ли источник выполнить подавление эха. Если функция может контролироваться скриптом, источник будет сообщать как значение true, так и false.

latency

Объект ConstrainDouble, содержащий задержку или диапазон задержек.

noiseSuppression

Объект ConstrainBoolean, сообщающий, может ли источник выполнить подавление шума. Если функция может контролироваться скриптом, источник будет сообщать как значение true, так и false.

sampleRate

Объект ConstrainULong, содержащий частоту дискретизации или диапазон частот дискретизации.

sampleSize

Объект ConstrainULong, содержащий размер выборки или диапазон размеров выборок.

aspectRatio

Объект ConstrainDouble, содержащий отношение сторон видео аспекта (ширина в пикселях, деленная на высоту в пикселях) или диапазон отношений сторон.

facingMode

Объект ConstrainDOMString, содержащий режим расположения камеры. Камера может сообщать о нескольких расположениях, например, "слева" и "пользователь".

frameRate

Объект ConstrainDouble, содержащий частоту кадров или диапазон частот кадров, которые приемлемы.

height

Объект ConstrainULong, содержащий высоту видео или диапазон высот в пикселях.

width

Объект ConstrainULong, содержащий ширину видео или диапазон ширин в пикселях.

resizeMode

Объект ConstrainDOMString, содержащий режим или массив режимов, которые UA может использовать для вывода разрешения видеопотока.

В следующем примере мы запрашиваем разрешение на доступ к аудио- и видеоустройствам с помощью mediaDevices.getUserMedia(), так как для использования getCapabilities() нам нужно разрешение на доступ к устройствам.

Если device является объектом InputDeviceInfo, то getCapabilities() вернёт объект с членами, представляющими его возможности. Видеопоток не будет содержать автосвойств, например, noiseSuppression.

// Get permission to access audio or video devices
navigator.mediaDevices.getUserMedia({ audio: true, video: true });

navigator.mediaDevices.enumerateDevices().then((devices) => {
  devices.forEach((device) => {
    console.log(device.getCapabilities()); // a MediaTrackCapabilities object.
  });
});

• MediaStreamTrack.getCapabilities(), которая также возвращает объект MediaTrackCapabilities.