Flutter无按键自动播放音乐：initState播放中途停止问题求助

针对你遇到的initState中播放音乐中途停止的问题，可通过以下步骤解决：

核心问题分析 #

音乐中途停止通常是因为音频会话未正确配置，系统限制了后台/自动播放权限，或是播放器实例的生命周期管理不当。

修正后的实现代码 #

import 'package:audioplayers/audioplayers.dart';
import 'package:audioplayers/audio_session.dart';

class _YourPageState extends State<YourPage> {
  late AudioPlayer _player;

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

  Future<void> _setupAutoPlayMusic() async {
    // 配置音频会话，允许后台播放、与其他音频混音
    final audioSession = await AudioSession.instance;
    await audioSession.configure(const AudioSessionConfiguration(
      // iOS 配置
      avAudioSessionCategory: AVAudioSessionCategory.playback,
      avAudioSessionCategoryOptions: AVAudioSessionCategoryOptions.mixWithOthers,
      // Android 配置
      androidAudioAttributes: AndroidAudioAttributes(
        contentType: AndroidAudioContentType.music,
        usage: AndroidAudioUsage.media,
      ),
    ));

    // 初始化播放器
    _player = AudioPlayer();
    await _player.setAsset("assets/mainmusic.mp3");
    await _player.setLoopMode(LoopMode.all);
    await _player.play();
  }

  @override
  void dispose() {
    // 页面销毁时释放播放器资源
    _player.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    // 你的页面布局
    return Scaffold();
  }
}

必要的平台配置 #

iOS #

在Info.plist中添加后台播放权限：

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

Android #

在AndroidManifest.xml中添加权限：

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

关键注意事项 #

• 确保pubspec.yaml中已正确声明音频资源：

  assets:
    - assets/mainmusic.mp3
  

• 避免将播放器实例声明为局部变量，需作为State类的成员变量，防止被GC回收导致播放中断。
• 若仍出现问题，检查音频文件格式是否支持（推荐MP3、AAC），文件路径是否正确。

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