Gamepad API
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.
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.
-
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
-
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
Specification |
---|
Gamepad # gamepad-interface |
Gamepad Extensions # partial-gamepad-interface |
Compatibilidade com navegadores
BCD tables only load in the browser
Veja também
- The Gamepad API por Ted Mielczarek and Robert Nyman
- Simple API demo page (source)