如何直接获取手机Z轴与磁北极的夹角（用于确定摄像头朝向）

嘿，我明白你遇到的问题了——直接用Y轴方位角加重力修正确实容易在手机翻转等复杂姿态下出错，毕竟手机的姿态变化会让Z轴和Y轴的相对关系变得很复杂，手动计算很难覆盖所有场景。不过确实有更可靠的方法，利用Android传感器框架的坐标系映射就能解决这个问题，下面给你详细说：

核心思路 #

Android的SensorManager提供的getRotationMatrix可以结合重力传感器和地磁传感器的数据，生成设备相对于世界坐标系的旋转矩阵。而remapCoordinateSystem方法能帮我们重新定义坐标系，让我们可以直接计算出摄像头朝向（Z轴）对应的方位角，不用手动去修正。

简单来说，我们要做的就是：

• 同步获取重力传感器和地磁传感器的原始数据
• 生成设备的旋转矩阵
• 重新映射坐标系，把摄像头朝向的Z轴当作新的"参考Y轴"
• 基于新的坐标系计算方位角

具体实现步骤 #

1. 注册传感器监听 #

首先，你需要注册重力传感器和地磁传感器的监听，确保能同步获取两者的数据：

private SensorManager sensorManager;
private Sensor gravitySensor;
private Sensor magneticSensor;
private float[] gravityData = new float[3];
private float[] magneticData = new float[3];

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    
    sensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);
    gravitySensor = sensorManager.getDefaultSensor(Sensor.TYPE_GRAVITY);
    magneticSensor = sensorManager.getDefaultSensor(Sensor.TYPE_MAGNETIC_FIELD);
}

@Override
protected void onResume() {
    super.onResume();
    sensorManager.registerListener(this, gravitySensor, SensorManager.SENSOR_DELAY_NORMAL);
    sensorManager.registerListener(this, magneticSensor, SensorManager.SENSOR_DELAY_NORMAL);
}

@Override
protected void onPause() {
    super.onPause();
    sensorManager.unregisterListener(this);
}

2. 处理传感器数据并计算方位角 #

在onSensorChanged回调中，我们先缓存两个传感器的数据，然后生成旋转矩阵并重新映射坐标系：

@Override
public void onSensorChanged(SensorEvent event) {
    if (event.sensor.getType() == Sensor.TYPE_GRAVITY) {
        System.arraycopy(event.values, 0, gravityData, 0, 3);
    } else if (event.sensor.getType() == Sensor.TYPE_MAGNETIC_FIELD) {
        System.arraycopy(event.values, 0, magneticData, 0, 3);
    }

    // 当两个传感器数据都就绪时计算
    float[] rotationMatrix = new float[9];
    boolean success = SensorManager.getRotationMatrix(rotationMatrix, null, gravityData, magneticData);
    if (success) {
        float[] remappedMatrix = new float[9];
        // 关键：将设备的Z轴（摄像头朝向）映射为新坐标系的Y轴，保持X轴不变
        // 这样getOrientation返回的azimuth就是摄像头朝向与磁北极的夹角
        SensorManager.remapCoordinateSystem(rotationMatrix, 
                SensorManager.AXIS_X, SensorManager.AXIS_Z, remappedMatrix);

        float[] orientation = new float[3];
        SensorManager.getOrientation(remappedMatrix, orientation);
        
        // 将弧度转换为角度，并调整到0-360度范围
        float cameraAzimuth = (float) Math.toDegrees(orientation[0]);
        cameraAzimuth = (cameraAzimuth + 360) % 360;
        
        // 这里就是你需要的摄像头朝向与磁北极的方位角了
        Log.d("CameraAzimuth", "摄像头方位角：" + cameraAzimuth + "°");
    }
}

@Override
public void onAccuracyChanged(Sensor sensor, int accuracy) {
    // 可以在这里处理传感器精度变化，比如精度低时提示用户校准地磁传感器
    if (sensor.getType() == Sensor.TYPE_MAGNETIC_FIELD && accuracy < SensorManager.SENSOR_STATUS_ACCURACY_MEDIUM) {
        Toast.makeText(this, "请校准地磁传感器（画8字动作）", Toast.LENGTH_SHORT).show();
    }
}

关键注意事项 #

• 传感器校准：地磁传感器容易受周围磁场干扰（比如金属、电子设备），精度低时数据会偏差很大。一定要提示用户做校准（通常是在空中画8字），保证数据可靠。
• 屏幕旋转适配：如果你的应用支持屏幕旋转，需要根据当前屏幕的旋转角度调整remapCoordinateSystem的轴向参数。比如当屏幕横屏时，可能需要用SensorManager.AXIS_Y和SensorManager.AXIS_MINUS_X作为新的坐标轴，你可以通过Display.getRotation()获取当前屏幕旋转状态来动态调整。
• 数据平滑：传感器数据可能会有抖动，你可以用低通滤波来平滑结果，让方位角变化更稳定。

为什么这个方法更可靠 #

之前你手动计算的方法只考虑了Y轴和Z轴的夹角，但没有结合设备的俯仰角（pitch）和翻滚角（roll）的影响。而remapCoordinateSystem是基于完整的旋转矩阵来转换坐标系的，它会自动处理所有姿态下的空间变换，所以得到的方位角在手机翻转、倾斜等各种场景下都能保持准确。

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