Flutter应用实现蓝牙耳机控制音频播放/暂停功能方案咨询

要让蓝牙设备的按键控制音频播放/暂停，核心是让应用响应系统的媒体按键事件——audioplayer本身没有内置这个能力，推荐用audio_service包来实现，它能帮你处理媒体会话管理，自动监听蓝牙、耳机线控等媒体按键，同时可以和audioplayer无缝集成。

具体实现步骤 #

1. 添加依赖 #

在pubspec.yaml里补充依赖：

dependencies:
  audioplayer: ^你的现有版本号
  audio_service: ^0.18.10 # 可替换为最新稳定版

2. 创建音频任务类 #

这个类负责封装播放逻辑和媒体按键响应：

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

class AudioPlayerTask extends BaseAudioTask {
  final AudioPlayer _player = AudioPlayer();
  bool _isPlaying = false;

  @override
  Future<void> onStart(Map<String, dynamic>? params) async {
    // 初始化音频源（本地文件/网络链接都可以）
    await _player.play('你的音频路径');
    _isPlaying = true;
    // 同步播放状态给系统，让蓝牙设备能识别当前状态
    await AudioServiceBackground.setState(
      controls: [MediaControl.pause],
      playing: true,
      processingState: AudioProcessingState.ready,
    );
  }

  @override
  Future<void> onPause() async {
    await _player.pause();
    _isPlaying = false;
    await AudioServiceBackground.setState(
      controls: [MediaControl.play],
      playing: false,
      processingState: AudioProcessingState.ready,
    );
  }

  @override
  Future<void> onPlay() async {
    await _player.resume();
    _isPlaying = true;
    await AudioServiceBackground.setState(
      controls: [MediaControl.pause],
      playing: true,
      processingState: AudioProcessingState.ready,
    );
  }

  @override
  Future<void> onStop() async {
    await _player.stop();
    await AudioServiceBackground.setState(
      controls: [],
      playing: false,
      processingState: AudioProcessingState.stopped,
    );
    await super.onStop();
  }
}

3. 启动音频服务 #

在UI页面的播放触发逻辑里启动服务：

// 启动播放服务
await AudioService.start(
  backgroundTaskEntrypoint: _audioPlayerTaskEntrypoint,
  androidNotificationChannelName: '音频播放控制',
  androidNotificationIcon: 'mipmap/ic_launcher', // 替换为你的通知图标
);

// 定义后台任务入口
void _audioPlayerTaskEntrypoint() async {
  AudioServiceBackground.run(() => AudioPlayerTask());
}

4. 同步UI与播放状态 #

通过流监听播放状态，更新UI按钮：

StreamBuilder<PlaybackState>(
  stream: AudioService.playbackStateStream,
  builder: (context, snapshot) {
    final isPlaying = snapshot.data?.playing ?? false;
    return IconButton(
      icon: Icon(isPlaying ? Icons.pause : Icons.play_arrow),
      onPressed: () => isPlaying ? AudioService.pause() : AudioService.play(),
    );
  },
)

替代方案：原生平台通道（不推荐，繁琐） #

如果不想用audio_service，可以自己写原生代码监听媒体按键：

• Android：注册MediaButtonReceiver广播接收器，捕获按键事件后通过MethodChannel通知Flutter。
• iOS：用MPRemoteCommandCenter注册播放/暂停命令，通过MethodChannel回调Flutter逻辑。

这种方法需要分别维护iOS和Android的原生代码，成本较高，优先推荐audio_service方案。

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