绝对方向传感器演示 - 三维指南针

DeviceOrientation API 是浏览器提供的一组接口，用于获取设备在三维空间中的姿态信息。它结合了加速度计、陀螺仪和磁力计的数据，通过传感器融合算法实时输出设备的旋转角度。三个核心参数为：Alpha（绕Z轴旋转，即罗盘方位角）、Beta（绕X轴旋转，前后俯仰角）和Gamma（绕Y轴旋转，左右翻滚角）。该API在移动设备上广泛支持，但需要HTTPS协议。

• Alpha（α）· 方位角：设备绕Z轴（垂直于屏幕）的旋转角度，范围0°~360°。0°表示设备指向正北，顺时针增加（90°=东，180°=南，270°=西）。这是指南针功能的核心参数。
• Beta（β）· 俯仰角：设备绕X轴（屏幕水平方向）的旋转角度，范围-180°~180°。0°表示设备水平放置，正值表示屏幕向上倾斜（顶部抬起），负值表示屏幕向下倾斜。
• Gamma（γ）· 翻滚角：设备绕Y轴（屏幕垂直方向）的旋转角度，范围-90°~90°。0°表示设备左右水平，正值表示向右倾斜，负值表示向左倾斜。

常见原因及解决方案：
1. iOS 13+ 设备：Apple要求用户通过点击手势主动授权。页面会显示"点击启用"按钮，点击后弹出系统权限对话框，选择"允许"即可。
2. 桌面端浏览器：大多数桌面设备没有方向传感器硬件，您可以使用鼠标在指南针上拖拽旋转来模拟体验。
3. HTTP协议限制：DeviceOrientation API要求HTTPS安全连接（localhost除外），请确保网站已部署SSL证书。
4. 浏览器不支持：部分老旧浏览器或特定WebView可能不支持此API，建议使用Chrome/Safari/Firefox最新版。

传统指南针仅显示二维平面上的方向（北/南/东/西），而本工具的3D指南针还融合了设备的俯仰角和翻滚角信息，通过CSS 3D变换实时展示设备在三维空间中的完整姿态。表盘不仅旋转指示方位，还会随设备倾斜产生立体透视效果，配合水平仪可以直观了解设备是否保持水平——这在户外导航、工程测量、无人机操控等场景中非常实用。

水平仪模拟了物理气泡水平仪的原理。气泡的位置由beta（俯仰角）和gamma（翻滚角）共同决定：
• Gamma 控制气泡的水平偏移（左右倾斜）
• Beta 控制气泡的垂直偏移（前后倾斜）
当设备完全水平时（beta≈0且gamma≈0），气泡精确位于圆心。设备向任意方向倾斜时，气泡会向倾斜方向移动，偏离中心越远表示倾斜角度越大。这是一种直观的设备调平辅助工具。

现代智能手机的传感器精度通常可以达到1°~3°（经过校准后）。但以下因素可能导致精度下降：
• 磁场干扰：金属物体、电子设备、磁性保护壳会干扰磁力计，导致alpha值偏差。远离干扰源或进行"8字校准"可改善。
• 快速运动：陀螺仪在高速旋转时可能产生漂移，传感器融合算法需要短暂稳定。
• 温度变化：极端温度可能影响MEMS传感器性能。
• 设备差异：不同品牌/型号的传感器硬件质量存在差异，旗舰机型通常表现更佳。