28、常见问题排查：传感器无数据、数据异常、权限问题

做陀螺仪开发，最怕什么？

不是代码写不出来，而是明明写了代码，传感器就是没反应。或者数据出来了，但飘得离谱。

我这些年调试过的传感器问题，少说也有几十种。今天我把最常见的三类问题——无数据、数据异常、权限问题——给你梳理清楚。每个问题我都会告诉你：为什么会这样？怎么排查？怎么解决？

核心原则：先硬件后软件，先权限后代码，先日志后猜测。

陀螺仪问题排查流程 传感器无数据 数据异常 权限问题 检查传感器是否存在 检查注册监听器 检查采样率设置 检查校准状态 检查噪声与漂移 检查坐标系对齐 检查AndroidManifest 检查运行时权限 检查系统权限

一、传感器无数据

这是最让人抓狂的问题。你注册了监听器，但onSensorChanged就是不走。

第一步：检查设备有没有陀螺仪

不是所有手机都有陀螺仪。低端机型经常砍掉这个硬件。

SensorManager sensorManager = (SensorManager) getSystemService(SENSOR_SERVICE);
Sensor gyro = sensorManager.getDefaultSensor(Sensor.TYPE_GYROSCOPE);
if (gyro == null) {
    // 没有陀螺仪，别折腾了
    Log.e("Gyro", "设备不支持陀螺仪");
}

我遇到过一台平板，代码跑得飞起，就是没数据。一查，好家伙，硬件列表里根本没有陀螺仪。所以第一件事，先确认硬件存在。

第二步：检查注册方式

很多人忘了注册监听器，或者注册方式不对。

// 正确的注册方式
sensorManager.registerListener(this, gyro, SensorManager.SENSOR_DELAY_GAME);

// 别忘了在onPause里取消注册
@Override
protected void onPause() {
    super.onPause();
    sensorManager.unregisterListener(this);
}

小技巧：我个人习惯在onResume里注册，onPause里取消。这样切到后台不会浪费电量，切回来又能立刻恢复。

第三步：检查采样率

采样率太低，数据更新慢得像蜗牛。采样率太高，CPU扛不住。

采样率常量 延迟(微秒) 适用场景
SENSOR_DELAY_NORMAL 200,000 屏幕旋转、普通应用
SENSOR_DELAY_UI 60,000 UI交互、游戏菜单
SENSOR_DELAY_GAME 20,000 游戏、AR应用
SENSOR_DELAY_FASTEST 0 专业测量、VR

如果你用SENSOR_DELAY_NORMAL，数据更新间隔200毫秒，感觉就像卡顿。做游戏的话，至少用SENSOR_DELAY_GAME。

二、数据异常

有数据了，但数据不对。要么飘得厉害，要么数值离谱。

1. 漂移问题

陀螺仪天生会漂移。静止时数据应该接近0，但实际往往不是。

// 静止时打印数据
@Override
public void onSensorChanged(SensorEvent event) {
    float x = event.values[0];
    float y = event.values[1];
    float z = event.values[2];
    Log.d("Gyro", "静止漂移: " + x + ", " + y + ", " + z);
}

我记得有一次做VR项目，画面一直往右偏。查了半天，发现是陀螺仪的零偏误差累积导致的。解决办法是加一个高通滤波器，或者定期做零偏校准。

注意：陀螺仪数据不能直接用于角度计算。必须积分，而积分会放大漂移误差。长时间使用一定要配合加速度计做融合。

2. 噪声过大

数据跳来跳去，像抽风一样。这通常是硬件噪声或者电磁干扰。

// 简单低通滤波
private float lowPassFilter(float input, float output, float alpha) {
    return output + alpha * (input - output);
}

// 使用示例
float filteredX = lowPassFilter(rawX, lastFilteredX, 0.2f);

alpha值越小，滤波越强，但延迟也越大。我一般取0.1到0.3之间，具体看你的应用场景。

3. 坐标系问题

Android的陀螺仪坐标系是固定的：X轴向右，Y轴向上，Z轴朝向屏幕外。但很多新手搞混了方向。

说白了，你拿着手机横屏玩游戏，和竖屏看视频，坐标系是不变的。但你的游戏逻辑可能期望不同的方向。这时候需要做坐标变换。

// 横屏游戏时，交换X和Y
float gameX = event.values[1];  // 原Y轴
float gameY = -event.values[0]; // 原X轴取反

三、权限问题

Android 6.0以后，权限管理严格了很多。陀螺仪本身不需要运行时权限，但如果你要用到传感器数据写入文件或者网络上传，那就涉及存储权限和网络权限了。

1. AndroidManifest声明

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

2. 运行时权限申请

if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE)
        != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(this,
            new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE},
            REQUEST_CODE);
}

避坑指南：我曾经遇到一个bug，在Android 11上死活写不了文件。后来发现是分区存储机制变了。Android 10及以上，不能用传统路径写文件，得用MediaStore或者getExternalFilesDir。

3. 系统级权限

有些特殊场景需要系统权限，比如修改传感器校准参数。普通应用拿不到这些权限，除非你的手机root了。

嗯，这里要提醒一句：别为了调试去root手机。root后的设备传感器数据可能被篡改，反而更难排查问题。

四、我的排查清单

每次遇到传感器问题，我都是按这个顺序查的：

  1. 硬件存在吗？——getDefaultSensor返回null？
  2. 注册了吗？——registerListener调用了没？
  3. 权限给了吗？——特别是写文件权限
  4. 采样率对吗？——别用NORMAL做游戏
  5. 数据滤波了吗？——原始数据直接用的？
  6. 坐标系对吗？——方向搞反了没？

这个清单帮我解决过至少80%的问题。剩下的20%，要么是硬件坏了，要么是系统bug。

最后一个小建议：调试传感器时，把数据实时打印到Logcat，同时用手机晃动一下。如果Logcat有反应，说明传感器在工作。如果没反应，那就是代码问题。这个方法简单粗暴，但非常有效。

公众号:蓝海资料掘金营，微信deep3321

← 上一章 📖 返回目录 下一章 →