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