Android不同朝向手机的指南针适配：竖屏安装时如何获取正确方向？

问题分析 #

当前代码仅在手机水平放置时能正确计算方位角，竖屏固定（比如车载安装）时，由于传感器默认坐标系（X轴沿屏幕向右、Y轴沿屏幕向上、Z轴垂直屏幕向外）与设备实际物理姿态不匹配，导致方位角计算偏差。核心问题是未针对竖屏场景做坐标系转换。

修正方案 #

通过SensorManager.remapCoordinateSystem()方法重映射坐标系，将原始旋转矩阵适配到竖屏的显示方向，再计算方位角，步骤如下：

1. 获取当前屏幕的旋转角度，判断竖屏的旋转方向
2. 根据旋转角度调整坐标轴映射关系
3. 重映射旋转矩阵后，再计算方位角

修正后的代码 #

if (sensorEvent.accuracy == SensorManager.SENSOR_STATUS_UNRELIABLE)
    return;

switch (sensorEvent.sensor.getType()) {
    case Sensor.TYPE_ACCELEROMETER:
        gravity = sensorEvent.values.clone();
        break;
    case Sensor.TYPE_MAGNETIC_FIELD:
        geomag = sensorEvent.values.clone();
        break;
}

if (gravity != null && geomag != null) {
    boolean success = SensorManager.getRotationMatrix(inR, I, gravity, geomag);
    if (success) {
        // 获取当前屏幕旋转状态
        Display display = ((WindowManager) getSystemService(Context.WINDOW_SERVICE)).getDefaultDisplay();
        int rotation = display.getRotation();
        
        int axisX = SensorManager.AXIS_X;
        int axisY = SensorManager.AXIS_Y;

        // 根据竖屏旋转方向调整坐标轴映射
        switch (rotation) {
            case Surface.ROTATION_90:
                // 顺时针转90度竖屏
                axisX = SensorManager.AXIS_Y;
                axisY = SensorManager.AXIS_MINUS_X;
                break;
            case Surface.ROTATION_270:
                // 逆时针转90度竖屏
                axisX = SensorManager.AXIS_MINUS_Y;
                axisY = SensorManager.AXIS_X;
                break;
            // 水平（ROTATION_0）和倒置（ROTATION_180）保持默认映射
        }

        // 重映射坐标系，生成适配竖屏的旋转矩阵
        float[] outR = new float[9];
        boolean remapSuccess = SensorManager.remapCoordinateSystem(inR, axisX, axisY, outR);
        if (remapSuccess) {
            SensorManager.getOrientation(outR, orientVals);
            azimuth = Math.toDegrees(orientVals[0]);
            // 将方位角转换为0-360度范围
            azimuth = (azimuth + 360) % 360;
            pitch = Math.toDegrees(orientVals[1]);
            roll = Math.toDegrees(orientVals[2]);
        }
    }
}

关键说明 #

• 坐标系重映射：remapCoordinateSystem负责将设备自然姿态的旋转矩阵，转换为当前屏幕显示方向的矩阵，确保方位角与竖屏视角一致。
• 旋转方向适配：根据车载安装的实际竖屏方向（顺时针/逆时针），选择对应的坐标轴映射规则。
• 方位角修正：默认计算的方位角范围是-180°到180°，转换为0-360°更符合日常使用习惯。

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