MediaStreamTrack: phương thức getConstraints()
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.
Phương thức getConstraints() của
giao diện MediaStreamTrack trả về một
đối tượng MediaTrackConstraints chứa bộ ràng buộc được thiết lập
gần đây nhất cho track bằng một lần gọi
applyConstraints() trước đó. Các
ràng buộc này cho biết các giá trị và phạm vi giá trị mà trang web hoặc ứng dụng đã
chỉ định là bắt buộc hoặc chấp nhận được cho các thuộc tính có thể ràng buộc được bao gồm.
Các ràng buộc có thể được sử dụng để đảm bảo phương tiện đáp ứng các hướng dẫn nhất định mà bạn mong muốn. Ví dụ: bạn có thể muốn video độ phân giải cao nhưng yêu cầu tốc độ khung hình hơi thấp để giúp giữ tốc độ dữ liệu đủ thấp để không gây quá tải cho mạng. Các ràng buộc cũng có thể chỉ định kích thước lý tưởng và/hoặc chấp nhận được hoặc phạm vi kích thước. Xem Khả năng, ràng buộc và cài đặt để biết chi tiết về cách làm việc với các thuộc tính có thể ràng buộc.
Cú pháp
getConstraints()
Tham số
Không có.
Giá trị trả về
Một đối tượng MediaTrackConstraints cho biết các thuộc tính có thể ràng buộc
mà trang web hoặc ứng dụng đã đặt gần đây nhất bằng
applyConstraints(). Các thuộc tính
trong đối tượng trả về được liệt kê theo cùng thứ tự khi chúng được đặt, và chỉ
các thuộc tính được trang web hoặc ứng dụng đặt cụ thể mới được bao gồm.
Note:
Bộ ràng buộc trả về không nhất thiết mô tả
trạng thái thực tế của phương tiện. Ngay cả khi bất kỳ ràng buộc nào không thể được đáp ứng, chúng
vẫn được bao gồm trong đối tượng trả về như ban đầu được đặt bởi mã của trang web. Để lấy
các cài đặt hiện đang hoạt động cho tất cả các thuộc tính có thể ràng buộc, bạn nên
gọi getSettings().
Ví dụ
Ví dụ này lấy các ràng buộc hiện tại cho một track, đặt
facingMode, và áp dụng các ràng buộc đã cập nhật.
function switchCameras(track, camera) {
const constraints = track.getConstraints();
constraints.facingMode = camera;
track.applyConstraints(constraints);
}
Đặc tả kỹ thuật
| Specification |
|---|
| Media Capture and Streams # dom-mediastreamtrack-getconstraints |