MediaTrackConstraints: facingMode property
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.
Thuộc tính facingMode của từ điển MediaTrackConstraints là ConstrainDOMString mô tả các ràng buộc được yêu cầu hoặc bắt buộc đặt lên giá trị của thuộc tính có thể ràng buộc facingMode.
Nếu cần, bạn có thể xác định xem ràng buộc này có được hỗ trợ hay không bằng cách kiểm tra giá trị của MediaTrackSupportedConstraints.facingMode như được trả về bởi lệnh gọi MediaDevices.getSupportedConstraints(). Tuy nhiên, thông thường điều này là không cần thiết vì các trình duyệt sẽ bỏ qua mọi ràng buộc mà chúng không quen.
Vì RTP không bao gồm thông tin này, các rãnh liên kết với WebRTC RTCPeerConnection sẽ không bao giờ bao gồm thuộc tính này.
Giá trị
Đối tượng dựa trên ConstrainDOMString chỉ định một hoặc nhiều chế độ hướng có thể chấp nhận, lý tưởng và/hoặc chính xác (bắt buộc) cho một rãnh video.
Giá trị exact trong trường hợp này chỉ ra rằng chế độ hướng được chỉ định là bắt buộc cụ thể; ví dụ:
const constraints = {
facingMode: { exact: "user" },
};
Điều này chỉ ra rằng chỉ chấp nhận camera hướng về phía người dùng; nếu không có camera nào hướng về phía người dùng, hoặc người dùng từ chối quyền sử dụng camera đó, yêu cầu phương tiện sẽ thất bại.
Các chuỗi sau là các giá trị được phép cho chế độ hướng. Chúng có thể đại diện cho các camera riêng biệt, hoặc chúng có thể đại diện cho các hướng mà camera có thể điều chỉnh được.
"user"-
Nguồn video hướng về phía người dùng; ví dụ như camera mặt trước trên điện thoại thông minh.
"environment"-
Nguồn video hướng ra xa người dùng, do đó xem môi trường của họ. Đây là camera mặt sau trên điện thoại thông minh.
"left"-
Nguồn video hướng về phía người dùng nhưng về phía bên trái của họ, chẳng hạn như camera hướng về phía người dùng nhưng qua vai trái của họ.
"right"-
Nguồn video hướng về phía người dùng nhưng về phía bên phải của họ, chẳng hạn như camera hướng về phía người dùng nhưng qua vai phải của họ.
Ví dụ
Xem ví dụ Trình thử nghiệm ràng buộc.
Thông số kỹ thuật
| Specification |
|---|
| Media Capture and Streams # dom-mediatrackconstraintset-facingmode |