Flutter媒体扩展功能插件media_extension的使用

简介

media_extension 是一个帮助 Flutter 应用程序像原生图库一样工作的插件。该插件由 ente 提供。

功能

1. 处理来自其他应用的调用：
   • 可以识别和处理来自不同应用的调用，并获取触发调用的意图动作（如 PICK、EDIT、VIEW）。
   • 使用 setResult 方法将选定媒体文件的 URI 传递给请求的应用，通过在内容提供者路径中创建临时副本。
2. 打开第三方应用：
   • 能够使用第三方应用（如图库、编辑器、壁纸管理器等）打开图片。

实现

• Native 代码调用 Flutter 代码：通过 onAttachedEngineMethod 调用 Flutter 方法，返回模式异步。在 Dart 代码中使用 Completer 获取状态并设置应用模式。
• 作为图库行为：从应用程序文档存储目录中选择图像的 URI，并调用带有 URI 参数的方法。
• 创建临时文件：在缓存目录中创建临时文件，并授予其他应用读取该目录的权限。一旦创建了 content://uri（内容提供者），结果将通过 intent 发送到请求的活动。

数据类型描述

方法描述

入门指南

安装

1. 通过终端命令安装：

   flutter pub get media_extension
   

2. 在 pubspec.yaml 文件中添加依赖：

   dependencies:
     flutter:
       sdk: flutter
     media_extension:
   

配置 Android

1. 在 android/src/main/res/xml/provider_paths.xml 中添加以下内容：

   <?xml version="1.0" encoding="utf-8"?>
   <paths>
       <external-path
           name="external_files"
           path="." />
   
       <cache-path
           name="embedded"
           path="." />
   </paths>
   

2. 在 android/src/main/AndroidManifest.xml 中添加以下内容：

   <application>
       <activity
           android:name=".MainActivity">
   
           <intent-filter>
               <action android:name="android.intent.action.VIEW" />
               <category android:name="android.intent.category.DEFAULT" />
               <data android:mimeType="image/*" />
           </intent-filter>
   
           <intent-filter>
               <action android:name="android.intent.action.PICK" />
               <category android:name="android.intent.category.DEFAULT" />
               <data android:mimeType="image/*" />
           </intent-filter>
   
           <intent-filter>
               <action android:name="android.intent.action.GET_CONTENT" />
               <category android:name="android.intent.category.DEFAULT" />
               <category android:name="android.intent.category.OPENABLE" />
               <data android:mimeType="image/*" />
           </intent-filter>
       </activity>
   </application>
   

示例代码

import 'dart:async';
import 'dart:convert';
import 'dart:io';

import 'package:dio/dio.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:media_extension_example/download.dart';
import 'package:path_provider/path_provider.dart';
import 'package:media_extension/media_extension_action_types.dart';
import 'package:media_extension/media_extension.dart';
import 'package:video_player/video_player.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  final imgUrl = "https://cdn-chat.sstatic.net/chat/img/404_funny_hats.jpg";
  MediaExtentionAction _intentAction = MediaExtentionAction(action: IntentAction.main);
  final _mediaExtensionPlugin = MediaExtension();
  final _downloadHelper = DownloadHelper(Dio());
  late VideoPlayerController _controller;

  @override
  void initState() {
    super.initState();
    initPlatformState();
  }

  Future<void> initPlatformState() async {
    MediaExtentionAction intentAction;
    try {
      intentAction = await _mediaExtensionPlugin.getIntentAction();
      if (intentAction.action == IntentAction.view && intentAction.type == MediaType.video) {
        _controller = VideoPlayerController.contentUri(Uri.parse(intentAction.data!));
        await _controller.initialize();
      }
    } on PlatformException {
      intentAction = MediaExtentionAction(action: IntentAction.main);
      throw ("Platform exception");
    } on Exception catch (_) {
      intentAction = MediaExtentionAction(action: IntentAction.main);
    }
    if (!mounted) return;

    setState(() {
      _intentAction = intentAction;
      if (_intentAction.type == MediaType.video) _controller.play();
    });
  }

  Future<String> _getLocalFile(String filename) async {
    var tempDir = await getTemporaryDirectory();
    String fullPath = "${tempDir.path}/image.jpg";
    await _downloadHelper.downloadToFile(imgUrl, fullPath);
    return fullPath;
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Intent Action is: ${_intentAction.action!.toShortString()}'),
        ),
        body: Center(
          child: _intentAction.action == IntentAction.view
              ? (_intentAction.type == MediaType.video
                  ? Center(
                      child: _controller.value.isInitialized
                          ? AspectRatio(
                              aspectRatio: _controller.value.aspectRatio,
                              child: VideoPlayer(_controller),
                            )
                          : Container())
                  : Image.memory(base64Decode(_intentAction.data!)))
              : Column(
                  mainAxisAlignment: MainAxisAlignment.center,
                  children: [
                    FutureBuilder(
                        future: _getLocalFile("image.jpg"),
                        builder: (BuildContext context, AsyncSnapshot<String> snapshot) {
                          return snapshot.data != null
                              ? GestureDetector(
                                  child: Image.file(File(snapshot.data!)),
                                  onTap: () async {
                                    if (_intentAction.action == IntentAction.pick) {
                                      _mediaExtensionPlugin.setResult("file://${snapshot.data!}");
                                    }
                                  },
                                )
                              : Container();
                        }),
                    GestureDetector(
                      child: Text(
                        'Set as',
                        style: Theme.of(context).textTheme.headlineMedium,
                      ),
                      onTap: () async {
                        var tempDir = await getTemporaryDirectory();
                        String fullPath = "${tempDir.path}/image.jpg'";
                        await _downloadHelper.downloadToFile(imgUrl, fullPath);
                        try {
                          final isDone = await _mediaExtensionPlugin.setAs("file://$fullPath", "image/*");
                          debugPrint("Is done $isDone");
                        } on PlatformException {
                          debugPrint("Some error");
                        }
                      },
                    ),
                    GestureDetector(
                      child: Text(
                        'Edit',
                        style: Theme.of(context).textTheme.headlineMedium,
                      ),
                      onTap: () async {
                        var tempDir = await getTemporaryDirectory();
                        String fullPath = "${tempDir.path}/image.jpg'";
                        await _downloadHelper.downloadToFile(imgUrl, fullPath);
                        try {
                          final isDone = await _mediaExtensionPlugin.edit("file://$fullPath", "image/*");
                          debugPrint("Is done $isDone");
                        } on PlatformException {
                          debugPrint("Some error");
                        }
                      },
                    ),
                    GestureDetector(
                      child: Text(
                        'Open With',
                        style: Theme.of(context).textTheme.headlineMedium,
                      ),
                      onTap: () async {
                        var tempDir = await getTemporaryDirectory();
                        String fullPath = "${tempDir.path}/image.jpg'";
                        await _downloadHelper.downloadToFile(imgUrl, fullPath);
                        try {
                          final result = await _mediaExtensionPlugin.openWith("file://$fullPath", "image/*");
                          debugPrint("Is done $result");
                        } on PlatformException {
                          debugPrint("Some error");
                        }
                      },
                    ),
                  ],
                ),
        ),
      ),
    );
  }
}

问题和即将的变化

• 实现 setResults 方法，用于 ACTION_PICK 意图的多选图片。

致谢

• aves：插件中的大多数方法都受到此仓库的启发。

许可证

• MIT