XRInputSource: gamepad プロパティ
読み取り専用の XRInputSource
の gamepad
プロパティは、 XR 入力ソースがゲームパッドまたは同等の機器である場合、ボタンと軸の状態を記述した Gamepad
オブジェクトを返します。機器がゲームパッドのようなものでない場合、このプロパティの値は null
です。
返される Gamepad
インスタンスはゲームパッド API で説明されているとおりに動作します。ただし、いくつか注意すべきことがあります。
XRInputSource
に属するGamepad
インスタンスはnavigator.getGamepads()
が返す配列には含まれません。ゲームパッドは厳密に WebXR ハードウェアに関連付けられるものであり、汎用のゲーム機器ではありません。Gamepad.id
は空文字列 (""
) です。Gamepad.index
は-1
です。Gamepad.connected
はXRInputSource
がアクティブな XR 入力ソースのリストから除去されるか、XRSession
が終わるまではtrue
です。Gamepad.axes
で報告される軸がタッチパッドの軸を表す場合、関連するGamepadButton.touched
プロパティがfalse
のとき、値は 0 になります。Gamepad.mapping
は "xr-standard" を返します。
例
gamepad 入力ソースの使用
js
for (const source of frame.session.inputSources) {
const gamepad = source.gamepad;
if (gamepad) {
if (gamepad.buttons[2].pressed) {
// 何かする
}
}
}
仕様書
Specification |
---|
WebXR Gamepads Module - Level 1 # dom-xrinputsource-gamepad |
ブラウザーの互換性
BCD tables only load in the browser