Flutter Web中just_audio切换音频URL触发PlatformException问题求助

问题描述 #

使用just_audio ^0.9.35切换音频URL时，仅Web端抛出两类PlatformException异常，Android与iOS平台运行正常：

• PlatformException(abort, Loading interrupted, null, null)
• PlatformException(error, Platform player xxx already exists, null, null)

相关代码示例：

setPlayer(String url) async {
  try {
    _selectedMood = moodBloc.state.selectedMood;
    await _stopPlayer();
    await _player.setVolume(_getVolumeValue(state.volume));
    await _player.setUrl(url);
    _subscribeToStream();
  } catch (e) {
    print('set player error====e');
  }
}

原因分析 #

Web端音频播放器的实例生命周期管理逻辑与移动端不同，直接复用旧实例切换URL时，容易出现资源未彻底释放、加载流程中断或实例重复创建的冲突问题。

解决方案 #

1. 销毁旧实例后重新初始化 #

切换音频时先彻底释放旧播放器资源，再创建新实例，避免实例冲突：

setPlayer(String url) async {
  try {
    _selectedMood = moodBloc.state.selectedMood;
    await _stopPlayer();
    await _player.dispose(); // 销毁旧实例
    _player = AudioPlayer(); // 重新初始化播放器
    
    await _player.setVolume(_getVolumeValue(state.volume));
    await _player.setUrl(url);
    _subscribeToStream();
  } catch (e) {
    print('set player error====$e');
  }
}

注意：确保_player为可重新赋值的变量（如定义为AudioPlayer? _player;）。

2. 优化_stopPlayer方法，确保资源完全释放 #

完善停止逻辑，重置播放位置并取消流订阅：

Future<void> _stopPlayer() async {
  if (_player != null) {
    await _player.stop();
    await _player.seek(Duration.zero); // 重置播放进度
    _playerSubscription?.cancel(); // 取消之前的流订阅
  }
}

3. 避免重复执行切换逻辑 #

增加URL判断，当目标URL与当前播放URL一致时，跳过切换流程：

setPlayer(String url) async {
  try {
    if (_player?.currentSource?.uri.toString() == url) return; // 跳过重复操作
    
    _selectedMood = moodBloc.state.selectedMood;
    await _stopPlayer();
    await _player.dispose();
    _player = AudioPlayer();
    
    await _player.setVolume(_getVolumeValue(state.volume));
    await _player.setUrl(url);
    _subscribeToStream();
  } catch (e) {
    print('set player error====$e');
  }
}

4. 增加Web端异常重试机制 #

针对Web端的初始化异常，添加有限次数的重试逻辑：

setPlayer(String url) async {
  int retryCount = 0;
  const maxRetries = 2;
  while (retryCount < maxRetries) {
    try {
      if (_player?.currentSource?.uri.toString() == url) return;
      
      _selectedMood = moodBloc.state.selectedMood;
      await _stopPlayer();
      if (_player != null) await _player.dispose();
      _player = AudioPlayer();
      
      await _player.setVolume(_getVolumeValue(state.volume));
      await _player.setUrl(url);
      _subscribeToStream();
      break;
    } catch (e) {
      retryCount++;
      print('set player error (retry $retryCount)====$e');
      if (retryCount >= maxRetries) {
        // 处理最终失败场景，如提示用户
      }
    }
  }
}

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