Flutter音频播放插件kplayer_with_just_audio的使用

kplayer_with_just_audio 是一个基于 just_audio 的 Flutter 音频播放插件，它提供了更高级的功能和更灵活的配置选项。just_audio 是一个非常流行的 Flutter 音频播放库，支持多种音频格式和播放模式。kplayer_with_just_audio 在此基础上进行了扩展，提供了更多的功能和更好的用户体验。

安装

首先，你需要在 pubspec.yaml 文件中添加 kplayer_with_just_audio 依赖：

dependencies:
  flutter:
    sdk: flutter
  kplayer_with_just_audio: ^0.1.0  # 请根据实际情况使用最新版本

然后运行 flutter pub get 来安装依赖。

基本用法

1. 初始化播放器

首先，你需要初始化 KPlayer 实例：

import 'package:kplayer_with_just_audio/kplayer_with_just_audio.dart';

final KPlayer player = KPlayer();

2. 设置音频源

你可以通过 setSource 方法来设置音频源。音频源可以是网络 URL、本地文件路径或 Asset 文件。

await player.setSource(KPlayerSource.network('https://example.com/audio.mp3'));

3. 播放音频

使用 play 方法来开始播放音频：

await player.play();

4. 暂停音频

使用 pause 方法来暂停播放：

await player.pause();

5. 停止音频

使用 stop 方法来停止播放：

await player.stop();

6. 调整音量

你可以通过 setVolume 方法来调整音量，音量范围是 0.0 到 1.0：

await player.setVolume(0.5);

7. 调整播放速度

你可以通过 setSpeed 方法来调整播放速度，速度范围是 0.5 到 2.0：

await player.setSpeed(1.5);

8. 跳转到指定位置

你可以通过 seek 方法跳转到音频的指定位置（以毫秒为单位）：

await player.seek(Duration(milliseconds: 5000));

9. 监听播放状态

你可以通过 playerStateStream 来监听播放器的状态变化：

player.playerStateStream.listen((state) {
  print('Player state: $state');
});

10. 监听播放进度

你可以通过 positionStream 来监听音频的播放进度：

player.positionStream.listen((position) {
  print('Current position: $position');
});

高级功能

1. 循环播放

你可以通过 setLoopMode 方法来设置循环播放模式：

await player.setLoopMode(LoopMode.one);  // 单曲循环

2. 播放列表

你可以通过 setPlaylist 方法来设置播放列表：

await player.setPlaylist([
  KPlayerSource.network('https://example.com/audio1.mp3'),
  KPlayerSource.network('https://example.com/audio2.mp3'),
]);

3. 自定义音频源

你可以通过 KPlayerSource 类来自定义音频源，例如设置标题、艺术家、封面等信息：

await player.setSource(KPlayerSource.network(
  'https://example.com/audio.mp3',
  title: 'Song Title',
  artist: 'Artist Name',
  albumArtUrl: 'https://example.com/cover.jpg',
));

释放资源

在不再需要使用播放器时，记得调用 dispose 方法来释放资源：

await player.dispose();

示例代码

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

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: AudioPlayerScreen(),
    );
  }
}

class AudioPlayerScreen extends StatefulWidget {
  [@override](/user/override)
  _AudioPlayerScreenState createState() => _AudioPlayerScreenState();
}

class _AudioPlayerScreenState extends State<AudioPlayerScreen> {
  final KPlayer player = KPlayer();

  [@override](/user/override)
  void initState() {
    super.initState();
    _initPlayer();
  }

  Future<void> _initPlayer() async {
    await player.setSource(KPlayerSource.network(
      'https://example.com/audio.mp3',
      title: 'Song Title',
      artist: 'Artist Name',
      albumArtUrl: 'https://example.com/cover.jpg',
    ));
  }

  [@override](/user/override)
  void dispose() {
    player.dispose();
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Audio Player'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            StreamBuilder<Duration>(
              stream: player.positionStream,
              builder: (context, snapshot) {
                final position = snapshot.data ?? Duration.zero;
                return Text('Position: ${position.inSeconds}');
              },
            ),
            StreamBuilder<PlayerState>(
              stream: player.playerStateStream,
              builder: (context, snapshot) {
                final state = snapshot.data ?? PlayerState.stopped;
                return Text('State: $state');
              },
            ),
            Row(
              mainAxisAlignment: MainAxisAlignment.center,
              children: [
                IconButton(
                  icon: Icon(Icons.play_arrow),
                  onPressed: () => player.play(),
                ),
                IconButton(
                  icon: Icon(Icons.pause),
                  onPressed: () => player.pause(),
                ),
                IconButton(
                  icon: Icon(Icons.stop),
                  onPressed: () => player.stop(),
                ),
              ],
            ),
          ],
        ),
      ),
    );
  }
}