Flutter后台音频播放报错：AndroidManifest中Activity配置错误求解

1. 修正AndroidManifest.xml中的Activity配置 #

• 确保主Activity继承自FlutterFragmentActivity（而非FlutterActivity），后台音频播放依赖Fragment支持
• 示例Manifest配置：

  <activity
      android:name=".MainActivity"
      android:exported="true"
      android:launchMode="singleTop"
      android:theme="@style/LaunchTheme"
      android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
      android:hardwareAccelerated="true"
      android:windowSoftInputMode="adjustResize">
      <meta-data
          android:name="io.flutter.embedding.android.NormalTheme"
          android:resource="@style/NormalTheme"/>
      <intent-filter>
          <action android:name="android.intent.action.MAIN"/>
          <category android:name="android.intent.category.LAUNCHER"/>
      </intent-filter>
  </activity>
  

• 对应MainActivity代码需正确初始化FlutterEngine：

  class MainActivity : FlutterFragmentActivity() {
      override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
          super.configureFlutterEngine(flutterEngine)
          // 自定义插件注册可在此添加
      }
  }
  

2. 正确配置音频服务的FlutterEngine绑定 #

• 在AndroidManifest.xml中注册音频服务，并指定前台服务类型：

  <service android:name="com.example.yourapp.AudioPlayerService"
      android:foregroundServiceType="mediaPlayback"
      android:exported="false">
      <intent-filter>
          <action android:name="android.media.browse.MediaBrowserService" />
      </intent-filter>
  </service>
  

• 服务类中通过FlutterEngineCache获取预初始化的引擎，避免后台启动时引擎冲突：

  class AudioPlayerService : MediaBrowserServiceCompat() {
      private lateinit var flutterEngine: FlutterEngine
      override fun onCreate() {
          super.onCreate()
          flutterEngine = FlutterEngineCache.getInstance().get("audio_engine") ?: run {
              FlutterEngine(this).apply {
                  FlutterEngineCache.getInstance().put("audio_engine", this)
                  dartExecutor.executeDartEntrypoint(
                      DartExecutor.DartEntrypoint.createDefault()
                  )
              }
          }
      }
  }
  

3. 在Application类预初始化FlutterEngine #

• 创建自定义Application类，提前初始化FlutterEngine并加入缓存，确保后台服务能复用同一引擎：

  class MyApp : Application() {
      override fun onCreate() {
          super.onCreate()
          val flutterEngine = FlutterEngine(this)
          flutterEngine.dartExecutor.executeDartEntrypoint(
              DartExecutor.DartEntrypoint.createDefault()
          )
          FlutterEngineCache.getInstance().put("audio_engine", flutterEngine)
      }
  }
  

• 在AndroidManifest.xml中指定该Application：

  <application
      android:name=".MyApp"
      ...>
      ...
  </application>
  

4. 检查audio_handler包配置 #

• 确保使用最新稳定版的audio_handler包，避免版本兼容问题
• Dart代码中初始化AudioHandler时使用标准工厂方法：

  final audioHandler = await AudioHandlerFactory.createAudioHandler();
  

• 确认后台隔离区代码无引擎初始化冲突，所有音频操作均通过已绑定的AudioHandler执行

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