Just Audio平台播放器已存在异常：Android特定版本问题问询

错误含义解析 #

PlatformException(Platform player [ID] already exists) 错误说明你尝试初始化的just_audio平台层播放器实例已存在——同一个播放器ID被重复创建，引发实例冲突，最终导致初始化失败、音频无法播放。

版本差异原因 #

Android不同版本的后台进程管理、生命周期回调机制存在明显差异：

• Android 10：系统对后台进程的回收策略宽松，APP进入后台后进程可能长时间存活。当用户再次打开APP时，旧的AudioPlayer或AudioHandler实例未被正确销毁，新启动的代码又尝试创建新实例，重复冲突频繁触发。
• Android 12+：系统后台管理更严格，会更彻底清理闲置进程或实例，旧实例残留概率低，因此仅偶尔出现问题。

修复方案 #

1. 严格管控AudioPlayer生命周期 #

在MyAudioHandler中，确保播放器实例在handler销毁时被正确释放，避免残留：

class MyAudioHandler extends BaseAudioHandler {
  final _player = AudioPlayer();

  // ... 其他业务逻辑 ...

  @override
  Future<void> dispose() async {
    await _player.dispose(); // 销毁播放器实例
    super.dispose();
  }
}

2. 避免重复配置AudioSession #

不要在每次加载音频时重复配置会话，将配置逻辑放在MyAudioHandler初始化阶段，确保仅执行一次：

class MyAudioHandler extends BaseAudioHandler {
  final _player = AudioPlayer();

  MyAudioHandler() {
    _initAudioSession();
  }

  Future<void> _initAudioSession() async {
    final session = await AudioSession.instance;
    await session.configure(const AudioSessionConfiguration.music());
  }

  Future<void> _loadRadio() async {
    try {
      await _player.setAudioSource(AudioSource.uri(Uri.parse([stream_address])));
    } catch (e) {
      print("Error loading audio source: $e");
    }
  }
}

3. 防止AudioService重复初始化 #

在main.dart中先检查AudioService是否已运行，避免重复初始化引发冲突：

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();

  if (!await AudioService.running) {
    myAudioHandler = await AudioService.init(
      builder: () => MyAudioHandler(),
      config: const AudioServiceConfig(
        androidNotificationChannelId: 'com.ryanheise.myapp.channel.audio',
        androidNotificationChannelName: 'Audio playback',
        androidNotificationOngoing: true,
      ),
    );
  } else {
    // 连接已运行的服务，复用现有handler
    myAudioHandler = await AudioService.connect();
  }

  runApp(MyApp());
}

4. 适配Android 10生命周期 #

监听APP生命周期，在后台时主动暂停播放、清理资源，降低实例残留概率：

// 在主页面或MyApp中添加监听
@override
void didChangeAppLifecycleState(AppLifecycleState state) {
  super.didChangeAppLifecycleState(state);
  if (state == AppLifecycleState.paused) {
    myAudioHandler.pause();
  }
}

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