Flutter使用just_audio包显示均衡器遇未实现错误求助

问题详情 #

显示均衡器时触发以下报错：

[ERROR:flutter/runtime/dart_vm_initializer.cc(41)] Unhandled Exception: UnimplementedError: audioEffectSetEnabled() has not been implemented.

代码完全遵循just-audio官方示例编写，在测试项目中可正常运行，但当前项目中失效。相关代码逻辑如下：

音频播放器初始化代码 #

late AudioPlayer _audioPlayer;
late Equalizer _equalizer;

@override
void initState() {
  super.initState();
  _initAudioPlayer();
}

Future<void> _initAudioPlayer() async {
  _audioPlayer = AudioPlayer();
  await _audioPlayer.setUrl('音频资源链接');
  _equalizer = Equalizer(audioPlayer: _audioPlayer);
  await _equalizer.setEnabled(true);
}

均衡器访问代码 #

// 获取均衡器频段列表
final bands = _equalizer.bands;
// 设置指定频段增益
void setBandGain(int index, double gain) {
  _equalizer.setBandGain(bands[index], gain);
}

可能的修复方案 #

• 统一依赖版本
  检查当前项目与测试项目的just-audio及平台适配包（just_audio_android/just_audio_ios）版本是否一致，执行以下命令同步版本：

  flutter pub upgrade just-audio
  flutter pub get
  

  确保pubspec.yaml中已正确引入对应平台的适配依赖，且版本与just-audio兼容。

• 完善平台权限配置

  • Android：在AndroidManifest.xml中添加音频权限：

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

  • iOS：在Info.plist中配置音频会话相关权限，确保项目音频环境配置正确。

• 调整初始化顺序
  避免在播放器未完成初始化时启用均衡器，优化初始化逻辑：

  Future<void> _initAudioPlayer() async {
    _audioPlayer = AudioPlayer();
    // 先配置音频会话
    final session = await AudioSession.instance;
    await session.configure(AudioSessionConfiguration.music());
    // 再设置音频源
    await _audioPlayer.setUrl('音频资源链接');
    // 最后初始化并启用均衡器
    _equalizer = Equalizer(audioPlayer: _audioPlayer);
    try {
      await _equalizer.setEnabled(true);
    } catch (e) {
      print("均衡器启用失败: $e");
      // 添加降级逻辑，例如隐藏均衡器UI
    }
  }
  

• 排查插件冲突
  当前项目若存在其他音频类插件（如audio_service、flutter_sound），可能与just-audio产生冲突，尝试暂时移除其他音频插件后测试，逐步定位冲突源。

• 升级Flutter SDK
  若当前项目使用的Flutter版本过旧，可能存在API兼容问题，执行flutter upgrade升级到稳定版后重试。

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