Flutter音频媒体处理插件just_audio_media_kit的使用

just_audio_media_kit 是一个为 just_audio 提供 media_kit 绑定的Flutter插件，它允许开发者在Linux和Windows等平台上进行更强大的音频处理。以下是关于如何使用这个插件的详细指南。

安装

在你的 pubspec.yaml 中：

dependencies:
  just_audio_media_kit: ^2.0.0

  # 根据你的使用情况选择原生 media_kit 库：
  # 注意：如果你已经包含了视频库，这些音频库是不必要的。
  media_kit_libs_linux: any
  media_kit_libs_windows_audio: any

注意: 对于Android、iOS和macOS，你也可以使用 just_audio_media_kit，但需要确保包含所需的依赖项，并在 ensureInitialized() 方法中启用它们。不过，这不是必需的，因为它们已经被 just_audio 原生支持。

使用mimalloc（可选）

为了防止内存泄漏，建议用mimalloc替换默认的内存分配器。这可以通过向linux/CMakeLists.txt添加一行来实现：

target_link_libraries(${BINARY_NAME} PRIVATE ${MIMALLOC_LIB})

初始化AudioPlayer

在使用 AudioPlayer 之前，必须调用 JustAudioMediaKit.ensureInitialized() 来初始化平台特定的功能。

// 默认情况下，Windows和Linux是启用的
JustAudioMediaKit.ensureInitialized();

// 或者，如果你想手动配置启用的平台：
// 确保为每个启用的平台包含 pubspec.yaml 中所需的依赖项！
JustAudioMediaKit.ensureInitialized(
    linux: true,            // 默认：true  - 依赖：media_kit_libs_linux
    windows: true,          // 默认：true  - 依赖：media_kit_libs_windows_audio
    android: true,          // 默认：false - 依赖：media_kit_libs_android_audio
    iOS: true,              // 默认：false - 依赖：media_kit_libs_ios_audio
    macOS: true,            // 默认：false - 依赖：media_kit_libs_macos_audio
);

插件特定配置

以下是一些可以设置的参数，这些参数必须在播放器初始化之前或之后立即设置，否则它们将不起作用。

• MPV日志级别:

  JustAudioMediaKit.mpvLogLevel = MPVLogLevel.debug;
  

• 解复用器缓存大小（字节）:

  JustAudioMediaKit.bufferSize = 8 * 1024 * 1024; // 8 MB
  

• 本地后端窗口和进程名称:

  JustAudioMediaKit.title = 'My Audio Player App';
  

• 允许的协议列表:

  JustAudioMediaKit.protocolWhitelist = const ['http', 'https'];
  

• 音高控制:

  JustAudioMediaKit.pitch = true;
  

• 无缝播放:

  JustAudioMediaKit.prefetchPlaylist = true;
  

• 手动指定libmpv路径（高级）:

  JustAudioMediaKit.ensureInitialized(
      libmpv: '/usr/lib/libmpv.so.2',
  );
  

功能特性

• 通过 just_audio 提供的本地HTTP服务器读取字节流
  ** 需要启用

注意事项

• just_audio 的 shuffleOrder 当前被忽略，因此推荐通过手动打乱队列并创建新的 ConcatenatingAudioSource 来实现随机播放。
• ClippingAudioSource 当前不支持（等待 media-kit/media-kit#581 发布）。
• 尚未测试多个播放器实例，但应该没有问题。

许可证

此包采用Unlicense许可证，但请注意 package:media_kit（本包的直接依赖）采用MIT许可证。有关潜在的许可问题，请参考 package:media_kit。

示例代码

下面是一个完整的示例demo，展示了如何在Flutter项目中使用 just_audio_media_kit。

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Audio Player Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: AudioPlayerScreen(),
    );
  }
}

class AudioPlayerScreen extends StatefulWidget {
  @override
  _AudioPlayerScreenState createState() => _AudioPlayerScreenState();
}

class _AudioPlayerScreenState extends State<AudioPlayerScreen> {
  final AudioPlayer _audioPlayer = AudioPlayer();

  @override
  void initState() {
    super.initState();
    // 初始化插件
    JustAudioMediaKit.ensureInitialized();
    // 设置一些插件特定配置
    JustAudioMediaKit.mpvLogLevel = MPVLogLevel.debug;
    JustAudioMediaKit.bufferSize = 8 * 1024 * 1024;
    JustAudioMediaKit.title = 'My Audio Player App';
    JustAudioMediaKit.protocolWhitelist = const ['http', 'https'];
    JustAudioMediaKit.pitch = true;

    // 加载音频源
    _audioPlayer.setUrl('https://example.com/audio.mp3');
  }

  @override
  void dispose() {
    _audioPlayer.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Audio Player Demo'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            StreamBuilder<PlayerState>(
              stream: _audioPlayer.playerStateStream,
              builder: (context, snapshot) {
                final playerState = snapshot.data;
                final processingState = playerState?.processingState;
                final playing = playerState?.playing;
                if (processingState == ProcessingState.loading ||
                    processingState == ProcessingState.buffering) {
                  return Container(
                    margin: EdgeInsets.all(8.0),
                    width: 64.0,
                    height: 64.0,
                    child: CircularProgressIndicator(),
                  );
                } else if (playing != true) {
                  return IconButton(
                    icon: Icon(Icons.play_arrow),
                    iconSize: 64.0,
                    onPressed: _audioPlayer.play,
                  );
                } else if (processingState != ProcessingState.completed) {
                  return IconButton(
                    icon: Icon(Icons.pause),
                    iconSize: 64.0,
                    onPressed: _audioPlayer.pause,
                  );
                } else {
                  return IconButton(
                    icon: Icon(Icons.replay),
                    iconSize: 64.0,
                    onPressed: () => _audioPlayer.seek(Duration.zero),
                  );
                }
              },
            ),
            StreamBuilder<Duration>(
              stream: _audioPlayer.positionStream,
              builder: (context, snapshot) {
                final position = snapshot.data ?? Duration.zero;
                return Text("${position.inMinutes}:${(position.inSeconds % 60).toString().padLeft(2, '0')}");
              },
            ),
          ],
        ),
      ),
    );
  }
}

这个例子展示了一个简单的音频播放器界面，包括播放、暂停和显示当前播放时间的功能。希望这对您有所帮助！如果有任何问题，欢迎随时提问。