Gamepad API

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.getGamepads() (en-US)
Uma extensão para o objeto Navigator que retorna um array  de objetos Gamepad (en-US), um para cada controlador conectado.

Window events

Window.ongamepadconnected (en-US)
Representa um controlador de evento que irá rodar quando o gamepad é conectado (quando o evento gamepadconnected (en-US) for disparado).
Window.ongamepaddisconnected (en-US)
Representa um controlador de evento que irá rodar quando o gamepad é desconectado (quando o evento gamepaddisconnected (en-US) 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

Veja também