IOUXI 首页 › 博客 › 移动端适配:触摸、虚拟摇杆、安全区与 iOS 音频解锁

移动端适配:触摸、虚拟摇杆、安全区与 iOS 音频解锁

发布于 2026-11-19 · 更新于 2026-11-19 · 16 分钟阅读 · IOUXI 编辑部

移动端把网页小游戏做顺只有四件事:用 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() 读取最新状态——事件对象里的数据是连接瞬间的快照,不是实时值。

常见问题

Pointer Events 和 Touch Events 到底该用哪个?
新项目直接用 Pointer Events,一套 pointerdown/pointermove/pointerup 同时覆盖鼠标、触屏与触控笔。Touch Events 的独特价值是多点触控信息更完整(touches、targetTouches、changedTouches 三个列表),做双指缩放或双摇杆时可以直接读;但要注意移动端浏览器的触摸事件支持广泛、桌面端支持滞后,且需要自己处理与鼠标事件的兼容,而 Pointer Events 已经把这层抽象做好了。
为什么我调了 preventDefault() 没反应,控制台还有警告?
因为你挂在了 touchstart/touchmove 上,而 MDN 的 addEventListener 文档写明:这两个事件在 Window、Document、documentElement、body 上的 passive 选项默认为 true。被动监听器调用 preventDefault() 不会生效并会打警告。解决办法是把监听器挂到具体的摇杆元素上,并显式传 { passive: false }。
摇杆拖到边缘就失灵了,怎么修?
用指针捕获。在 pointerdown 时调用 el.setPointerCapture(e.pointerId),让后续指针事件全部重定向到这个元素,抬手时调用 releasePointerCapture(e.pointerId) 释放。同时给摇杆容器设 touch-action: none,并给一个 10–15px 的死区(本站在物理竞速类游戏上取 12px),避免手指轻微抖动就输出方向。
iOS 上点了「开始游戏」没声音,代码里也没有报错?
这是自动播放策略,不是 bug。Chrome 官方博客写明 Chrome 71 起 Web Audio API 也纳入自动播放策略;MDN 的自动播放指南指出带音轨媒体在没有用户交互的标签页里播放通常会被拦截。正确做法是在首次 pointerdown/click 时调用 AudioContext.resume()(MDN 标注该特性自 2021 年 4 月起广泛可用),或把 new AudioContext() 直接放进按钮回调里延迟创建,并用 ctx.state 或 navigator.getAutoplayPolicy("audiocontext") 确认状态。
为什么我调了 screen.orientation.lock("landscape") 没反应?
MDN 的 ScreenOrientation.lock() 文档说明方向锁定通常只在移动设备、且浏览器处于全屏状态时生效,该特性还标注为 Limited availability、非 Baseline。稳妥方案是:点击按钮时先 requestFullscreen()(它需要瞬态用户激活,必须在事件处理器中调用),再用 @media (orientation: landscape) 切换横屏布局,并在竖屏时给出「请旋转设备」的提示,而不是依赖 API 去强制锁定。

文中提到的游戏

相关阅读

手机玩网页小游戏:横屏、触屏、性能与省流指南手机玩网页小游戏实战指南:viewport 横屏全屏、Pointer Events 触屏、dvh 与安全区、deviceMemory 低配降级、Save-Data 省流,附 Core Web Vitals 指标与可运行代码。把「跳一下」做爽的 8 个参数:加速度 / 土狼时间 / 输入缓冲网页小游戏跳跃手感的 8 个可调参数:起跳速度与重力、水平加速度、土狼时间、输入缓冲、可变跳高、命中停顿、60Hz 固定步长、输入轮询,每项都给出可验证的数值与出处。Canvas 2D 性能札记:rAF、离屏渲染与脏矩形网页小游戏 Canvas 2D 性能优化实操:用 requestAnimationFrame 驱动主循环、离屏画布预渲染、分层画布与脏矩形重绘,把掉帧的弹球游戏拉回 60fps。小包体策略:首屏 ≤300KB 的资源管线Web 小游戏首屏包体优化实操:按 web.dev 性能预算把首屏控制在 300KB 内,用 gzip/br 压缩、代码分割、响应式图片与缓存策略落地资源管线。从 0 到上线:独立开发者最小可用流程与时间预算独立网页小游戏从 0 到上线的最小可用流程:四个阶段、12–15 个工作日预算,含 LCP 2.5 秒、PWA 192/512 图标、localStorage 10 MiB 等硬阈值。游戏页怎么读:规则 / 技巧 / 亮点 / FAQ 四段结构学会 IOUXI 游戏页四段结构读法:30 秒读懂规则、技巧、亮点与 FAQ。基于尼尔森「79% 用户只扫描不精读」的研究,帮你快速判断一款小游戏值不值得玩。20 个小游戏使用技巧(含搜索与省流设置)掌握 IOUXI 搜索、浏览器省流、移动端触控、键盘快捷键、硬件加速等 20 个实用技巧,降低流量消耗、减少操作延迟、找到隐藏游戏。

事实来源

返回栏目首页 · 博客