MediaTrackSettings: свойство facingMode

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

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

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

Строка, значение которой является одной из строк в VideoFacingModeEnum.

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

"user"

Источник видео направлен к пользователю; это, например, фронтальная камера смартфона.

"environment"

Источник видео направлен от пользователя, тем самым показывая окружающую среду. Это задняя камера смартфона.

"left"

Источник видео направлен к пользователю, но влево, например, камера, нацеленная на пользователя, но за его левым плечом.

"right"

Источник видео направлен к пользователю, но вправо, например, камера, нацеленная на пользователя, но за его правым плечом.

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

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