Ionic 5背景模式插件在Android 12（API 31）下失效求助

针对升级到Android12后Background Mode插件失效的问题，核心原因是Android12对后台服务权限做了更严格的限制，以下是具体解决步骤：

• 添加Android12所需权限
  在platforms/android/app/src/main/AndroidManifest.xml中补充以下权限：

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

  注意：FOREGROUND_SERVICE_MEDIA_PLAYBACK是Android12新增的媒体播放专用前台服务权限，替代原来通用的FOREGROUND_SERVICE。

• 升级或替换后台插件

  • 先升级现有插件到适配API31的版本：

    ionic cordova plugin update cordova-plugin-background-mode
    npm update @ionic-native/background-mode
    

  • 如果升级后仍无效，建议替换为专门针对媒体播放的插件，比如cordova-plugin-media-with-controls，它内置了Android12的前台服务适配。

• 调整后台模式配置，强制启用前台服务
  修改后台模式初始化代码，明确配置媒体会话和前台服务参数：

  import { BackgroundMode } from '@ionic-native/background-mode/ngx';
  
  constructor(private backgroundMode: BackgroundMode) {}
  
  initBackgroundMode() {
    this.backgroundMode.configure({
      title: '音频播放中',
      text: '正在后台播放',
      icon: 'res://icon',
      color: '#2196F3',
      mediaSession: true, // 启用媒体会话，适配Android12媒体通知规范
      foreground: true, // 强制以前台服务运行
      hidden: false // 确保通知可见，Android12要求前台服务必须显示通知
    });
  }
  
  // 在音频播放前启用后台模式
  startAudioPlayback() {
    this.backgroundMode.enable();
    // 这里执行你的音频播放逻辑
  }
  

• 处理应用生命周期切换
  监听应用前后台切换事件，确保后台时维持前台服务：

  import { Platform } from '@ionic/angular';
  
  constructor(private platform: Platform) {}
  
  ngOnInit() {
    this.platform.pause.subscribe(() => {
      // 若音频正在播放，强制将后台服务转为前台
      if (this.audioService.isPlaying()) {
        this.backgroundMode.moveToForeground();
      }
    });
  }
  

• 调试与权限验证

  • 使用Android Studio的Logcat查看日志，搜索BackgroundMode或ForegroundService相关报错，定位权限或服务启动失败的具体原因。
  • 测试时确保手动授予应用通知权限，Android12默认不会自动授予该权限，无权限则前台服务无法启动。

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