MediaTrackConstraints: свойство groupId

Свойство groupId словаря MediaTrackConstraints является ConstrainDOMString, описывающим запрошенные или обязательные ограничения, накладываемые на значение свойстве groupId.

При необходимости вы можете определить, поддерживается ли это ограничение, проверив значение MediaTrackSupportedConstraints.groupId, возвращаемое вызовом MediaDevices.getSupportedConstraints(). Однако, обычно это не нужно, так как браузеры проигнорируют любые ограничения, с которыми они не знакомы.

Объект, основанный на ConstrainDOMString, определяющий один или несколько допустимых, идеальных и/или точных (обязательных) идентификаторов групп, которые приемлемы в качестве источника медиа-контента.

Идентификаторы групп уникальны для данного происхождения на протяжении всего сеанса просмотра и используются всеми источниками медиа, которые происходят с одного физического устройства. Например, микрофон и динамики на одной гарнитуре будут использовать один идентификатор группы. Это позволяет использовать идентификатор группы для обеспечения того, что аудио- и входные устройства находятся на одной гарнитуре, получив идентификатор группы входного устройства и указав его при запросе выходного устройства, возможно.

Однако, значение groupId определяется источником контента трека, и в спецификации не определен конкретный формат (хотя рекомендуется использовать какой-либо GUID). Это означает, что данный трек вернет только одно значение для groupId при вызове getCapabilities(), и имейте в виду, что это значение будет меняться для каждого сеанса просмотра.

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

См. пример Задания ограничений.

• API захвата медиа и потоков
• Возможности, ограничения и настройки
• MediaTrackConstraints
• MediaDevices.getSupportedConstraints()
• MediaTrackSupportedConstraints
• MediaStreamTrack