Permissions-Policy: chỉ thị gamepad
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Chỉ thị gamepad của header HTTP Permissions-Policy kiểm soát việc tài liệu hiện tại có được phép sử dụng Gamepad API hay không.
Cụ thể, khi một chính sách đã được xác định chặn việc sử dụng tính năng này, các lần gọi Navigator.getGamepads() sẽ ném SecurityError DOMException. Ngoài ra, các sự kiện gamepadconnected và gamepaddisconnected sẽ không được kích hoạt.
Cú pháp
Permissions-Policy: gamepad=<allowlist>;
<allowlist>-
Danh sách các nguồn gốc được cấp quyền sử dụng tính năng. Xem
Permissions-Policy> Cú pháp để biết thêm chi tiết.
Chính sách mặc định
Danh sách cho phép mặc định cho gamepad là *.
Ví dụ
Ví dụ chung
SecureCorp Inc. muốn tắt Gamepad API trong tất cả các ngữ cảnh duyệt web ngoại trừ nguồn gốc của chính nó và những nguồn gốc có origin là https://example.com.
Họ có thể làm điều đó bằng cách gửi header phản hồi HTTP sau để định nghĩa Permissions Policy:
Permissions-Policy: gamepad=(self "https://example.com")
Với phần tử <iframe>
FastCorp Inc. muốn tắt gamepad cho tất cả các frame con cross-origin, ngoại trừ một <iframe> cụ thể.
Họ có thể làm điều đó bằng cách gửi header phản hồi HTTP sau để định nghĩa Permissions Policy:
Permissions-Policy: gamepad=(self)
Sau đó bao gồm thuộc tính allow trên phần tử <iframe>:
<iframe src="https://other.com/game" allow="gamepad"></iframe>
Các thuộc tính iframe có thể bật tính năng có chọn lọc trong một số frame nhất định, và không bật trong các frame khác, ngay cả khi các frame đó chứa tài liệu từ cùng nguồn gốc.
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| Gamepad # permission-policy |