iOS上DeviceOrientation不准的主因是未开启“Motion Calibration & Distance”系统服务，而非陀螺仪硬件故障；该服务默认常关闭，需手动启用，并配合平放静止、缓慢旋转等动作诱导系统重融合，且CIT校准后须重启Safari才生效。
HTML5 DeviceOrientation 事件不准，不是 iOS 陀螺仪坏了
绝大多数情况下，DeviceOrientation（比如 alpha/beta/gamma）在 iOS 上返回数据漂移、延迟或归零，根本原因不是硬件故障，而是 Safari 的权限策略和传感器融合逻辑限制。iOS 不会把原始陀螺仪数据直接暴露给网页，而是通过系统级运动校准服务（Motion Calibration & Distance）做融合处理——这个服务一旦被禁用或未触发校准，网页拿到的就是“降级版”姿态数据。
必须先开权限：启用 Motion Calibration & Distance
这是最常被跳过的一步，也是导致 HTML5 陀螺仪在 iOS 上完全无响应或恒为 0 的主因。它不归「定位服务」管，也不在「隐私 > 运动与健身」里，而藏得更深：
- 进入
设置 > 隐私与安全性 > 定位服务 - 滑到底部，点
系统服务 - 确保
Motion Calibration & Distance是开启状态（绿色）
⚠️ 注意：该开关默认可能关闭；即使你开了「定位服务」和「运动与健身」权限，没开这一项，deviceorientation 事件仍大概率收不到有效数据（尤其 beta/gamma 常为 0 或突变）。
网页端不能主动触发硬件校准，但可诱导系统重融
HTML5 没有 API 能调用 iOS 的 CIT 模式或执行「8 字校准」，所以别在 JS 里写 calibrateGyro() 这类幻想函数。但你可以配合系统行为，让融合结果更稳：
立即学习“前端免费学习笔记（深入）”；
- 页面加载后，提示用户「请将手机平放桌面 3 秒」——这会触发系统静止检测，更新加速度计零偏基准
- 再引导用户缓慢绕竖直轴旋转一圈（类似指南针校准动作），帮助系统对齐地磁参考系
- 避免在金属桌面、靠近音箱/充电器的环境使用，这些会干扰磁力计，连带拖垮融合姿态精度
实测中，很多 AR Web 应用（如 Three.js + DeviceOrientationControls）就是靠这两步把初始 yaw 漂移从 ±15° 压到 ±2° 内。
CIT 模式校准只影响原生层，对网页是间接生效
如果你真进了 CIT 测试（设置 > 关于本机 > 版本号连点 5 次 → 辅助工具 → 第七项陀螺仪校准），它校准的是底层 CMDeviceMotion 输出，而 Safari 的 DeviceOrientation 是基于它的二次封装。所以 CIT 成功 ≠ 网页立刻变准，但它是必要基础：
- CIT 校准失败（显示“校准未通过”）时，网页几乎必然异常
- CIT 成功后，仍需重启 Safari（不是整个设备），否则旧的传感器缓存还在用
- 不要依赖「指南针 App 显示正常」就认为网页能用——指南针走的是更高权限的原生路径，和网页隔离
真正卡住的点往往不在代码，而在用户没开 Motion Calibration & Distance，或者刚校准完忘了重启浏览器标签页。
