Flutter应用启动自动播放音乐且切换页面后持续播放问题求助

核心问题原因 #

• 跳转页面音乐停止：你将AudioPlayer实例定义在首页的State中，调用Navigator.pushReplacement跳转页面时，原首页会被销毁，触发dispose方法直接释放了播放器实例，导致音乐中断。
• 无法自动播放：你仅在initState中初始化了播放器，没有调用播放方法，同时dispose中多余的播放逻辑属于无效代码。

具体实现方案 #

步骤1：创建全局音频管理单例 #

将播放器逻辑抽成全局单例，保证应用生命周期内只有一个播放器实例，不受页面切换影响：

import 'package:audioplayers/audioplayers.dart';

class AudioManager {
  static final AudioManager _instance = AudioManager._internal();
  factory AudioManager() => _instance;
  AudioManager._internal();

  late AudioPlayer audioPlayer;
  late AudioCache audioCache;
  AudioPlayerState audioPlayerState = AudioPlayerState.PAUSED;
  final String bgmPath = 'music.mp3';

  Future<void> init() async {
    audioPlayer = AudioPlayer();
    audioCache = AudioCache(fixedPlayer: audioPlayer);
    audioPlayer.onPlayerStateChanged.listen((state) {
      audioPlayerState = state;
    });
  }

  Future<void> playBgm() async {
    if (audioPlayerState != AudioPlayerState.PLAYING) {
      await audioCache.play(bgmPath);
    }
  }

  Future<void> pauseBgm() async {
    if (audioPlayerState == AudioPlayerState.PLAYING) {
      await audioPlayer.pause();
    }
  }

  Future<void> togglePlay() async {
    audioPlayerState == AudioPlayerState.PLAYING ? pauseBgm() : playBgm();
  }
}

步骤2：应用启动时初始化并自动播放 #

修改main函数，在应用启动时完成播放器初始化和自动播放逻辑：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 初始化全局播放器
  await AudioManager().init();
  // 自动播放背景音乐
  await AudioManager().playBgm();
  runApp(TinyAppli());
}

步骤3：改造原有页面逻辑 #

移除页面内定义的播放器相关变量，改用全局单例，删除页面销毁时释放播放器的逻辑：

class _TinyApplicationState extends State<TinyApplication> {
  @override
  void initState() {
    super.initState();
    // 监听播放状态更新UI
    AudioManager().audioPlayer.onPlayerStateChanged.listen((AudioPlayerState s) {
      if (mounted) setState(() {});
    });
  }

  @override
  void dispose() {
    super.dispose();
    // 不要在这里销毁播放器，全局播放器在应用退出时自动释放
  }

  IconButton musicPlay() {
    return IconButton(
      onPressed: () => AudioManager().togglePlay(),
      icon: Icon(AudioManager().audioPlayerState == AudioPlayerState.PLAYING
          ? Icons.pause_rounded
          : Icons.play_arrow_rounded
      ),
    );
  }

  // 其余build、页面跳转等原有逻辑保持不变即可
}

注意事项 #

• 确保你的音频文件存放在assets目录下，且在pubspec.yaml中正确声明资源：

flutter:
  assets:
    - assets/music.mp3

• iOS端如果需要后台持续播放，需要在Info.plist中添加音频后台权限：

<key>UIBackgroundModes</key>
<array>
  <string>audio</string>
</array>

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