DeviceOrientationEvent: requestPermission() static method
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Phương thức tĩnh requestPermission() của giao diện DeviceOrientationEvent yêu cầu quyền của người dùng để truy cập dữ liệu hướng thiết bị từ cảm biến gia tốc kế và con quay hồi chuyển. Nó cũng có thể yêu cầu quyền truy cập dữ liệu từ tính kế khi cần hướng tuyệt đối. Phương thức này yêu cầu transient activation, nghĩa là nó phải được kích hoạt bởi một sự kiện UI như nhấn nút.
Cú pháp
DeviceOrientationEvent.requestPermission()
DeviceOrientationEvent.requestPermission(absolute)
Tham số
absoluteOptional-
Giá trị boolean cho biết có cần dữ liệu hướng tuyệt đối hay không. Khi là
true, yêu cầu quyền cũng bao gồm cảm biến từ tính kế. Mặc định làfalse.
Giá trị trả về
Một Promise giải quyết với một chuỗi là "granted" hoặc "denied".
Ngoại lệ
Promise trả về sẽ bị từ chối với các ngoại lệ sau:
NotAllowedErrorDOMException-
Trạng thái quyền là
"prompt"và hàm gọi không có transient activation.
Bảo mật
Yêu cầu kích hoạt người dùng tạm thời. Người dùng phải tương tác với trang hoặc phần tử UI để tính năng này hoạt động.
Ví dụ
Yêu cầu quyền hướng thiết bị khi nhấn chuột
document.querySelector("button").addEventListener("click", async () => {
if (typeof DeviceOrientationEvent.requestPermission !== "function") {
// The feature is not available, or does not need permission.
return;
}
const permission = await DeviceOrientationEvent.requestPermission();
if (permission === "granted") {
window.addEventListener("deviceorientation", (event) => {
console.log(`Alpha: ${event.alpha}`);
console.log(`Beta: ${event.beta}`);
console.log(`Gamma: ${event.gamma}`);
});
}
});
Yêu cầu quyền hướng tuyệt đối
Khi cần dữ liệu hướng tuyệt đối (ví dụ: cho các ứng dụng dựa trên la bàn), truyền true làm tham số absolute. Điều này bổ sung thêm yêu cầu truy cập từ tính kế.
document.querySelector("button").addEventListener("click", async () => {
if (typeof DeviceOrientationEvent.requestPermission !== "function") {
return;
}
const permission = await DeviceOrientationEvent.requestPermission(true);
if (permission === "granted") {
window.addEventListener("deviceorientationabsolute", (event) => {
console.log(`Absolute alpha: ${event.alpha}`);
});
}
});
Thông số kỹ thuật
| Specification |
|---|
| Device Orientation and Motion # dom-deviceorientationevent-requestpermission |