需先通过用户手势调用 DeviceMotionEvent.requestPermission() 获取权限,再监听 devicemotion 事件,计算加速度模值并检测其短时剧烈变化(静止→跃升→回落→静止)以准确识别摇晃,避免单轴误判。
HTML5 本身没有“摇一摇”这个功能,但可以通过 DeviceMotionEvent 监听设备加速度变化,再结合算法判断是否构成一次有效摇晃。关键不是监听“摇”,而是识别加速度模值的短时剧烈变化。
常见错误是直接监听 acceleration.x 单轴突变——这会导致误触(比如快速抬手、走路颠簸都可能触发)。真正稳定的做法是计算三维加速度的合模:Math.sqrt(x*x + y*y + z*z),再检测它是否在短时间内(如 300ms 内)从静止状态跃升又回落。
requestPermission()(iOS 13+ / Safari 14.1+ 强制要求)window.addEventListener('devicemotion', ...)
setTimeout 或时间戳控制处理频率,否则高频事件会卡顿在 iOS 上,DeviceMotionEvent 默认被禁用,不显式申请就会静默失败——连 console.log 都不会触发。而且 requestPermission() 只能在用户手势回调中调用,不能放在 DOMContentLoaded 里。
正确写法示例:
立即学习“前端免费学习笔记(深入)”;
document.body.addEventListener('click', async () => { if (typeof DeviceMotionEvent.requestPermission === 'function') { try { const permission = await DeviceMotionEvent.requestPermission(); if (permission === 'granted') { window.addEventListener('devicemotion', handleShake); } } catch (e) { console.warn('摇晃权限被拒绝', e); } }});
注意:requestPermission() 是一次性操作,拒绝后再次调用不会弹窗;用户需手动去系统设置开启“运动与健身”权限(iOS)或“身体传感器”(部分 Android)。
单纯看加速度峰值容易把走路、点击桌面甚至翻转手机当成摇晃。核心是识别“瞬态冲击”:一段静止 → 短时剧烈变化 → 快速回落 → 回到静止。
20,单位 m/s²)且与上次静止状态间隔 5 以下并维持 100ms,才认定为一次有效摇晃阈值不是固定值:低端安卓机传感器噪声大,建议初始设 15;iPhone 可设 22。上线后最好支持动态调整或用户自定义。
老版 Android(DeviceMotionEvent;部分 Android WebView 会返回全零加速度。别假设它一定可用。
'ondevicemotion' in window 或 typeof DeviceMotionEvent !== 'undefined' 做基础检测event.acceleration 全为 null,就视为不可用实际项目里最容易被忽略的是权限请求时机和静默失败的兜底。很多团队测 iOS 时只在 Safari 里点一下就过了,结果上架后发现微信/钉钉容器里完全不工作——因为它们根本不暴露 requestPermission 方法,也无权弹窗。