HTML5小游戏在移动端调用震动API需用navigator.vibrate(),须用户手势触发、仅Android支持、iOS完全不支持,且需检查’vibrate’ in navigator && typeof navigator.vibrate === ‘function’。
震动 API 在 HTML5 小游戏中怎么调用
HTML5 游戏想在移动端加震动反馈,核心就是 navigator.vibrate()。它不是“播放震动”,而是向系统发起一个震动请求,实际是否执行、持续多久、强度如何,完全由设备操作系统和硬件决定。
最简调用方式:
if (navigator.vibrate) {
navigator.vibrate(150); // 持续震动 150ms
}
注意:navigator.vibrate 是一个函数,不是布尔值;但某些旧版 Android WebView(如 Android 4.4)会把它暴露为 undefined 或直接不支持,不能只靠 if (navigator.vibrate) 安全判断。
- 推荐先检查
'vibrate' in navigator,再确认类型是函数:typeof navigator.vibrate === 'function' - 震动时长超过 5000ms(5秒)会被浏览器截断,多数安卓设备还限制单次最长 1000ms
- iOS Safari 完全不支持该 API —— 这不是 bug,是 Apple 的明确策略,连
navigator.vibrate都不会定义
震动模式数组写法与常见失效原因
传入数组可实现多段震动(比如“滴滴”提示),例如:navigator.vibrate([200, 100, 200]) 表示震 200ms → 停 100ms → 震 200ms。但这个功能极易失效,尤其在非用户手势触发的上下文中。
关键限制:从 Chrome 57 / Android WebView 60 起,震动 API 必须由**用户主动触发的事件**(如 click、touchend)同步调用,否则静默失败(无报错,也不震动)。
立即学习“前端免费学习笔记(深入)”;