JavaScript 中获取设备传感器数据首选 Generic Sensor API(如 Accelerometer、Gyroscope),精度高、延迟低,但需 HTTPS 和用户授权;兼容性要求高时可降级使用 DeviceOrientation API,仅提供融合欧拉角且 iOS 默认禁用。

JavaScript 中使用设备的陀螺仪(Gyroscope)和加速度计(Accelerometer)主要依靠 DeviceOrientation API 和更现代、更精确的 Generic Sensor API(如 Accelerometer、Gyroscope)。前者兼容性好但精度低、有权限限制;后者功能强、数据准,但需 HTTPS + 用户授权,且仅支持较新浏览器(Chrome 67+、Edge 79+,Firefox 部分支持)。
用 DeviceOrientation API 快速获取方向数据(兼容优先)
这是最广泛支持的方式,通过 deviceorientation 事件获取 alpha(绕 z 轴旋转)、beta(绕 x 轴俯仰)、gamma(绕 y 轴翻滚),以及可选的绝对方向 compassheading。注意:它不直接提供加速度或角速度原始值,而是融合后的欧拉角,且 iOS Safari 默认禁用,需用户手动开启“运动与方向”权限。
- 监听事件:
window.addEventListener('deviceorientation', handler) - 回调中读取
event.beta(前后倾斜)、event.gamma(左右倾斜)、event.alpha(面朝方向,0–360°) - 首次触发前需用户交互(如点击按钮)才能启用,否则事件不会触发
- 适合简单交互,比如倾斜控制菜单、AR 场景粗略朝向判断
用 Generic Sensor API 获取原始传感器数据(推荐用于精准场景)
这是 W3C 标准,提供独立、高频率、低延迟的原始传感器流。需确保页面运行在 HTTPS 下,并在调用前请求权限(navigator.permissions.query({ name: 'accelerometer' }) 等)。
- 加速度计示例:
const acc = new Accelerometer({ frequency: 60 }); acc.addEventListener('reading', () => { console.log(acc.x, acc.y, acc.z); }); acc.start(); - 陀螺仪示例:
const gyro = new Gyroscope({ frequency: 60 }); gyro.addEventListener('reading', () => { console.log(gyro.x, gyro.y, gyro.z); }); gyro.start(); - 注意:x/y/z 单位分别是 m/s² 和 rad/s,坐标系遵循 W3C 设备坐标系(z 轴指向屏幕外)
- 部分安卓 Chrome 可能需开启 chrome://flags/#enable-generic-sensor-extra-classes 启用支持
权限与兼容性处理不能跳过
现代传感器 API 默认受保护,不处理权限会静默失败。
立即学习“Java免费学习笔记(深入)”;
- 先检查支持:
if ('Accelerometer' in window)或'ondeviceorientation' in window - 请求权限(仅 Generic Sensor):
await navigator.permissions.query({ name: 'accelerometer' }),状态为'granted'才能创建实例 - 降级策略:Generic Sensor 不可用时,回退到
deviceorientation并提示用户“请允许方向访问以获得更好体验” - 移动端需明确告知用户开启系统级权限(如 iOS 设置 → Safari → 运动与方向)
实用小技巧:融合数据 & 去噪
原始传感器数据常含噪声和偏移,尤其陀螺仪积分易漂移。简单应用可做基础处理:
- 加速度计静止时应接近 (0, 0, -9.81),可用此校准重力分量
- 对高频数据做滑动平均(如取最近 5 次 reading 的均值)降低抖动
- 结合加速度计和陀螺仪(传感器融合)可估算姿态,但需卡尔曼滤波或 Madgwick 算法——这类逻辑建议用 sensor-fusion-js 等轻量库
- 避免在页面隐藏时持续采集(
visibilitychange事件中暂停.stop())节省电量











