javascript 无法通过 bom 直接监听重力感应方向，需使用 deviceorientation api 的 accelerationincludinggravity 属性获取含重力的加速度向量（x/y/z），其值反映设备坐标系中重力方向，适用于倾斜检测等场景。
JavaScript 中无法直接通过 BOM（Browser Object Model）监听设备重力感应方向，因为标准 BOM 接口（如 window、navigator、screen 等）本身不提供重力或姿态数据。真正可用的是 DeviceOrientation API（属于 Web API，不是 BOM 的一部分），它基于设备的加速度计和陀螺仪，提供重力相关的信息。
用 DeviceOrientation API 获取重力分量
该 API 通过 deviceorientation 事件返回设备在三维空间中的姿态，其中 accelerationIncludingGravity 属性给出了包含重力的加速度向量（单位：m/s²），是监听“重力感应方向”的最常用方式。
- 需用户主动授权（现代浏览器要求页面为安全上下文，即 HTTPS 或 localhost）
- 事件回调中可获取
event.accelerationIncludingGravity.x、y、z，分别对应设备坐标系中三个轴的重力分量 - Z 轴通常垂直于屏幕向外；当手机平放桌面时，z ≈ −9.8，x 和 y 接近 0；竖直立起时，y 或 x 显著变化
注意区分 acceleration 和 accelerationIncludingGravity
acceleration 是纯运动加速度（不含重力），而 accelerationIncludingGravity 才反映当前重力方向 —— 因为重力始终作用在设备上，其投影会随设备朝向改变。
- 例如：手机静止斜握时，
acceleration接近{x: 0, y: 0, z: 0}，但accelerationIncludingGravity会显示非零值，指向“向下”方向在设备坐标系中的分量 - 若需计算重力方向与地面夹角，可用
Math.atan2(Math.sqrt(x² + y²), z)近似估算倾斜角
兼容性与权限处理
并非所有浏览器都默认启用该 API，尤其 iOS Safari 需用户首次交互（如点击）后才能触发事件；部分 Android 浏览器可能需要显式请求权限。
- 建议先检测支持性：
if (window.DeviceOrientationEvent) - 监听前可加一次用户手势（如按钮点击）再调用
window.addEventListener('deviceorientation', ...)，提高 iOS 兼容性 - 注意：Chrome 96+ 对未激活页面会暂停该事件，后台标签页中无法持续监听
替代方案：使用 Orientation Sensor（更现代但支持有限）
较新的 Accelerometer 和 GravitySensor（属于 Generic Sensor API）可提供更干净的重力数据，但目前仅 Chromium 内核浏览器（如 Chrome、Edge）部分支持，且需 HTTPS + 用户许可。
- 示例：
const sensor = new GravitySensor(); sensor.start(); sensor.onreading = () => { console.log(sensor.x, sensor.y, sensor.z); }; - 优势：数据更稳定、不混入线性加速度；劣势：兼容性差，不能作为生产环境首选
不复杂但容易忽略：重力方向本质是设备坐标系下的向量，要映射到现实世界（比如判断手机是否倒置），还需结合 deviceorientation 的 alpha/beta/gamma 或用 RotationRate 辅助校准。单纯看 accelerationIncludingGravity 已能满足多数倾斜检测需求。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
