AbsoluteOrientationSensor 是 HTML5 Sensor API 中用于获取设备相对于地球坐标系绝对朝向的接口，返回四元数，依赖陀螺仪、加速度计和磁力计融合，仅在 HTTPS 或 localhost 安全上下文中可用。
AbsoluteOrientationSensor 是 HTML5 的 Sensor API 中用于获取设备在三维空间中相对于地球坐标系（即地理北、重力方向）的绝对朝向的接口，它返回的是四元数（quaternion），代表设备绕 X/Y/Z 轴的旋转状态。它依赖于底层硬件（如陀螺仪 + 加速度计 + 磁力计融合）支持，且仅在安全上下文（https:// 或 localhost）中可用。
前提条件与权限检查
使用前需确认浏览器支持并请求必要权限：
- 确保页面运行在 HTTPS 或 localhost 环境下；
- 调用
navigator.permissions.query({ name: "accelerometer" })和"gyroscope"、"magnetometer"（部分浏览器要求显式申请）； - 现代 Chrome/Edge 通常会在首次访问传感器时自动触发权限提示，但建议主动检测失败原因（如抛出
SecurityError或NotAllowedError）。
创建并启动传感器实例
使用四元数形式初始化传感器，并监听 reading 事件：
if (typeof AbsoluteOrientationSensor === "function") {
const sensor = new AbsoluteOrientationSensor({ frequency: 60 });
<p>sensor.addEventListener("reading", () => {
const { x, y, z, w } = sensor.quaternion;
console.log("四元数：", { x, y, z, w });
});</p><p>sensor.addEventListener("error", (event) => {
console.error("传感器错误：", event.error);
});</p><p>sensor.start();
} else {
console.warn("当前浏览器不支持 AbsoluteOrientationSensor");
}注意：frequency 表示目标采样频率（单位 Hz），实际值取决于硬件和系统负载；若省略，使用默认频率（通常较低）。
立即学习“前端免费学习笔记（深入）”；
将四元数转换为更易理解的角度（可选）
四元数本身不易直观解读，常需转为欧拉角（如 yaw/pitch/roll）或旋转矩阵。例如计算偏航角（yaw，即水平朝向，近似罗盘角度）：
- 从
quaternion推导出设备 Z 轴（指向屏幕外）在水平面的投影方向； - 结合重力向量（由加速度计隐含提供）和地磁北方向（需磁力计校准），才能准确解算真北偏航；
- 简单估算 yaw（假设设备平放）：
yaw ≈ atan2(2*(w*z + x*y), 1 - 2*(y² + z²)) * 180 / Math.PI（结果单位为度，范围 −180°~+180°）； - 更可靠的做法是使用标准库如 three.js-sensors 或自行实现传感器融合逻辑。
注意事项与兼容性提醒
该传感器行为受多因素影响：
- Android Chrome 69+ 支持，iOS Safari 不支持**（截至 iOS 17，Safari 仍无实现）；
- 部分设备缺少磁力计或未校准，会导致 yaw 漂移或不准；
- 不要在页面不可见时持续运行（可监听
visibilitychange暂停sensor.stop()）； - 避免在低端设备上设置过高
frequency，以防耗电或丢帧。
