이 번역은 완료되지 않았습니다. 이 문서를 번역해 주세요.
This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
게임패드 API는 게임패드와 다른 게임 제어장치의 신호에 쉬운 일관된 방식으로 접근하고 응답하는 개발자들을 위한 수단이다. 게임패드 API는 세 가지 인터페이스와연결, 연결 해제되고 게임 패드 자체에 대한 다른 정보에 접근하고 어떤 버튼과 다른 조작 장치들이 현재 눌린 것에 응답하는 두 가지 이벤트 그리고 한 가지 특수 기능이 포함되어 있다.
인터페이스
Gamepad- 컴퓨터에 연결된 게임패드나 조작장치를 표현한다.
GamepadButton- 연결된 조작장치들 중 하나에 있는 버튼을 표현한다.
GamepadEvent- 게임 패드와 연관된 이벤트를 나타내는 이벤트 객체이다.
Experimental Gamepad extensions
GamepadHapticActuator- Represents hardware in the controller designed to provide haptic feedback to the user (if available), most commonly vibration hardware.
GamepadPose- Represents the pose of a controller (e.g. position and orientation in 3D space) in the case of a WebVR controller.
See also the extensions to the Gamepad interface, for features that allow you to access the above information.
Extensions to other interfaces
Navigator
Navigator.getGamepads()- An extension to the
Navigatorobject that returns an array ofGamepadobjects, one for each connected gamepad.
Window events
Window.ongamepadconnected- Represents an event handler that will run when a gamepad is connected (when the
gamepadconnectedevent fires). Window.ongamepaddisconnected- Represents an event handler that will run when a gamepad is disconnected (when the
gamepaddisconnectedevent fires).
Tutorials and guides
Specifications
| Specification | Status | Comment |
|---|---|---|
| Gamepad Extensions | Editor's Draft | Defines the Experimental Gamepad extensions. |
| Gamepad The definition of 'The Gamepad API specification' in that specification. |
Working Draft | Initial definition |
Browser compatibility
We're converting our compatibility data into a machine-readable JSON format.
This compatibility table still uses the old format,
because we haven't yet converted the data it contains.
Find out how you can help!
| Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari (WebKit) |
|---|---|---|---|---|---|---|
| General support | 21.0 webkit 35.0 |
(Yes) | 29.0 (29.0) | No support | 15.0 webkit 22.0 |
10.1 |
| Gamepad extensions | No support | No support | No support[1] | No support | No support | No support |
| Feature | Android | Edge | Firefox Mobile (Gecko) | IE Phone | Opera Mobile | Safari Mobile | Samsung Internet |
|---|---|---|---|---|---|---|---|
| General support | No support | (Yes) | 32.0 (32.0) | No support | No support | No support | Yes |
| Gamepad extensions | No support | No support | No support[1] | No support | No support | No support | No support |
[1] Enabled in Firefox Nightly and Beta, versions 55 and above. Enabled/disabled by the dom.gamepad-extensions.enabled pref.
See also
- The Gamepad API by Ted Mielczarek and Robert Nyman
- Simple API demo page (source)