許可權策略：遊戲手柄

實驗性： 這是一個 實驗性技術
在生產環境中使用之前，請仔細檢視 瀏覽器相容性表格。

HTTP Permissions-Policy 頭部 gamepad 指令控制當前文件是否允許使用 Gamepad API.

具體來說，在定義的策略阻止使用此功能的情況下，對 Navigator.getGamepads() 的呼叫將丟擲 SecurityError DOMException。此外，gamepadconnected 和 gamepaddisconnected 事件將不會觸發。

語法

http
Permissions-Policy: gamepad=<allowlist>;
<allowlist>

允許使用此功能的起源列表。有關更多詳細資訊，請參閱 Permissions-Policy > 語法。

預設策略

gamepad 的預設允許列表為 self。

示例

一般示例

SecureCorp Inc. 想要停用所有瀏覽上下文中的 Gamepad API，除了它自己的起源和起源為 https://example.com 的那些起源。它可以透過傳遞以下 HTTP 響應頭部來定義許可權策略，從而實現這一點。

http
Permissions-Policy: gamepad=(self "https://example.com")

使用 <iframe> 元素

FastCorp Inc. 想要為所有跨域子框架停用 gamepad，除了特定的 <iframe>。它可以透過傳遞以下 HTTP 響應頭部來定義許可權策略，從而實現這一點。

http
Permissions-Policy: gamepad=(self)

然後在 <iframe> 元素上包含一個 allow 屬性

html
<iframe src="https://other.com/game" allow="gamepad"></iframe>

iframe 屬性可以選擇性地在特定框架中啟用功能，而在其他框架中不啟用功能，即使這些框架包含來自相同起源的文件。

規範

規範
Gamepad
# permission-policy

瀏覽器相容性

BCD 表格僅在啟用 JavaScript 的瀏覽器中載入。

另請參閱