基于audio-service插件获取歌曲标题后台更新的最优实现方式

免责声明：本方案仅适用于audio_service插件0.18.1及更高版本。

核心问题解答 #

WebSocket连接不需要单独创建新isolate，直接放在AudioHandler内部实现即可，这是满足后台更新需求的最优方案，原因如下：

• audio_service的AudioHandler默认运行在独立的后台 isolate 中，生命周期和音频播放任务绑定，只要音频还在后台播放，该isolate就会持续存活，完全不受主UI isolate被系统暂停、回收的影响，能稳定在后台接收WebSocket推送的歌曲更新信息。
• 无需额外处理跨isolate通信逻辑，收到元数据更新后可直接更新内部的mediaItem流，audio_service会自动同步最新的歌曲信息到系统控制中心、通知栏、锁屏等系统媒体控制组件，不需要额外的适配工作。

核心实现逻辑示例 #

import 'package:audio_service/audio_service.dart';
import 'package:web_socket_channel/web_socket_channel.dart';

class RadioAudioHandler extends BaseAudioHandler {
  WebSocketChannel? _wsChannel;

  @override
  Future<void> init() async {
    // 初始化你的音频播放器逻辑，加载广播流地址
    // ...

    // 初始化WebSocket连接
    _wsChannel = WebSocketChannel.connect(Uri.parse('你的WebSocket服务地址'));
    // 监听歌曲更新推送
    _wsChannel?.stream.listen((rawData) {
      final songMeta = jsonDecode(rawData);
      // 更新当前媒体元数据，自动同步到系统控制中心
      final currentItem = mediaItem.value;
      if (currentItem != null) {
        mediaItem.add(currentItem.copyWith(
          title: songMeta['title'],
          artist: songMeta['artist'],
          // 可补充封面等其他元数据
        ));
      }
    }, onError: (e) {
      // 可在此处实现断开自动重连逻辑
    });

    await super.init();
  }

  @override
  Future<void> dispose() async {
    // 销毁时主动关闭WebSocket连接，避免资源泄漏
    _wsChannel?.sink.close();
    await super.dispose();
  }

  // 其他音频控制逻辑实现
  // ...
}

额外注意事项 #

• 如果需要把最新的歌曲信息同步到前台UI展示，直接监听AudioHandler暴露的mediaItem流即可，audio_service已经封装好了主isolate和后台AudioHandler isolate之间的通信通道，不需要自行实现跨isolate数据传递。
• 不要单独创建新的isolate运行WebSocket，反而会增加跨isolate通信的复杂度和资源管理成本，没有额外收益。

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