前台服务中onSensorChanged()无回调、息屏后线性加速度传感器停更问题

一、onSensorChanged未触发的通用排查方向 #

如果传感器在亮屏状态下也没有回调，可以先排查以下问题：

• 未执行传感器监听器注册逻辑，或注册参数错误：需确认调用了mSensorManager.registerListener()方法，传入的监听器实例、传感器实例有效，采样周期参数合法
• 设备不支持线性加速度传感器：需添加判空逻辑，避免mAccelerometer为空导致注册失败
• 未申请必要权限：部分系统要求动态申请ACTIVITY_RECOGNITION权限才能使用运动类传感器，需在AndroidManifest.xml中声明并在运行时动态申请
• 前台服务未正常启动：Android 8.0及以上系统要求前台服务必须调用startForeground()绑定合法通知，否则服务会被系统回收，传感器监听自然失效

二、息屏状态下传感器停止更新的修复方案 #

你排查到的息屏停更问题是Android系统默认的低功耗策略，系统会在息屏后关闭非唤醒类传感器的事件上报，避免不必要的耗电，可通过以下方案修复：

方案1：注册传感器时添加唤醒标志 #

Android 5.0及以上系统支持给传感器设置唤醒标志，设置后即使设备息屏，传感器也会唤醒应用处理器上报事件，注册代码如下：

// 第四个参数为事件上报最大延迟，设置0表示实时上报；第五个参数添加唤醒标志
mSensorManager.registerListener(
    this,
    mAccelerometer,
    SensorManager.SENSOR_DELAY_NORMAL, // 可根据需求调整采样精度
    0,
    SensorManager.SENSOR_FLAG_WAKE_UP
)

注意：该方案仅当设备的线性加速度传感器支持唤醒属性时生效，大部分主流机型都支持该属性

方案2：持有CPU唤醒锁 #

如果添加唤醒标志后仍然无响应，是因为系统息屏后CPU进入休眠状态，无法处理传感器事件，需要持有部分唤醒锁保持CPU运行：

1. 先在AndroidManifest.xml中添加权限声明：

<uses-permission android:name="android.permission.WAKE_LOCK" />

2. 在服务启动时初始化并持有唤醒锁：

val powerManager = getSystemService(POWER_SERVICE) as PowerManager
// 第二个参数为自定义的锁标签，方便系统调试用
val wakeLock = powerManager.newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, "MyApp:AccelSensorLock")
// 建议设置超时时间，避免应用异常时一直持有锁导致耗电严重，这里设置1小时为例
wakeLock.acquire(60 * 60 * 1000L)

3. 在服务销毁时必须释放唤醒锁：

override fun onDestroy() {
    super.onDestroy()
    mSensorManager.unregisterListener(this)
    if (wakeLock.isHeld) {
        wakeLock.release()
    }
}

方案3：适配厂商定制系统限制 #

国内小米、华为、OPPO、vivo等厂商的定制系统会有额外的电量优化策略，即使设置了上述参数，仍然可能拦截息屏传感器事件，需要引导用户将应用加入系统的电量优化白名单，关闭后台活动限制。

方案4：适配高版本Android系统要求 #

Android 12及以上系统使用传感器类前台服务，需要在AndroidManifest.xml的服务声明中添加前台服务类型：

<service
    android:name=".ForegroundService"
    android:foregroundServiceType="sensors"
    android:exported="false" />

同时需要在启动前台服务时动态申请FOREGROUND_SERVICE_SENSORS权限。

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