MediaTrackSettings

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

Дополнительную информацию о работе ограничений и настроек см. в разделе Возможности, ограничения и настройки.

В объект могут быть включены некоторые или все из следующих свойств, либо потому, что они не поддерживаются браузером, либо потому, что они недоступны из-за контекста. Например, поскольку RTP не предоставляет некоторые из этих значений во время переговоров по подключению WebRTC, трек, связанный с RTCPeerConnection, не будет включать определённые значения, такие как facingMode или groupId.

deviceId

Строка, указывающая текущее значение свойства deviceId. Идентификатор устройства — это уникальная для источника строка, идентифицирующая источник трека; обычно это GUID. Это значение специфично для источника данных трека и не используется для настройки ограничений; однако оно может быть использовано для первоначального выбора медиа при вызове MediaDevices.getUserMedia().

groupId

Строка, указывающая текущее значение свойства groupId. Идентификатор группы — это уникальная для сеанса просмотра строка, идентифицирующая исходную группу трека. Два устройства (как определяются по deviceId) считаются частью одной группы, если они происходят от одного физического устройства. Например, устройства ввода и вывода аудио для динамиков и микрофона, встроенные в телефон, будут иметь один и тот же идентификатор группы, так как они являются частью одного физического устройства. Микрофон на гарнитуре будет иметь другой идентификатор. Это значение специфично для источника данных трека и не используется для настройки ограничений; однако оно может быть использовано для первоначального выбора медиа при вызове MediaDevices.getUserMedia().

autoGainControl

Булево значение, указывающее текущее значение свойства autoGainControl, которое равно true если автоматическая регулировка усиления включена и false в противном случае.

channelCount

Целое число, указывающее текущее значение свойства channelCount, определяющее количество аудиоканалов в треке (следовательно, количество аудиосэмплов в каждом кадре аудио). 1 для моно, 2 для стерео и так далее.

echoCancellation

Булево значение, указывающее текущее значение свойства echoCancellation, которое равно true если подавление эха включено, и false в противном случае.

latency

Значение с плавающей точкой двойной точности, указывающее текущее значение свойства latency, определяющее задержку аудио в секундах. Задержка — это время, которое проходит между началом обработки аудио и доступностью данных для следующего этапа процесса использования аудио. Это целевое значение; фактическая задержка может незначительно отличаться по разным причинам.

noiseSuppression

Булево значение, указывающее текущее значение свойства noiseSuppression, которое равно true если подавление шума включено и false в противном случае.

sampleRate

Целое число, указывающее текущее значение свойства sampleRate, определяющее частоту дискретизации в сэмплах в секунду для аудиоданных. Стандартное аудио CD-качества, например, имеет частоту дискретизации 44100 сэмплов в секунду.

sampleSize

Целое число, указывающее текущее значение свойства sampleSize, определяющее линейный размер каждого аудиосэмпла в битах. Аудио CD-качества, например, имеет 16 бит, поэтому в этом случае значение будет 16.

volume Устаревшее Нестандартное

Значение с плавающей точкой двойной точности, указывающее текущее значение свойства volume, определяющее уровень громкости трека. Это значение будет между 0,0 (без звука) и 1,0 (максимальная поддерживаемая громкость).

aspectRatio

Значение с плавающей точкой двойной точности, указывающее текущее значение свойства aspectRatio, указанное точно до 10 знаков после запятой. Это ширина изображения в пикселях, делённая на высоту в пикселях. Распространённые значения включают 1,3333333333 (для классического телевизионного 4:3 «стандартного» соотношения сторон, также используемого на планшетах, таких как iPad от Apple), 1,7777777778 (для широкоэкранного разрешения высокой чёткости 16:9) и 1,6 (для соотношения сторон 16:10, распространённого среди широкоэкранных компьютеров и планшетов).

facingMode

Строка, указывающая текущее значение свойства facingMode, определяющее направление, в котором направлена камера. Значение будет одним из следующих:

"user"

Камера, направленная на пользователя (обычно известна как «камера селфи»), используется для создания автопортретов и видеозвонков.

"environment"

Камера, направленная от пользователя (когда пользователь смотрит на экран). Обычно это камера наивысшего качества на устройстве, используемая для обычной фотографии.

"left"

Камера, направленная в сторону среды слева от пользователя.

"right"

Камера, направленная в сторону среды справа от пользователя.

frameRate

Значение с плавающей точкой двойной точности, указывающее текущее значение свойства frameRate, определяющее количество кадров видео в секунду, содержащихся в треке. Если значение невозможно определить по какой-либо причине, оно будет соответствовать частоте вертикальной синхронизации устройства, на котором работает пользовательский агент.

height

Целое число, указывающее текущее значение свойства height, определяющее высоту видеоданных трека в пикселях.

width

Целое число, указывающее текущее значение свойства width, определяющее ширину видеоданных трека в пикселях.

resizeMode

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

"none"

Разрешение трека соответствует разрешению, предлагаемому камерой, её драйвером или операционной системой.

"crop-and-scale"

Разрешение трека может быть результатом использования пользовательским агентом обрезки или масштабирования из более высокого разрешения камеры.

Треки, содержащие видео, общие из экрана пользователя (независимо от того, поступают ли данные экрана со всего экрана или с части экрана, например, окна или вкладки), обычно обрабатываются как видеотреки, за исключением того, что они также поддерживают следующие дополнительные настройки:

cursor

Строка, указывающая, включается ли курсор мыши в генерируемый поток и при каких условиях. Возможные значения:

always

Курсор мыши всегда отображается в видеоконтенте {domxref("MediaStream")}, если только мышь не перемещена за пределы области контента.

motion

Курсор мыши всегда включается в видео, если он движется, и в течение короткого времени после его остановки.

never

Курсор мыши никогда не включается в общее видео.

displaySurface

Строка, определяющая тип источника, содержащегося в треке; один из:

browser

Поток содержит содержимое одной вкладки браузера, выбранной пользователем.

monitor

Видеотрек потока содержит всё содержимое одного или нескольких экранов пользователя.

window

Поток содержит одно окно, выбранное пользователем для совместного использования.

logicalSurface

Булево значение, которое, если true, указывает, что видео, содержащееся в видеотреке потока, содержит контекст рендеринга фона, а не видимый для пользователя. Это false если видео, которое захватывается, поступает из переднего (видимого для пользователя) источника.

• MediaDevices.getUserMedia()
• MediaDevices.getDisplayMedia()
• MediaStreamTrack.getConstraints()
• MediaStreamTrack.applyConstraints()
• MediaStreamTrack.getSettings()