Flutter多媒体处理插件media_kit的使用

简介

package:media_kit 是一个跨平台的视频和音频播放器，适用于Flutter和Dart。它提供了强大的功能集，支持多种格式和编解码器，并且可以在多个平台上运行，包括Android、iOS、macOS、Windows、GNU/Linux 和 Web。

安装

为了在项目中使用 media_kit 插件，你需要根据你的需求选择合适的包。以下是针对不同需求的安装指南：

视频回放

如果你的应用需要视频回放功能，请添加以下依赖：

dependencies:
  media_kit: ^1.1.11 # 主要包
  media_kit_video: ^1.2.5 # 用于视频渲染
  media_kit_libs_video: ^1.0.5 # 原生视频依赖

音频回放

如果你的应用只需要音频回放功能，请添加以下依赖：

dependencies:
  media_kit: ^1.1.11 # 主要包
  media_kit_libs_audio: ^1.0.5 # 原生音频依赖

注意：

• 如果需要同时支持视频和音频，应选择视频库。
• media_kit_libs_video 和 media_kit_libs_audio 包不应混用。
• 在 “Release” 模式下的性能比在 “Debug” 模式下更高。
• 在Android上，建议启用 --split-per-abi 或使用应用包（而不是APK）。

平台支持

media_kit 支持以下平台：

快速使用示例

以下是一个简单的示例代码，展示了如何使用 media_kit 播放视频：

import 'package:flutter/material.dart';

// Make sure to add following packages to pubspec.yaml:
// * media_kit
// * media_kit_video
// * media_kit_libs_video
import 'package:media_kit/media_kit.dart';                      // Provides [Player], [Media], [Playlist] etc.
import 'package:media_kit_video/media_kit_video.dart';          // Provides [VideoController] & [Video] etc.

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  // Necessary initialization for package:media_kit.
  MediaKit.ensureInitialized();
  runApp(
    const MaterialApp(
      home: MyScreen(),
    ),
  );
}

class MyScreen extends StatefulWidget {
  const MyScreen({Key? key}) : super(key: key);
  @override
  State<MyScreen> createState() => MyScreenState();
}

class MyScreenState extends State<MyScreen> {
  // Create a [Player] to control playback.
  late final player = Player();
  // Create a [VideoController] to handle video output from [Player].
  late final controller = VideoController(player);

  @override
  void initState() {
    super.initState();
    // Play a [Media] or [Playlist].
    player.open(Media('https://user-images.githubusercontent.com/28951144/229373695-22f88f13-d18f-4288-9bf1-c3e078d83722.mp4'));
  }

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

  @override
  Widget build(BuildContext context) {
    return Center(
      child: SizedBox(
        width: MediaQuery.of(context).size.width,
        height: MediaQuery.of(context).size.width * 9.0 / 16.0,
        // Use [Video] widget to display video output.
        child: Video(controller: controller),
      ),
    );
  }
}

使用指南

初始化

在使用 media_kit 之前，必须调用 MediaKit.ensureInitialized() 方法进行初始化：

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  // Make sure to add the required packages to pubspec.yaml:
  // * https://github.com/media-kit/media-kit#installation
  // * https://pub.dev/packages/media_kit#installation
  MediaKit.ensureInitialized();
  runApp(const MyApp());
}

创建播放器

创建一个 Player 实例以开始并控制媒体源（如URL或文件）的播放：

final Player player = Player();

打开媒体或播放列表

使用 Player.open 方法加载并开始播放：

单个媒体文件

final playable = Media('https://user-images.githubusercontent.com/28951144/229373695-22f88f13-d18f-4288-9bf1-c3e078d83722.mp4');
await player.open(playable);

播放列表

final playable = Playlist(
  [
    Media('https://user-images.githubusercontent.com/28951144/229373695-22f88f13-d18f-4288-9bf1-c3e078d83722.mp4'),
    Media('https://user-images.githubusercontent.com/28951144/229373709-603a7a89-2105-4e1b-a5a5-a6c3567c9a59.mp4'),
    // 更多媒体文件...
  ],
);
await player.open(playable);

播放、暂停、停止

控制播放状态的方法如下：

await player.play(); // 开始播放
await player.pause(); // 暂停播放
await player.stop(); // 停止播放

设置音量、播放速度和音高

await player.setVolume(50.0); // 设置音量
await player.setRate(1.5); // 设置播放速度
await player.setPitch(1.2); // 设置音高

事件处理

你可以通过监听 Player 的状态变化来响应播放事件：

player.stream.playing.listen((bool playing) {
  if (playing) {
    // Playing
  } else {
    // Paused
  }
});
player.stream.position.listen((Duration position) {
  setState(() {
    // 更新UI
  });
});

自定义控件

你可以自定义视频控件，例如：

Scaffold(
  body: Video(
    controller: controller,
    controls: MaterialVideoControls, // 或其他控件类型
  ),
);

权限设置

根据不同平台，你可能需要声明和请求互联网访问或文件系统权限。

Android

编辑 android/app/src/main/AndroidManifest.xml 文件：

<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.app">
  <application ... />
  <!-- Internet access permissions -->
  <uses-permission android:name="android.permission.INTERNET" />
  <!-- Media access permissions -->
  <uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />
  <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
  <!-- Storage access permissions -->
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
</manifest>

iOS

编辑 ios/Runner/Info.plist 文件：

<key>NSAppTransportSecurity</key>
<dict>
  <key>NSAllowsArbitraryLoads</key>
  <true/>
</dict>

其他平台

对于其他平台，如Windows、macOS、GNU/Linux 和 Web，通常不需要额外的权限设置。

结论

media_kit 提供了丰富的功能和良好的跨平台支持，能够满足大多数多媒体处理的需求。希望这篇文档能帮助你快速上手并充分利用这个强大的插件。如果你有任何问题或需要进一步的帮助，欢迎查阅官方文档或加入社区讨论。