TYPE_GAME_ROTATION_VECTOR传感器初始航向角固定问题原因及解决

原因分析 #

1. TYPE_GAME_ROTATION_VECTOR传感器的特性：这个传感器不依赖地磁数据，它的航向角基准不是地理北极，而是设备出厂时的固定初始姿态（比如设备默认的"初始朝向"）。因此无论设备如何摆放，首次获取的航向角都是相对这个固定基准的数值，表现为固定不变的初始值。
2. 坐标系映射参数错误：你代码中使用SensorManager.AXIS_X和SensorManager.AXIS_Y作为remapCoordinateSystem的参数，这会导致映射后的坐标系Z轴与传感器原始Z轴完全一致，进一步固化了航向角的基准，使得初始值始终固定。

解决方案 #

根据你的实际需求分两种场景处理：

场景1：获取相对设备初始姿态的航向角（初始位置设为0，旋转后实时变化） #

• 实现步骤：
  1. 新增两个变量，用于记录初始偏移和标记首次读数：

     private var initialYawOffset: Float = 0f
     private var isFirstReading = true
     

  2. 修改calculateAngle方法，首次读数时记录初始偏移，后续计算时减去该偏移，让初始位置的航向角为0：

     private fun calculateAngle(eventValues: FloatArray) {
         SensorManager.getRotationMatrixFromVector(rotationMatrix, eventValues)
         // 修正坐标系映射：适配竖直握持屏幕朝上的场景，建议使用AXIS_X和AXIS_MINUS_Z
         SensorManager.remapCoordinateSystem(rotationMatrix, SensorManager.AXIS_X, SensorManager.AXIS_MINUS_Z, outR)
         SensorManager.getOrientation(outR, orientationAngles)
         val rawYaw = Math.toDegrees(orientationAngles[0].toDouble()).toFloat()
         
         if (isFirstReading) {
             initialYawOffset = rawYaw
             isFirstReading = false
             _yaw = 0f // 初始位置航向角设为0
         } else {
             _yaw = rawYaw - initialYawOffset
             // 可选：将角度范围修正为0-360，避免负数
             if (_yaw < 0) _yaw += 360f
         }
     }
     

  3. 在页面销毁时重置isFirstReading为true，确保下次进入页面时重新初始化偏移。

场景2：获取绝对地理航向角（对齐正北方向） #

• TYPE_GAME_ROTATION_VECTOR不支持绝对航向，因为它完全不使用地磁数据。你需要替换为TYPE_ROTATION_VECTOR传感器（同时依赖加速度和地磁），调整后的代码如下：
  1. 注册传感器时替换为：

     val rotationSensor = sensorManager.getDefaultSensor(Sensor.TYPE_ROTATION_VECTOR)
     sensorManager.registerListener(this, rotationSensor, SensorManager.SENSOR_DELAY_GAME)
     

  2. 计算逻辑调整（无需初始偏移，只要地磁校准正常，初始航向会对齐正北）：

     private fun calculateAngle(eventValues: FloatArray) {
         SensorManager.getRotationMatrixFromVector(rotationMatrix, eventValues)
         // 映射到竖直握持的屏幕坐标系
         SensorManager.remapCoordinateSystem(rotationMatrix, SensorManager.AXIS_X, SensorManager.AXIS_MINUS_Z, outR)
         SensorManager.getOrientation(outR, orientationAngles)
         _yaw = Math.toDegrees(orientationAngles[0].toDouble()).toFloat()
         // 修正角度范围为0-360
         if (_yaw < 0) _yaw += 360f
     }
     

  3. 注意：使用地磁相关传感器需要确保设备完成地磁校准，否则航向角会出现较大偏差。

补充提示 #

• remapCoordinateSystem的参数需要根据设备握持方式调整：比如横屏握持时，可能需要使用SensorManager.AXIS_Y和SensorManager.AXIS_MINUS_X作为参数，确保航向角的变化符合用户的直观操作预期。
• 欧拉角存在万向锁问题，如果你的应用需要更稳定的姿态表示，可以考虑直接使用四元数代替欧拉角进行计算。

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