Gamepad API

Baseline 廣泛可用 *

此特性已得到良好確立，可跨多種裝置和瀏覽器版本使用。自 2017 年 3 月起，所有瀏覽器均支援此特性。

* 此特性的某些部分可能存在不同級別的支援。

安全上下文： 此功能僅在安全上下文（HTTPS）中可用，且支援此功能的瀏覽器數量有限。

Gamepad API 是一種允許開發者以簡單、一致的方式訪問和響應遊戲手柄及其他遊戲控制器訊號的方式。它包含三個介面、兩個事件和一個專用函式，用於響應遊戲手柄的連線和斷開，以及訪問有關遊戲手柄本身以及當前按下的按鈕和其他控制元件的資訊。

介面

Gamepad: 表示連線到計算機的遊戲手柄/控制器。
GamepadButton: 表示連線的控制器上的一個按鈕。
GamepadEvent: 代表與遊戲手柄相關的事件的事件物件。

實驗性的 Gamepad 擴充套件

GamepadHapticActuator: 表示控制器中為使用者提供觸覺反饋（如果可用）的硬體，最常見的是振動硬體。
GamepadPose: 表示控制器在 3D 空間中的姿態（例如位置和方向），適用於 WebVR 控制器。較新的 WebXR 標準不使用此功能。

其他介面的擴充套件

Navigator

Navigator.getGamepads(): 對 Navigator 物件的擴充套件，該物件返回一個 Gamepad 物件陣列，每個連線的遊戲手柄對應一個物件。

視窗事件

gamepadconnected: 當遊戲手柄連線時會觸發的事件。
gamepaddisconnected: 當遊戲手柄斷開連線時會觸發的事件。

教程和指南

規範

規範
Gamepad # gamepad-interface
Gamepad 擴充套件 # partial-gamepad-interface

瀏覽器相容性

另見

The Gamepad API by Ted Mielczarek and Robert Nyman
Simple API demo page (source)

幫助改進 MDN

瞭解如何貢獻

此頁面最後修改於 2025年4月3日，作者為 MDN 貢獻者。

在 GitHub 上檢視此頁面 • 報告此內容的筆誤