DeviceOrientation API 提供欧拉角(α/β/γ),适用于罗盘等场景;DeviceMotion API 的 rotationRate 提供高频率原始陀螺仪角速度(°/s),适合游戏等精细追踪,均需用户交互触发并处理权限、兼容性及滤波降噪。

javaScript 通过 DeviceOrientation API 和 DeviceMotion API 获取设备方向与运动数据,其中陀螺仪(角速度)信息主要由 deviceorientation 事件提供,而更底层、高频率的原始陀螺仪数据则需使用 devicemotion 事件中的 rotationRate 字段。
监听 deviceorientation 事件获取欧拉角
该事件提供基于地理坐标的设备朝向:α(方位角,绕 z 轴)、β(俯仰角,绕 x 轴)、γ(横滚角,绕 y 轴),单位为度。适用于罗盘、简单体感交互等场景。
使用 devicemotion 获取原始陀螺仪数据
devicemotion 事件的 rotationRate 属性直接暴露陀螺仪的角速度(单位:°/s),包含 alpha(绕 z)、beta(绕 x)、gamma(绕 y)三个分量,采样率更高、延迟更低,适合游戏或精细姿态追踪。
- 启用方式类似,也需用户交互后注册:
function handleMotion(event) {<br> const r = event.rotationRate;<br> if (r) {<br> console.log(`绕x轴旋转速度: ${r.beta} °/s`);<br> }<br>}<br>button.addEventListener('click', () => {<br> window.addEventListener('devicemotion', handleMotion, { passive: true });<br>}); - 部分 ios 设备默认禁用陀螺仪数据,需在
<meta>中添加:
- 注意:rotationRate 值可能为 null,尤其在未校准或权限受限时,务必判空
处理权限与兼容性问题
从 chrome 88+ 和 safari 15.4+ 开始,访问运动传感器需显式请求权限,否则事件不会触发或返回空值。
立即学习“Java免费学习笔记(深入)”;
- 检查并请求权限:
if (typeof DeviceMotionEvent.requestPermission === 'function') {<br> document.addEventListener('click', async () => {<br> try {<br> await DeviceMotionEvent.requestPermission();<br> window.addEventListener('devicemotion', handleMotion);<br> } catch (e) {<br> console.error('权限被拒绝:', e);<br> }<br> });<br>} - 降级方案:检测 API 是否可用,不可用时提示用户或切换为 touch 拖拽模拟
- 桌面端通常不支持,可使用
'ontouchstart' in window粗略判断是否为移动设备
平滑处理与去噪建议
原始陀螺仪数据存在漂移和高频噪声,直接使用易导致抖动。推荐轻量级滤波:
- 加权移动平均:缓存最近 3–5 帧,按时间或系数加权求均值
- 低通滤波(简易版):
filtered = filtered * 0.8 + current * 0.2 - 静止检测:当三轴速率绝对值均持续低于阈值(如 0.5 °/s)达 300ms,可视为设备静止,重置积分或暂停更新