Flutter平台检测插件v_platform的使用

VPlatformFile

VPlatformFile 是一个灵活的Dart包，用于管理来自不同来源的文件，包括本地路径、字节数组、URL和资源文件。这个包提供了处理文件元数据、MIME类型、媒体类型和文件大小信息的实用方法，简单且高效。

功能特性

• 多源文件处理：支持来自本地路径、URL、资源文件和字节数组的文件。
• 文件元数据访问：轻松获取文件属性，如名称、MIME类型、文件大小和扩展名。
• 哈希生成：基于文件属性生成唯一哈希，有助于缓存和唯一标识。
• 媒体类型检测：自动检测文件是否为图像、视频或其他文件类型。
• 可读文件大小：提供以KB、MB等人类可读格式的文件大小。
• 序列化支持：将文件转换为Map对象，便于存储和传输。

安装

在您的pubspec.yaml中添加此包：

dependencies:
  v_platform_file: ^1.0.0

然后运行以下命令安装包：

flutter pub get

使用

导入包

import 'package:v_platform_file/v_platform_file.dart';

创建 VPlatformFile 实例

您可以根据文件来源选择不同的构造函数来创建VPlatformFile实例。

从本地路径

final file = VPlatformFile.fromPath(fileLocalPath: '/path/to/your/file.jpg');
print(file.name); // 输出: file.jpg
print(file.fileSize); // 输出: 文件大小（字节）

从URL

final file = VPlatformFile.fromUrl(networkUrl: 'https://example.com/file.jpg');
print(file.name); // 输出: file.jpg
print(file.networkUrl);  // 输出: 完整URL

从字节数组

final file = VPlatformFile.fromBytes(name: 'myfile.png', bytes: [/* 文件字节 */]);
print(file.name); // 输出: myfile.png
print(file.fileSize); // 输出: 字节数组大小

从资源文件

final file = VPlatformFile.fromAssets(assetsPath: 'assets/myfile.png');
print(file.name); // 输出: myfile.png
print(file.isFromAssets); // 输出: true

访问文件属性

VPlatformFile类提供了多个有用的属性：

• 文件名称：file.name
• 文件大小（字节）：file.fileSize
• MIME类型：file.mimeType
• 文件扩展名：file.extension
• 是否来自路径：file.isFromPath
• 是否来自字节数组：file.isFromBytes
• 是否来自URL：file.isFromUrl
• 可读文件大小（例如：“10 MB”）：file.readableSize
• 文件哈希：file.fileHash

检查媒体类型

mediaType属性允许您识别文件是图像、视频还是通用文件类型：

if (file.isContentImage) {
  print("This file is an image.");
} else if (file.isContentVideo) {
  print("This file is a video.");
} else {
  print("This is a general file.");
}

转换为和从Map

VPlatformFile支持转换为和从Map进行转换，方便序列化，适用于缓存或数据库存储。

转换为Map

final fileMap = file.toMap();
print(fileMap);

从Map转换

final fileFromMap = VPlatformFile.fromMap(fileMap);
print(fileFromMap.name);

示例

以下是一个完整的示例，演示了从本地路径创建VPlatformFile实例，访问其属性，并将其转换为和从Map进行转换。

import 'package:v_platform_file/v_platform_file.dart';

void main() {
  // 从本地路径创建 VPlatformFile
  final file = VPlatformFile.fromPath(fileLocalPath: '/path/to/file.jpg');
  
  // 访问属性
  print("File Name: ${file.name}");
  print("File Size: ${file.readableSize}");
  print("MIME Type: ${file.mimeType}");
  
  // 检查是否为图像或视频
  if (file.isContentImage) {
    print("This is an image file.");
  }
  
  // 转换为 Map
  final fileMap = file.toMap();
  print("File as Map: $fileMap");
  
  // 从 Map 转换回来
  final fileFromMap = VPlatformFile.fromMap(fileMap);
  print("File Name from Map: ${fileFromMap.name}");
}

设置全局基础URL

您可以使用VPlatformFileUtils.baseMediaUrl为所有具有URL来源的文件设置全局基础URL。这对于需要公共URL前缀的情况非常有用。

VPlatformFileUtils.baseMediaUrl = "https://yourmediaurl.com/";

示例应用

以下是一个完整的Flutter应用示例，展示了如何使用VPlatformFile从URL创建文件实例并打印完整网络URL。

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

void main() {
  VPlatformFileUtils.baseMediaUrl = "https://yourmediaurl.com/";
  final x = VPlatformFile.fromUrl(
    networkUrl: "https://dl.espressif.com/dl/audio/ff-16b-2c-44100hz.mp3",
  );
  print(x.fullNetworkUrl!);

  runApp(const MediaPickerApp());
}

class MediaPickerApp extends StatelessWidget {
  const MediaPickerApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Media Picker App',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const HomeScreen(),
    );
  }
}

class HomeScreen extends StatelessWidget {
  const HomeScreen({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Home Screen'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            final file = VPlatformFile.fromUrl(
              networkUrl: "https://dl.espressif.com/dl/audio/ff-16b-2c-44100hz.mp3",
            );
            print(file.fullNetworkUrl!);
          },
          child: const Text('Print File URL'),
        ),
      ),
    );
  }
}

通过以上内容，您可以了解如何在Flutter项目中使用v_platform_file插件来处理不同来源的文件，并访问其属性。希望这些信息对您有所帮助！