给你的网页游戏添加游戏手柄支持

自从买了 Switch 手柄后一直想试试给自己写的小游戏增加手柄支持。今天终于抽出时间搞了一把。以下是笔记 ;)

navigator.getGamepads

HTML5 中获取游戏手柄的 API 是 navigator.getGamepads()。navigator.getGamepads 会返回一个可能包含 null 的数组。标准规定，对于同一个游戏手柄会在同一个下标中返回，不同的手柄必须不能使用其他手柄用过的下标——即便前者已经中断连接。如果没有检测到任何游戏手柄，实测在 Firefox 中会返回一个空数组，而在 Chrome、Safari 中会返回 [null, null, null, null]。

当浏览器检测到手柄后，navigator.getGamepads 就会返回包含该手柄对象的数组，每一个手柄对象都是 Gamepad 类型

实测笔者的 NS Pro 手柄在 Chrome、Safari 浏览器上有兼容性问题（不能识别左摇杆），所以下面测试均以 Firefox 为准（Edge 也正常）。同事表示他的 PS4 手柄没有问题。

Gamepad 类

Gamepad 类包含重要的属性，这里只介绍最重要的几个：

1. id。字符串，包含了手柄驱动的名称信息。比如笔者的 NS Pro 返回的是 57e-2009-Pro Controller，可以用此字符串识别用户的手柄提供默认的按键映射。
2. connected。表示该 Gamepad 对象所表示的手柄是否还保持连接。
3. timestamp。手柄对象的最后更新时间。实测笔者虽然没有动手柄，这个值仍然在不断增长（可能是摇杆的数值在微小变化的缘故），用处不是很大。
4. mapping。表示浏览器是否可以识别手柄的布局。当前浏览器只能识别 类似 PS4 手柄的标准布局。如果能识别，返回 standard，否则返回空字符串（笔者的 NS Pro 识别不了）。
5. axes。这个值表示手柄的摇杆的轴（一个摇杆有X、Y两个轴）。其所有值都在 -1~1 之间。HTML使用向右、向下的坐标系，所以正值表示右或上，负值表示左或下。标准规定，同一个摇杆的X、Y方向值必须相邻，且先X后Y。标准同时建议，如果有多个摇杆同时存在，主摇杆应该排在前面。所以如果有有左右两个摇杆，axes 返回的数组值应该表示：[左摇杆的X轴偏向, 左摇杆的Y轴偏向, 右摇杆的X轴偏向, 右摇杆的Y轴偏向]
6. buttons。这个值是一个 GamepadButton 对象数组。标准建议数组的顺序应该按照主要按键优先排列。实测对于我的 NS Pro 手柄来说顺序是 [B, A, Y, X, L, R ...]，而方向键排在最后四个。建议实际应用中给用户提供专门的界面映射按键。

GamepadButton 类

每一个 GamepadButton 实例表示手柄上的一个按键（包括方向键），它包含三个属性（MDN 上只写了两个，实际按照标准返回了全部三个）：

1. pressed。布尔值，表示当前按键是否被按下。
2. value。表示按键的深度（完全按下还是按到一半），值为 0~1 之间。大多数按键不支持压力感应，会直接返回0或1
3. touched。如果手柄支持触摸，该值可表示当前按键被触摸但是没有按下的状态。如果不支持触摸，该值和 pressed 一致。

连接事件

浏览器提供了两个手柄相关的事件。

1. gamepadconnected。当浏览器检测到手柄连接时触发。回调函数的事件参数中包含 gamepad 属性，用户获得新连接的手柄对象
2. gampaddisconnected。当浏览器检测到手柄失去连接时触发。

可以看到手柄没有类似键盘鼠标那样的 keydown、keyup 等事件，如需获取手柄的按键状态，需要在 raf 循环中使用 navigator.getGamepads 实时获取。

完

笔者给自己的贪食蛇小游戏增加了手柄摇杆控制蛇头方向功能：https://github.com/CarterLi/S...

之前笔者还写过俄罗斯方块之类的，代码找不到了/(ㄒoㄒ)/~~