MediaTrackConstraints: deviceId 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 deviceId 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 deviceId.
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.deviceId 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 ID thiết bị có thể chấp nhận, lý tưởng và/hoặc chính xác (bắt buộc) là các nguồn nội dung phương tiện có thể chấp nhận.
ID thiết bị là duy nhất cho một nguồn gốc nhất định và được đảm bảo là như nhau qua các phiên duyệt web trên cùng một nguồn gốc. Tuy nhiên, giá trị của deviceId được xác định bởi nguồn nội dung của rãnh, và không có định dạng cụ thể nào được bắt buộc bởi thông số kỹ thuật (mặc dù một loại GUID nào đó được khuyến nghị). Điều đó có nghĩa là một rãnh nhất định sẽ chỉ trả về một giá trị cho deviceId khi bạn gọi getCapabilities().
Vì điều này, không có trường hợp nào sử dụng ID thiết bị khi gọi MediaStreamTrack.applyConstraints(), vì chỉ có một giá trị có thể; tuy nhiên, bạn có thể ghi lại deviceId và sử dụng nó để đảm bảo bạn nhận được cùng nguồn cho nhiều lần gọi getUserMedia().
Note: Ngoại lệ cho quy tắc ID thiết bị là như nhau trong các phiên duyệt web: chế độ duyệt riêng tư sẽ sử dụng ID khác và thay đổi nó trong mỗi phiên duyệt web.
Ví dụ
Xem ví dụ Trình thử nghiệm ràng buộc.
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| Media Capture and Streams # dom-mediatrackconstraintset-deviceid |