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

JavaScript 通过 DeviceOrientation API 和 DeviceMotion API 获取设备方向与运动数据,其中陀螺仪(角速度)信息主要由 deviceorientation 事件提供,而更底层、高频率的原始陀螺仪数据则需使用 devicemotion 事件中的 rotationRate 字段。
监听 deviceorientation 事件获取欧拉角
该事件提供基于地理坐标的设备朝向:α(方位角,绕 z 轴)、β(俯仰角,绕 x 轴)、γ(横滚角,绕 y 轴),单位为度。适用于罗盘、简单体感交互等场景。
- 需用户手势触发(如点击/触摸)后才能启用,现代浏览器禁止自动启动
- 监听示例:
function handleOrientation(event) {<br> console.log(`α: ${event.alpha}, β: ${event.beta}, γ: ${event.gamma}`);<br>}<br>document.addEventListener('click', () => {<br> window.addEventListener('deviceorientation', handleOrientation);<br>});登录后复制
- 注意:α 在某些 Android 设备上可能为 null,需检查
event.absolute或降级处理
使用 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>中添加:<meta name="apple-mobile-web-app-capable" content="yes"><br><meta name="apple-mobile-web-app-status-bar-style" content="black">
登录后复制
- 注意:rotationRate 值可能为 null,尤其在未校准或权限受限时,务必判空
处理权限与兼容性问题
从 Chrome 88+ 和 Safari 15.4+ 开始,访问运动传感器需显式请求权限,否则事件不会触发或返回空值。
标签: javascript java android 浏览器 app safari ai ios win apple red
还木有评论哦,快来抢沙发吧~