JavaScript检测手机姿态主要依靠DeviceOrientation API(获取alpha/beta/gamma欧拉角)和DeviceMotion API(获取加速度与旋转速率),但需HTTPS环境及用户手势触发,且要注意alpha可能为null、iOS Safari兼容性限制及AR场景应优先使用WebXR API。
JavaScript 中检测手机姿态变化主要依靠 DeviceOrientation API 和 DeviceMotion API,它们能获取设备在三维空间中的朝向(alpha/beta/gamma)和加速度/旋转速率。但要注意:现代浏览器大多要求页面通过 HTTPS 提供,且需用户手势触发(如点击、触摸)后才能启用这些 API。
该事件提供设备相对于地球坐标系的欧拉角:
示例代码(需用户交互后启用):
let isListening = false;document.body.addEventListener('click', () => { if (!isListening) { window.addEventListener('deviceorientation', handleOrientation); isListening = true; } });
function handleOrientation(event) { console.log({ alpha: event.alpha, // 方位角(可能为 null,需检查) beta: event.beta, // 前后倾斜 gamma: event.gamma // 左右倾斜 }); }
⚠️ 注意:alpha 在某些 Android 设备或隐私模式下可能为 null,建议先判断 event.alpha !== null 再使用。
它提供更底层的传感器数据,适合做摇晃检测、步数估算等:
例如检测“摇一摇”:
let lastTime = 0; const THRESHOLD = 25; // 加速度变化阈值function handleMotion(event) { const now = Date.now(); const timeDelta = now - lastTime; lastTime = now;
const acc = event.accelerationIncludingGravity; const speed = Math.sqrt(acc.x2 + acc.y2 + acc.z**2);
if (speed > THRESHOLD && timeDelta > 300) { console.log('检测到一次有效摇晃'); // 触发刷新、切换、拍照等操作 } }
document.body.addEventListener('click', () => { window.addEventListener('devicemotion', handleMotion); });
requestAnimationFrame 或简单时间间隔限制处理频率;deviceorientation 默认禁用 alpha,需在 In
fo.plist 中配置(仅限 PWA 或 WebView 场景);比如需要精确朝向的 AR 应用,deviceorientation 精度有限且易受磁场干扰。此时应优先考虑 WebXR API(如 XRSession)配合陀螺仪+视觉定位,它更稳定、有坐标系对齐能力,也支持 WebXR Viewer 或 Chrome on Android。
基本上就这些。用好 deviceorientation 和 devicemotion,就能让网页真正“感知”用户怎么拿手机——不复杂但容易忽略初始化时机和权限逻辑。