WebXR Device API
The read-only XRInputSource property gamepad returns a Gamepad object describing the state of the buttons and axes on the XR input source, if it is a gamepad or comparable device. If the device isn't a gamepad-like device, this property's value is null.
The Gamepad instance returned behaves as described by the Gamepad API. However, there are a few things to note:
Gamepadinstances belonging toXRInputSourceare not included in the array returned by navigator.getGamepads(). Gamepads are strictly associated with the WebXR hardware and are not general-purpose gaming devices.- Gamepad.id is an empty string (
"") - Gamepad.index is
-1 - Gamepad.connected is
trueuntil theXRInputSourceis removed from the list of active XR input sources or the XRSession is ended. - If an axis reported by Gamepad.axes represents an axis of a touchpad, the value is 0 when the associated GamepadButton.touched property is
false. - Gamepad.mapping returns "xr-standard".
Examples
Using a gamepad input source
for (const source of frame.session.inputSources) {
const gamepad = source.gamepad;
if (gamepad) {
if (gamepad.buttons[2].pressed) {
// do something
}
}
}
Specifications
Browser compatibility
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
