Flutter媒体管理插件 enough_media 的使用

enough_media 是一个用于处理多种媒体文件的预览和交互的框架。它最初是为了创建一个Flutter邮件应用程序而开发的，但它的功能非常广泛，适用于任何需要处理媒体文件的应用程序。

快速入门

1. 导入包

首先，在您的Dart文件中导入 enough_media 包：

import 'package:enough_media/enough_media.dart';

2. 创建 MediaProvider

根据您的需求选择合适的 MediaProvider 类型：

• UrlMediaProvider: 通过URL加载媒体。

  UrlMediaProvider('funny.png', 'image/png', 'https://domain.com/resources/funny.png')
  

• AssetMediaProvider: 从应用的资源目录加载媒体。

  AssetMediaProvider('funny.png', 'image/png', 'stuff/funny.png')
  

• MemoryMediaProvider: 使用内存中的数据加载媒体（Uint8List）。

  MemoryMediaProvider('funny.png', 'image/png', data)
  

3. 构建 PreviewMediaWidget 或 InteractiveMediaWidget

您可以选择构建一个预览小部件或交互式媒体小部件来展示媒体内容。

示例代码

以下是一个完整的示例demo，展示了如何使用 enough_media 插件：

import 'dart:typed_data';

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

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

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

class HomeScreen extends StatefulWidget {
  @override
  _HomeScreenState createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  // Example binary data for demonstration purposes.
  Uint8List sampleImageData = Uint8List.fromList([/* ... */]);

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Enough Media Demo'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            // Preview media widget
            buildPreview('sample_image.png', 'image/png', sampleImageData),
            
            SizedBox(height: 20),

            // Interactive media widget
            buildInteractive('interactive_sample.png', 'image/png', sampleImageData),

            SizedBox(height: 20),

            // Preview with show interactive delegate
            buildPreviewWithShowInteractiveDelegate(context, 'hero_image.png', 'image/png', sampleImageData),
          ],
        ),
      ),
    );
  }

  /// 预览媒体
  Widget buildPreview(String name, String mimeType, Uint8List data) {
    final mediaProvider = MemoryMediaProvider(name, mimeType, data);
    return PreviewMediaWidget(
      mediaProvider: mediaProvider,
    );
  }

  /// 提供互动媒体，通常用于近全屏体验：
  Widget buildInteractive(String name, String mimeType, Uint8List data) {
    final mediaProvider = MemoryMediaProvider(name, mimeType, data);
    return InteractiveMediaWidget(
      mediaProvider: mediaProvider,
    );
  }

  /// 使用基于Hero的动画从预览切换到互动体验：
  Widget buildPreviewWithShowInteractiveDelegate(
      BuildContext context, String name, String mimeType, Uint8List data) {
    final mediaProvider = MemoryMediaProvider(name, mimeType, data);
    return PreviewMediaWidget(
      mediaProvider: mediaProvider,
      showInteractiveDelegate: (media) => Navigator.of(context).push(
        MaterialPageRoute(
          builder: (_) => Scaffold(body: media),
        ),
      ),
    );
  }
}

安装与设置

在您的 pubspec.yaml 文件中添加如下依赖项：

dependencies:
  enough_media: ^2.2.0

请确保替换版本号为最新的发布版本。您可以在此处找到最新版本的信息。

对于视频的支持，请遵循 video_player 插件的说明进行配置。

许可证

enough_media 在Mozilla Public License 2.0下授权，这是一个对商业友好的开源许可证。更多详情，请参阅 LICENSE 文件。