为何AudioPlayerWidget的player.pause()方法无法生效？

你的代码无法暂停音频的核心问题是**AudioPlayer实例被放在了StatefulWidget类中**，而StatefulWidget是不可变对象——当组件因父组件重建、布局变化等原因重新创建时，会生成新的AudioPlayer实例，此时你点击暂停操作的是新实例，而非正在播放音频的那个旧实例，自然无法暂停。

另外，代码里用setState包裹pause()操作是多余的，pause()本身不需要触发UI重建，除非你要切换播放/暂停图标。

修正后的完整代码 #

import 'package:flutter/material.dart';
import 'package:just_audio/just_audio.dart';

class AudioPlayerWidget extends StatefulWidget {
  final String? initialSongPath; // 可选：传入初始音频路径

  const AudioPlayerWidget({super.key, this.initialSongPath});

  @override
  State<AudioPlayerWidget> createState() => _AudioPlayerWidgetState();
}

class _AudioPlayerWidgetState extends State<AudioPlayerWidget> {
  late final AudioPlayer _player;
  bool _isPlaying = false;

  @override
  void initState() {
    super.initState();
    _player = AudioPlayer();
    // 监听播放状态，自动更新UI
    _player.playerStateStream.listen((state) {
      setState(() {
        _isPlaying = state.playing;
      });
    });
    // 如果有初始路径，自动播放
    if (widget.initialSongPath != null) {
      _playSong(widget.initialSongPath!);
    }
  }

  Future<void> _playSong(String path) async {
    await _player.setAsset(path);
    await _player.play();
  }

  Future<void> _togglePlayPause() async {
    _isPlaying ? await _player.pause() : await _player.play();
  }

  @override
  void dispose() {
    _player.dispose(); // 页面销毁时释放音频资源，防止内存泄漏
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Container(
      child: IconButton(
        color: const Color(0xffE3E5E8),
        icon: Icon(_isPlaying ? Icons.pause : Icons.play_arrow), // 根据播放状态切换图标
        iconSize: 40.0,
        onPressed: _togglePlayPause,
      ),
    );
  }
}

关键修改说明 #

1. 将AudioPlayer移到State类中：确保组件整个生命周期内只有一个音频播放器实例，不会因StatefulWidget重建而丢失。
2. 监听播放状态自动更新UI：通过playerStateStream实时获取播放状态，自动切换播放/暂停图标，无需手动调用setState包裹音频操作。
3. 添加资源释放逻辑：在dispose方法中销毁AudioPlayer，避免内存泄漏。
4. 支持播放/暂停切换：优化按钮逻辑，实现点击切换播放状态，而非单一的暂停操作。

外部调用播放的正确方式 #

如果需要从父组件触发播放，使用GlobalKey获取State实例即可：

// 父组件中定义GlobalKey
final _audioPlayerKey = GlobalKey<_AudioPlayerWidgetState>();

// 调用播放方法
_audioPlayerKey.currentState?._playSong('assets/your_song.mp3');

// 渲染AudioPlayerWidget时绑定key
AudioPlayerWidget(key: _audioPlayerKey)

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