本文详解 android 中通过 broadcastreceiver 监听 action_screen_off 和 action_screen_on 实现视频播放器后台自动暂停/恢复的完整方案，指出常见注册逻辑错误、生命周期隐患及替代优化策略。
本文详解 android 中通过 broadcastreceiver 监听 action_screen_off 和 action_screen_on 实现视频播放器后台自动暂停/恢复的完整方案，指出常见注册逻辑错误、生命周期隐患及替代优化策略。
在 Android 开发中，许多开发者期望应用在用户按电源键锁屏（ACTION_SCREEN_OFF）时暂停视频播放，唤醒屏幕（ACTION_SCREEN_ON）后自动恢复——但实际常遇到“监听失效”“进程崩溃”“MediaPlayer 状态异常”等问题。根本原因往往不在 MediaPlayer 本身，而在于广播注册方式与生命周期管理的误用。
? 核心问题定位：IntentFilter 注册逻辑错误
您当前代码中分别创建了两个 IntentFilter 并两次调用 registerReceiver()：
IntentFilter powerButtonOff = new IntentFilter(Intent.ACTION_SCREEN_OFF); IntentFilter powerButtonOn = new IntentFilter(Intent.ACTION_SCREEN_ON); registerReceiver(powerButtonOnOff, powerButtonOff); // ❌ 覆盖式注册 registerReceiver(powerButtonOnOff, powerButtonOn); // ❌ 第二次注册会覆盖第一次（尤其在部分系统版本中）
⚠️ 关键误区：IntentFilter 不支持“追加动作”，每次 registerReceiver() 都是独立注册；若使用不同 filter 对象注册同一 BroadcastReceiver，系统可能仅响应最后一次注册的动作，或因权限/顺序问题导致 ACTION_SCREEN_OFF 完全不触发。
✅ 正确做法：单次注册，多动作合并：
// ✅ 正确：在一个 IntentFilter 中添加所有需监听的动作 IntentFilter screenFilter = new IntentFilter(); screenFilter.addAction(Intent.ACTION_SCREEN_OFF); screenFilter.addAction(Intent.ACTION_SCREEN_ON); registerReceiver(powerButtonOnOff, screenFilter); // 单次注册，双动作生效
? 完整可运行解决方案（含健壮性增强）
以下是修复后的 BroadcastReceiver 与配套生命周期管理建议：
private BroadcastReceiver powerButtonOnOff = new BroadcastReceiver() {
@Override
public void onReceive(Context context, Intent intent) {
String action = intent.getAction();
if (action == null) return;
if (Intent.ACTION_SCREEN_OFF.equals(action)) {
// 锁屏 → 暂停并保持 MediaPlayer 状态（避免 release 后无法 resume）
if (mediaPlayer != null && mediaPlayer.isPlaying()) {
mediaPlayer.pause(); // ✅ pause() 替代 stop() + release()
isPausedByScreenOff = true;
}
} else if (Intent.ACTION_SCREEN_ON.equals(action)) {
// 唤醒 → 恢复播放（仅当此前由锁屏暂停）
if (isPausedByScreenOff && mediaPlayer != null && !mediaPlayer.isPlaying()) {
try {
mediaPlayer.start();
isPausedByScreenOff = false;
} catch (IllegalStateException e) {
// MediaPlayer 状态异常时重建（如被系统回收）
resetMediaPlayer(context);
}
}
}
}
};
// 辅助状态标记（避免误恢复）
private boolean isPausedByScreenOff = false;
// 可选：安全重建 MediaPlayer 的方法
private void resetMediaPlayer(Context context) {
if (mediaPlayer != null) {
mediaPlayer.release();
mediaPlayer = null;
}
// 假设 videoView 是 VideoView 或 ExoPlayer 封装，此处应重新初始化播放器
// 示例（VideoView）：
// binding.videoView.setVideoURI(Uri.parse("android.resource://" + getPackageName() + "/" + R.raw.your_video));
// binding.videoView.start();
}
⚠️ 重要注意事项与替代建议
权限已过时：
自 Android 5.0（API 21）起为系统签名权限，第三方应用无法获取，且 ACTION_SCREEN_OFF/ON 广播在 Android 8.0+（API 26）起对后台应用受限。您的 AndroidManifest.xml 中该权限无效且可能引发审核风险，请立即移除。 前台服务 + WakeLock 更可靠（推荐）：
若需强保活（如音乐/视频后台播放），应结合 ForegroundService + PowerManager.WakeLock（需），并在 onStartCommand() 中 acquire，在 onDestroy() 中 release。单纯依赖屏幕广播在高版本 Android 上成功率极低。 -
生命周期同步：
registerReceiver() 应在 onResume() 中调用，unregisterReceiver() 必须在 onPause() 中执行（而非 onDestroy()），否则 Activity 销毁前未解注册将导致内存泄漏或空指针异常：@Override protected void onResume() { super.onResume(); registerReceiver(powerButtonOnOff, screenFilter); } @Override protected void onPause() { super.onPause(); unregisterReceiver(powerButtonOnOff); } 现代替代方案：
对于新项目，强烈建议迁移到 MediaSession + AudioFocus 架构，并使用 ExoPlayer 配合 PlayerNotificationManager 实现系统级媒体控制与锁屏兼容，其对 SCREEN_OFF/ON 的响应更稳定，且天然支持后台播放与通知栏控制。
✅ 总结
实现锁屏自动暂停视频的关键在于：单 IntentFilter 多动作注册、使用 pause()/start() 代替 stop()/release()、严格匹配生命周期注册/解注册、摒弃无效系统权限。同时需清醒认知 Android 后台限制演进趋势——面向未来，应优先采用 ForegroundService + MediaSession + ExoPlayer 的组合方案，兼顾兼容性、稳定性与用户体验。
