A Gamepad API é uma maneira dos desenvolvedores acessarem e responderem à sinais oriundos de gamepads e outros controladores de games de forma simples e consistente. A API contém três interfaces, dois eventos e uma função especialista, para responder aos gamepads sendo conectados e desconectados, e acessar outras informações sobre o próprio gamepad, e quais botões e outros controles estão sendo de fato passados.
Interfaces
Gamepad
- Representa o gamepad/controlador conectado ao computador.
GamepadButton
- Representa um botão num dos controles conectados.
GamepadEvent
- O objeto de evento representando eventos disparados que são relacionados ao gamepad.
Experimental Gamepad extensions
GamepadHapticActuator
- Representa o hardware no controlador designado à prover feedbacks táteis ao usuário (Se disponível), mais comumente um hardware de vibração.
GamepadPose
- Representa a "localização" de um controle (ex. posição e orientação no espaço 3D) no caso de um controlador WebVR.
Veja também as extensões para a interface de Gamepad, para funcionalidades que permitem você acessar as informações acima.
Extensions to other interfaces
Navigator
Navigator.getGamepads()
- Uma extensão para o objeto
Navigator
que retorna um array de objetosGamepad
, um para cada controlador conectado.
Window events
Window.ongamepadconnected
- Representa um controlador de evento que irá rodar quando o gamepad é conectado (quando o evento
gamepadconnected
for disparado). Window.ongamepaddisconnected
- Representa um controlador de evento que irá rodar quando o gamepad é desconectado (quando o evento
gamepaddisconnected
for disparado).
Guias e tutorias
Especificações
Especificações | Estatus | Comentários |
---|---|---|
Gamepad Extensions | Rascunho editorial | Defines the Experimental Gamepad extensions. |
Gamepad The definition of 'The Gamepad API specification' in that specification. |
Rascunho atual | Initial definition |
Compatibilidade de navegadores
BCD tables only load in the browser
A tabela de compatibilidade nesta página é gerada de um dado estruturado. Se você gostaria de contribuir com os dados, por favor, verifique https://github.com/mdn/browser-compat-data e nos envie um "pull request"
Veja também
- The Gamepad API por Ted Mielczarek and Robert Nyman
- Simple API demo page (source)