MediaTrackSettings: свойство groupId

Свойство groupId словаря MediaTrackSettings — это уникальная для сессии просмотра строка, которая идентифицирует группу устройств, включающую источник для MediaStreamTrack. Это позволяет определить, какое значение было выбрано для соблюдения ваших заданных ограничений для значения этого свойства, как описано в свойстве MediaTrackConstraints.groupId, которое вы предоставили при вызове getUserMedia().

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

Поскольку RTP не содержит этой информации, треки, связанные с WebRTC RTCPeerConnection, никогда не будут содержать этого свойства.

Строка, значение которой — уникальный для сессии просмотра идентификатор группы устройств, включающей источник содержимого трека. Два устройства имеют один и тот же идентификатор группы, если они принадлежат одному и тому же физическому устройству. Например, гарнитура имеет два устройства: микрофон, который может служить источником для аудио-треков, и динамики, которые могут служить выходом для аудио.

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

Фактическое значение строки определяется источником трека, и нет гарантии, какой формы оно примет, хотя спецификация рекомендует использовать GUID.

Поскольку это свойство не стабильно в разных сессиях просмотра, его полезность при вызове getUserMedia() обычно ограничена обеспечением того, что задачи, выполняемые в одной сессии просмотра, используют устройства из одной группы (или что они не используют устройства из одной группы). Нет ситуации, в которой идентификатор группы полезен при вызове applyConstraints(), так как значение нельзя изменить.

См. пример Constraint exerciser.

• API для захвата медиа и потоков
• Возможности, ограничения и параметры
• MediaTrackSettings.deviceId
• MediaTrackConstraints.groupId
• MediaTrackSettings