Android设备TYPE_ROTATION_VECTOR返回null致崩溃，求全版本适配方案

嘿，这个传感器适配的问题我太熟了！很多低成本设备或者老机型确实没有搭载TYPE_ROTATION_VECTOR或TYPE_GAME_ROTATION_VECTOR传感器，直接调用的话肯定会因为null指针崩溃。我给你一套适配所有Android版本的解决方案，一步步来：

核心问题分析 #

不是所有Android设备都支持这两个高精度姿态传感器——TYPE_GAME_ROTATION_VECTOR是API 18（Jelly Bean MR2）才引入的，TYPE_ROTATION_VECTOR是API 11（Honeycomb）引入的，而且很多低端设备为了节省成本根本没硬件支持这些传感器，所以getDefaultSensor()会返回null，直接使用就会触发NullPointerException。

分步解决方案 #

1. 按优先级尝试获取传感器，做降级处理 #

我们应该先尝试获取更优的传感器，失败后依次降级到备选方案，最后兜底到几乎所有设备都支持的加速度计+磁力计组合：

SensorManager sensorManager = (SensorManager) getSystemService(Context.SENSOR_SERVICE);
Sensor targetSensor = null;
Sensor accelerometer = null;
Sensor magnetometer = null;

// 第一步：尝试获取Game Rotation Vector（API 18+，排除地磁干扰，适合游戏/AR场景）
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN_MR2) {
    targetSensor = sensorManager.getDefaultSensor(Sensor.TYPE_GAME_ROTATION_VECTOR);
}

// 第二步：如果失败，尝试普通Rotation Vector（API 11+）
if (targetSensor == null && Build.VERSION.SDK_INT >= Build.VERSION_CODES.HONEYCOMB) {
    targetSensor = sensorManager.getDefaultSensor(Sensor.TYPE_ROTATION_VECTOR);
}

// 第三步：如果还是null，获取加速度计和磁力计作为兜底
if (targetSensor == null) {
    accelerometer = sensorManager.getDefaultSensor(Sensor.TYPE_ACCELEROMETER);
    magnetometer = sensorManager.getDefaultSensor(Sensor.TYPE_MAGNETIC_FIELD);
}

2. 注册传感器监听器前做null检查 #

拿到传感器后，必须确认非null再注册监听器，同时处理兜底方案：

// 自定义的传感器事件监听器
SensorEventListener sensorEventListener = new SensorEventListener() {
    float[] accelValues = null;
    float[] magValues = null;

    @Override
    public void onSensorChanged(SensorEvent event) {
        switch (event.sensor.getType()) {
            case Sensor.TYPE_GAME_ROTATION_VECTOR:
            case Sensor.TYPE_ROTATION_VECTOR:
                // 处理旋转向量数据，直接转换为姿态角
                float[] rotMatrix = new float[9];
                SensorManager.getRotationMatrixFromVector(rotMatrix, event.values);
                float[] orientation = new float[3];
                SensorManager.getOrientation(rotMatrix, orientation);
                // orientation[0] = 方位角, orientation[1] = 俯仰角, orientation[2] = 滚转角
                updateUIWithOrientation(orientation);
                break;
            case Sensor.TYPE_ACCELEROMETER:
                accelValues = event.values.clone();
                break;
            case Sensor.TYPE_MAGNETIC_FIELD:
                magValues = event.values.clone();
                break;
        }

        // 处理加速度计+磁力计的兜底逻辑
        if (accelValues != null && magValues != null) {
            float[] rotMatrix = new float[9];
            boolean isMatrixValid = SensorManager.getRotationMatrix(rotMatrix, null, accelValues, magValues);
            if (isMatrixValid) {
                float[] orientation = new float[3];
                SensorManager.getOrientation(rotMatrix, orientation);
                updateUIWithOrientation(orientation);
            }
        }
    }

    @Override
    public void onAccuracyChanged(Sensor sensor, int accuracy) {
        // 可以在这里处理传感器精度变化的逻辑
    }
};

// 注册监听器
if (targetSensor != null) {
    sensorManager.registerListener(sensorEventListener, targetSensor, SensorManager.SENSOR_DELAY_NORMAL);
} else if (accelerometer != null && magnetometer != null) {
    sensorManager.registerListener(sensorEventListener, accelerometer, SensorManager.SENSOR_DELAY_NORMAL);
    sensorManager.registerListener(sensorEventListener, magnetometer, SensorManager.SENSOR_DELAY_NORMAL);
} else {
    // 没有任何可用的姿态传感器，提示用户
    Toast.makeText(this, "当前设备不支持姿态检测功能", Toast.LENGTH_LONG).show();
}

3. 记得注销监听器，避免内存泄漏 #

在Activity/Fragment的生命周期方法中注销监听器，比如在onPause()或onDestroy()：

@Override
protected void onPause() {
    super.onPause();
    if (sensorManager != null && sensorEventListener != null) {
        sensorManager.unregisterListener(sensorEventListener);
    }
}

4. 额外注意事项 #

• 线程安全：onSensorChanged()是在非UI线程调用的，如果要更新UI，记得用runOnUiThread()或者Handler切换到主线程。
• 传感器延迟：根据你的场景选择合适的延迟（SENSOR_DELAY_NORMAL/SENSOR_DELAY_GAME等），不要用过高的采样率，会增加功耗。
• 权限问题：姿态类传感器不需要位置权限，但如果你的应用同时使用了位置相关的传感器，记得在AndroidManifest.xml中声明对应的权限，并在运行时请求（Android 6.0+）。

总结 #

通过“优先高精度传感器→降级普通传感器→兜底加速度计+磁力计”的分层方案，再加上严格的null检查和生命周期管理，就能完美适配所有Android版本和设备，再也不会因为传感器null导致崩溃了！

内容的提问来源于stack exchange，提问作者Moayed I. Alayseh