Gamepad
Baseline
Widely available
*
This feature is well established and works across many devices and browser versions. It’s been available across browsers since März 2017.
* Some parts of this feature may have varying levels of support.
Das Gamepad-Interface der Gamepad API definiert ein einzelnes Gamepad oder einen anderen Controller und ermöglicht den Zugriff auf Informationen wie Tastendrücke, Achsenpositionen und ID.
Ein Gamepad-Objekt kann auf zwei Arten zurückgegeben werden: über die gamepad-Eigenschaft der gamepadconnected und gamepaddisconnected-Events oder durch den Zugriff auf eine beliebige Position im Array, das von der Methode Navigator.getGamepads() zurückgegeben wird.
Hinweis: Die Unterstützung von Gamepad-Funktionen variiert je nach Kombination von Plattformen und Controllern. Selbst wenn der Controller eine bestimmte Funktion unterstützt (zum Beispiel haptisches Feedback), muss die Plattform diese Funktion für diesen Controller nicht unterstützen.
Instanz-Eigenschaften
Gamepad.axesSchreibgeschützt-
Ein Array, das die Steuerungen mit Achsen auf dem Gerät darstellt (z.B. analoge Daumensticks).
-
Ein Array von
gamepadButton-Objekten, die die auf dem Gerät vorhandenen Tasten darstellen. Gamepad.connectedSchreibgeschützt-
Ein boolescher Wert, der angibt, ob das Gamepad noch mit dem System verbunden ist.
Gamepad.displayIdSchreibgeschützt Veraltet Nicht standardisiert-
Gibt die
VRDisplay.displayIdeines zugehörigenVRDisplayzurück (falls relevant) — dasVRDisplay, dessen angezeigte Szene vom Gamepad gesteuert wird. Gamepad.handSchreibgeschützt Experimentell-
Ein Enum, das definiert, in welcher Hand der Controller gehalten wird oder höchstwahrscheinlich gehalten werden würde.
Gamepad.hapticActuatorsSchreibgeschützt Experimentell-
Ein Array, das
GamepadHapticActuator-Objekte enthält, die jeweils die auf dem Controller verfügbare haptische Hardware repräsentieren. Gamepad.vibrationActuatorSchreibgeschützt-
Ein
GamepadHapticActuator-Objekt, das die haptische Hardware auf dem Controller repräsentiert. Gamepad.idSchreibgeschützt-
Ein String, der Identifizierungsinformationen über den Controller enthält.
Gamepad.indexSchreibgeschützt-
Ein Integer, der automatisch inkrementiert wird, um für jedes derzeit mit dem System verbundene Gerät eindeutig zu sein.
Gamepad.mappingSchreibgeschützt-
Ein String, der angibt, ob der Browser die Steuerungen auf dem Gerät zu einem bekannten Layout umgemappt hat.
Gamepad.poseSchreibgeschützt Experimentell-
Ein
GamepadPose-Objekt, das die Informationen über die Pose eines WebVR-Controllers darstellt (z.B. seine Position und Ausrichtung im 3D-Raum). Gamepad.timestampSchreibgeschützt-
Ein
DOMHighResTimeStamp, der den letzten Zeitpunkt darstellt, zu dem die Daten für dieses Gamepad aktualisiert wurden.
Beispiel
window.addEventListener("gamepadconnected", (e) => {
console.log(
"Gamepad connected at index %d: %s. %d buttons, %d axes.",
e.gamepad.index,
e.gamepad.id,
e.gamepad.buttons.length,
e.gamepad.axes.length,
);
});
Spezifikationen
| Specification |
|---|
| Gamepad # gamepad-interface |
| Gamepad Extensions # partial-gamepad-interface |