跳到主要内容
中文系列课

GamepadConnected

首次检测到游戏手柄设备时的完整状态（gamepadConnected）。当 mapping 为 'standard' 时，字段与 W3C 标准 Gamepad 对齐。

（即将推出）

字段（Fields）​

deviceId​

嵌入方稳定提供的设备 ID，用于标识这次逻辑游戏手柄会话。

buttonMask​

当 W3C 标准按钮索引 i 被按下时，位 i 会被置为 1。

buttons​

每个按钮的模拟值（0–1），顺序与 W3C buttons[] / buttonValues 相同（从 1 开始）。

axes​

模拟轴值（从 1 开始）。标准布局至少包含六个条目（摇杆和扳机）。

isStandardMapping​

表示嵌入方是否已将输入规范化为标准布局。

mapping​

'standard' 或 'unknown'。只有标准布局下语义名称才匹配。

gamepadMapping​

原始枚举值：0 = standard，1 = unknown，顺序与 GamepadMappingKind 相同。

west​

面按钮（仅标准映射时有效；否则为 false）。

south​

north​

east​

leftShoulder​

rightShoulder​

back​

Select / Start（W3C 中的 back / forward）。

forward​

leftStickButton​

摇杆按下按钮。

rightStickButton​

dpadUp​

dpadDown​

dpadLeft​

dpadRight​

start​

leftStick​

左右模拟摇杆偏移（标准布局下为 axes 0–3）。

rightStick​

leftTrigger​

模拟肩键扳机（标准布局下为 axes 4–5）。

rightTrigger​

leftTriggerPressed​

数字扳机按钮（标准布局下为索引 6–7）。

rightTriggerPressed​

方法（Methods）​

buttonPressed​

buttonPressed(index: number) -> boolean

如果 W3C 按钮索引 index 被按下，则返回 true（从 1 开始，与 buttons / 位掩码一致）。

buttonValue​

buttonValue(index: number) -> number

返回指定 1-based 按钮索引对应的 GamepadButton.value。

axis​

axis(index: number) -> number

返回指定 1-based 轴索引的轴值。