expo-sensors的DeviceMotion返回的rotation是什么？如何实现正确指南针功能？

数据老陈

2026-8-29

核心问题

你直接读取rotation.alpha换算方位角的写法完全错误，这也是读数偏差大、旋转时数值不连续的根本原因：

expo-sensors返回的rotation字段是原始航空序欧拉角（Z轴alpha、X轴beta、Y轴gamma），既没有做屏幕旋转方向的轴向适配，也没有做地理坐标系水平投影——只要手机不是绝对水平放置，俯仰、横滚的角度都会直接混到alpha值里，根本不是水平面上正北和手机Y轴的夹角。
Android和iOS平台返回的旋转值参考坐标系本身存在轴向偏移，直接取单轴数值没有做跨平台对齐，自然会出现指北时读数偏差上百度的问题。
谷歌地图能正常工作，是因为它内部完整实现了姿态矩阵转换、轴向适配、滤波校准全流程，从来不会直接拿原始alpha值当方位角用。

正确实现逻辑

可用的指南针方位角定义是：设备任意姿态下，机身顶部方向投影到水平面后，与地理正北方向顺时针的夹角（0~359度，0对应正北），计算必须走完整流程：

拿到原始旋转欧拉角后，先做跨平台坐标系对齐，抹平Android和iOS的返回值差异
从欧拉角计算旋转矩阵，消去俯仰、横滚角度的干扰，只保留水平面上的旋转分量
根据当前屏幕横竖屏方向修正轴向偏移，保证不管怎么转屏幕，参考方向始终是手机顶部
最后做角度归一化，把输出收敛到0~359度区间，再加低通滤波避免读数跳变

可直接复用的实现代码

import { DeviceMotion } from 'expo-sensors';
import { Platform } from 'react-native';
// 实际项目中可以配合expo-screen-orientation获取实时屏幕方向，这里先做基础实现

const radToDeg = (rad) => rad * 180 / Math.PI;

/**
 * 计算正确的指南针方位角
 * @param {Object} rotation - DeviceMotion返回的rotation对象，包含alpha/beta/gamma
 * @param {number} screenAngleOffset - 当前屏幕方向对应的角度偏移，竖屏为0，右横屏为90
 * @returns {number} 0-359度方位角，0为正北
 */
const getAzimuth = (rotation, screenAngleOffset = 0) => {
  let { alpha, beta, gamma } = rotation;
  // 弧度转换
  alpha = (alpha * Math.PI) / 180;
  beta = (beta * Math.PI) / 180;
  gamma = (gamma * Math.PI) / 180;

  // 适配iOS坐标系差异
  if (Platform.OS === 'ios') {
    alpha = -alpha;
    beta = -beta;
  }

  // 计算旋转矩阵分量，做水平投影
  const sinA = Math.sin(alpha), cosA = Math.cos(alpha);
  const sinB = Math.sin(beta), cosB = Math.cos(beta);
  const sinG = Math.sin(gamma), cosG = Math.cos(gamma);

  // 提取水平面上的X/Y方向分量，消去俯仰、横滚干扰
  const xComp = sinG * sinB * cosA - cosG * sinA;
  const yComp = cosG * sinB * cosA + sinG * sinA;

  // 计算初始方位角
  let azimuth = radToDeg(Math.atan2(xComp, yComp));
  // 修正屏幕旋转带来的偏移
  azimuth -= screenAngleOffset;
  // 归一化到0-360度区间
  azimuth = (azimuth + 360) % 360;

  return Math.round(azimuth);
};

// 低通滤波配置，避免读数跳变
let lastAzimuth = 0;
const filterFactor = 0.2; // 数值越小读数越稳，响应越慢，可根据需求在0.1~0.3区间调整

// 启动指南针
const startCompass = async () => {
  // Android 12及以上版本必须申请传感器权限
  const permRes = await DeviceMotion.requestPermissionsAsync();
  if (permRes.status !== 'granted') {
    console.warn('缺少运动传感器权限，无法使用指南针');
    return;
  }
  // 设置更新间隔，16ms对应60fps，普通指南针用30ms~50ms也足够
  DeviceMotion.setUpdateInterval(30);

  DeviceMotion.addListener((motionData) => {
    const rawAzimuth = getAzimuth(motionData.rotation, 0);
    // 低通滤波平滑读数
    const filteredAzimuth = Math.round(
      lastAzimuth * (1 - filterFactor) + rawAzimuth * filterFactor
    );
    lastAzimuth = filteredAzimuth;
    console.log('当前方位角:', filteredAzimuth);
  });
};

注意事项

地磁传感器需要校准：如果出现固定角度偏差，提示用户手持设备做8字形晃动完成校准，这是所有消费电子设备指南针的通用校准逻辑，系统级导航应用也依赖这个操作。
磁北与真北差异：如果需要和地图经纬度坐标对齐，需要根据用户当前经纬度、海拔计算当地磁偏角做修正，普通指南针功能直接使用磁北读数即可。
不要在金属、强磁场附近使用：靠近钢筋、音箱、无线充电板等物体时地磁传感器会受干扰，读数必然不准，系统指南针也会在这种场景下提示干扰。

内容的提问来源于stack exchange，提问作者injecteer