移动端把网页小游戏做顺只有四件事:用 Pointer Events 统一触摸、虚拟摇杆设 12px 死区并捕获指针、用 env() 避开刘海与home 指示条、在用户首次点击时调用 AudioContext.resume() 解锁音频。
一、输入层:用 Pointer Events,不要手写 touch + mouse 两套
移动端适配最容易走偏的一步,是先写一套 touchstart/touchmove 再补一套 mousedown/mousemove。MDN 的《Pointer Events》文档给出的理由很直接:鼠标、触控笔、触摸屏幕这些设备在标准里被抽象成同一种「指针」,PointerEvent 接口继承自 MouseEvent,一套 pointerdown/pointermove/pointerup 就能覆盖全部输入源,不需要为触屏另写一套分支。
对照 MDN 的触摸事件文档也能看清差别:触摸事件由 Touch、TouchEvent、TouchList 三个接口组成,touchstart 表示手指落下、touchmove 表示移动、touchend 表示抬起、touchcancel 表示被系统中断(比如触摸点过多)。它的独特优势是多点触控——文档明确写,鼠标事件不支持并发输入,而触摸事件支持多个同时落在不同位置的触点。游戏中「一根手指移动角色、另一根手指放技能」这类需求,只有触摸事件或 Pointer Events 能做。
要做多点触控,判断用哪一根手指要看事件里的三个列表:touches 是当前屏幕上所有触点,targetTouches 是仍然在目标元素上的触点,changedTouches 是本次事件中状态发生变化的触点。双指缩放就是靠比较两帧 touches 的距离得到的。
MDN 还给出了触摸事件的四条实操建议:尽量减少触摸处理函数里的计算量;把处理器挂到具体的目标元素上而不是整个 document;在 touchstart 里同时注册 touchmove、touchend、touchcancel;触摸目标元素要足够大,太小会让手指误触到相邻元素。这四条对摇杆按钮的设计直接有效——虚拟摇杆的「激活区」应当比可见的摇杆帽大一圈。
二、虚拟摇杆:死区、指针捕获与 touch-action
虚拟摇杆的常见翻车点有三个:手指按下后滑出摇杆范围导致「拖断了」、双击页面缩放、以及在滑动过程中页面跟着滚。三个问题分别对应三个 API。
死区:摇杆中心一定有一个不输出方向的小半径,业界常用 10–15px,本站在 Moto X3M、登山赛车 这类物理竞速上取 12px——太小手指会抖,太大则起步迟钝。
指针捕获:setPointerCapture(pointerId) 让这个指针后续的事件全部重定向到该元素,哪怕手指已经划出元素边界。MDN 的示例就是这么做的:pointerdown 时调用 setPointerCapture(e.pointerId),pointerup 时调用 releasePointerCapture(e.pointerId)。这样摇杆一次按下,整个拖拽过程都不会丢。
禁止浏览器手势:摇杆容器必须设 touch-action: none。MDN 的 touch-action 文档把取值列得很清楚——none 禁用浏览器对所有平移与缩放手势的处理;manipulation 允许平移与捏合缩放但禁用双击缩放,它是 pan-x pan-y pinch-zoom 的别名,而禁用双击缩放正好免掉了浏览器为了判定双击而延迟派发 click 的开销。对小游戏来说,touch-action: none 是常态。
还有一个容易忽略的坑:被动监听器。MDN 的 addEventListener 文档写明,passive 选项若未指定默认为 false——但 wheel、mousewheel、touchstart、touchmove 在 Window、Document、documentElement、body 上默认就是 true。也就是说在这些元素上写 touchmove 再调用 preventDefault() 不会有任何效果,浏览器只会在控制台打一条警告。所以自定义摇杆的监听必须挂在具体元素上,并且显式写 { passive: false }。
三、安全区与视口:env() + viewport-fit=cover + dvh
刘海屏、灵动岛、底部 home 指示条会吃掉游戏画面的边角。MDN 的 env() 文档给出了四个动态变量:safe-area-inset-top、safe-area-inset-right、safe-area-inset-bottom、safe-area-inset-left,它们标出「在不被非矩形显示区域切掉的前提下可以安全放内容的距离」。文档说明:当视口是矩形且没有被工具栏或动态键盘占据时,这四个值都是 0;否则是大于 0 的 px 值。
要点有两个。第一,env() 支持 fallback 写法:env(safe-area-inset-bottom, 1em),这样在不支持的浏览器里不会塌成 0。第二,只写 env() 不够,<meta name="viewport"> 必须带 viewport-fit=cover,否则安全区变量一直是 0。MDN 的 viewport 文档说明 viewport-fit 可取 auto、contain、cover 三值,cover 会把视口缩放到铺满整个屏幕,并明确建议配合安全区 inset 变量使用以免重要内容跑到显示区域之外。
同一份文档还有两条硬约束值得记住:user-scalable=no 会阻止视力不佳的用户放大页面,WCAG 要求至少支持 2 倍缩放、推荐做到 5 倍;interactive-widget 可取 resizes-visual(默认)、resizes-content、overlays-content,决定软键盘弹出时视口怎么变。
软键盘还有一个更底层的影响:MDN 的 VisualViewport API 文档指出移动端 Web 有布局视口和视觉视口两个概念,屏幕软键盘(OSK)会缩小视觉视口而不影响布局视口,visualViewport.height 与 scale 用来读当前可见区域大小。所以在移动端算「可视高度」不要用 innerHeight,要用 window.visualViewport.height,并监听它的 resize 事件。
至于高分屏:MDN 的 devicePixelRatio 文档说明它返回物理像素与 CSS 像素之比,值为 1 表示经典 96 DPI 屏幕,值为 2 对应 HiDPI/Retina,现代手机屏幕通常大于 2。Canvas 要做高清适配就按它缩放后端缓冲区:CSS 尺寸保持 200px,canvas.width = Math.floor(200 * scale),再 ctx.scale(scale, scale) 把坐标系归一到 CSS 像素。
四、iOS 音频解锁:AudioContext 的 suspended 与 resume()
「手机上点开始游戏没有声音」是移动端最高频的问题。它的根因是浏览器的自动播放策略:Chrome 官方博客写明,Chrome 66 起对音视频元素实施自动播放策略,Chrome 71 起 Web Audio API 也被纳入。WebKit 的官方博客也讲得直白:网站应当假设任何 <video>/<audio> 的播放都需要用户手势点击来触发,并且要检测自动播放是否被拒绝。
规则本身在 MDN 的自动播放指南里写得很清楚:媒体允许自动播放的一般条件是「音频静音或音量为 0」「用户已经与站点交互过(点击、触摸、按键)」「站点被加入白名单」「用 autoplay Permissions Policy 显式授予 iframe 权限」。MDN 同时提醒:任何带音轨的媒体,如果在标签页还没有任何用户交互就被程序化触发播放,通常会被拦截。
在 Web Audio 上,具体的解锁机制是 AudioContext 的状态机。MDN 的 AudioContext 文档列出 suspend()、resume()、close() 三个状态控制方法;resume() 页面标注该特性自 2021 年 4 月起在各浏览器广泛可用。Chrome 博客给出了完整的时序:如果 AudioContext 在文档收到用户手势之前就被创建,它会以 suspended 状态创建,必须在用户手势之后调用 resume();另一种做法是干脆延迟创建——在按钮的 click 回调里才 new AudioContext()。文档还给了检测办法:创建后检查 AudioContext.state,能播就立刻是 running,否则是 suspended,也可以监听 statechange 事件异步感知。
一条可复制的写法是「首次交互即解锁」:
let ctx = null;
function unlock() {
if (!ctx) ctx = new (window.AudioContext || window.webkitAudioContext)();
if (ctx.state === "suspended") ctx.resume();
}
document.addEventListener("pointerdown", unlock, { once: true });
对 <audio> 元素则是处理 play() 返回的 Promise。MDN 的 HTMLMediaElement.play() 文档写明该方法返回一个 Promise,播放启动时 resolve、无法启动时 reject,常见错误是 NotAllowedError(浏览器或操作系统不允许在当前上下文播放,例如要求用户显式点击)。WebKit 博客给出的检测代码正是 catch 这个 Promise 并在界面上显示「手动开始播放」的按钮。
想知道当前策略到底是哪一种,MDN 的 navigator.getAutoplayPolicy() 文档提供了标准接口:传入 "mediaelement" 或 "audiocontext" 拿整体策略,传入具体元素或 AudioContext 拿单项策略,返回值是 allowed、allowed-muted 或 disallowed 三个字符串之一。
五、横屏与全屏:先认清浏览器的限制
横屏小游戏常被要求「锁定横屏」。MDN 的 ScreenOrientation.lock() 文档说得很实际:方向锁定通常只在移动设备、且浏览器处于全屏状态时才生效,而且该特性被标注为「Limited availability,不是 Baseline」。所以正确做法不是依赖 lock(),而是:进入全屏 → 用 @media (orientation: landscape)(MDN 的媒体查询文档列出的媒体特性里包含 orientation、any-pointer、pointer、hover、prefers-reduced-motion 等)切换布局 → 提供手动「旋转手机」提示。
进全屏同样有前置条件。MDN 的 Fullscreen API 指南写明,requestFullscreen() 需要瞬态用户激活(Transient user activation),必须在事件处理器里调用;请求失败时元素会收到 fullscreenerror 事件,而且「并非所有内容都能全屏」——比如某些窗口化插件、跨域 iframe 需要 allowfullscreen 属性。
手柄也是一个被低估的补充输入源。MDN 的 Gamepad API 文档列出了 Navigator.getGamepads() 以及 gamepadconnected/gamepaddisconnected 两个事件;它的实操指南特别提醒:要用 gamepad.index 作为稳定键,每帧调用 Navigator.getGamepads() 读取最新状态——事件对象里的数据是连接瞬间的快照,不是实时值。