MediaStreamTrack: метод getCapabilities()

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

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

Нет.

Объект 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, содержащий режим ориентации камеры. Камера может сообщать о нескольких ориентациях, например, "left" и "user".

frameRate

ConstrainDouble с частотой кадров или диапазоном приемлемых частот кадров.

height

ConstrainULong с высотой видео или диапазоном высот в пикселях.

width

ConstrainULong с шириной видео или диапазоном ширин в пикселях.

resizeMode

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

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

navigator.mediaDevices
  .getUserMedia({ video: true, audio: true })
  .then((stream) => {
    const tracks = stream.getTracks();
    tracks.map((t) => console.log(t.getCapabilities()));
  });

Пример объекта возможностей выглядит следующим образом:

{
  "autoGainControl": [
    true,
    false
  ],
  "channelCount": {
    "max": 1,
    "min": 1
  },
  "deviceId": "jjxEMqxIhGdryqbTjDrXPWrkjy55Vte70kWpMe3Lge8=",
  "echoCancellation": [
    true,
    false
  ],
  "groupId": "o2tZiEj4MwOdG/LW3HwkjpLm1D8URat4C5kt742xrVQ=",
  "noiseSuppression": [
    true,
    false
  ]
}

Точное содержание объекта будет зависеть от браузера и медиа-оборудования.

• InputDeviceInfo.getCapabilities(), который также возвращает объект MediaTrackCapabilities.