MediaTrackConstraints: свойство facingMode

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

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

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

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

Значение exact в этом случае указывает на то, что указанный режим ориентации является строго необходимым; например:

const constraints = {
  facingMode: { exact: "user" },
};

Это указывает на то, что приемлемой является только передняя камера; если передней камеры нет или пользователь отказывается предоставить разрешение на её использование, запрос на медиаданные не будет выполнен.

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

"user"

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

"environment"

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

"left"

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

"right"

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

См. пример использования ограничений.

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