Flutter媒体管理插件esig_midias的使用

esig_midias

esig_midias 是由 Esig Group 移动团队开发的工具包。

使用步骤

1. 添加依赖

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

dependencies:
  esig_midias: ^版本号

然后运行以下命令安装依赖：

flutter pub get

2. 导入包

在需要使用的 Dart 文件中导入 esig_midias 包：

import 'package:esig_midias/esig_midias.dart';

3. 使用示例

(1) 从相册选择图片

Future<void> anexarImagemGaleria() async {
  try {
    // 调用方法从相册选择图片
    final image = await EsigMidias.anexarImagemGaleria();

    // 打印选择的图片路径
    print("Selected Image Path: $image");
  } catch (e) {
    // 捕获并打印错误信息
    print("Error: $e");
  }
}

(2) 拍摄照片

Future<void> anexarImagemCamera() async {
  try {
    // 调用方法打开相机拍摄照片
    final image = await EsigMidias.anexarImagemCamera();

    // 打印拍摄的照片路径
    print("Captured Image Path: $image");
  } catch (e) {
    // 捕获并打印错误信息
    print("Error: $e");
  }
}

(3) 将图片转换为 Base64 字符串

Future<void> converterParaBase64(String imagePath) async {
  try {
    // 调用方法将图片路径转换为 Base64 字符串
    final base64String = await EsigMidias.converteParaBase64(imagePath);

    // 打印 Base64 字符串
    print("Base64 String: $base64String");
  } catch (e) {
    // 捕获并打印错误信息
    print("Error: $e");
  }
}

(4) 验证文件大小

Future<void> verificarTamanhoArquivo(String filePath) async {
  try {
    // 调用方法验证文件大小
    final fileSize = await EsigMidias.verificaTamanhoArquivo(filePath);

    // 打印文件大小（单位为字节）
    print("File Size: $fileSize bytes");
  } catch (e) {
    // 捕获并打印错误信息
    print("Error: $e");
  }
}

完整示例代码

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomePage(),
    );
  }
}

class HomePage extends StatefulWidget {
  @override
  _HomePageState createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  String _selectedImagePath = "Nenhuma imagem selecionada";
  String _capturedImagePath = "Nenhuma imagem capturada";

  Future<void> _anexarImagemGaleria() async {
    try {
      final image = await EsigMidias.anexarImagemGaleria();
      setState(() {
        _selectedImagePath = image ?? "Erro ao selecionar imagem";
      });
    } catch (e) {
      setState(() {
        _selectedImagePath = "Erro: $e";
      });
    }
  }

  Future<void> _anexarImagemCamera() async {
    try {
      final image = await EsigMidias.anexarImagemCamera();
      setState(() {
        _capturedImagePath = image ?? "Erro ao capturar imagem";
      });
    } catch (e) {
      setState(() {
        _capturedImagePath = "Erro: $e";
      });
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text("esig_midias 示例"),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: _anexarImagemGaleria,
              child: Text("从相册选择图片"),
            ),
            SizedBox(height: 20),
            Text(_selectedImagePath),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: _anexarImagemCamera,
              child: Text("拍照"),
            ),
            SizedBox(height: 20),
            Text(_capturedImagePath),
          ],
        ),
      ),
    );
  }
}

注意事项

1. 确保设备具有相机和存储权限。
2. 在 Android 设备上，需要在 AndroidManifest.xml 中添加以下权限：

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

1. 在 iOS 设备上，需要在 Info.plist 文件中添加以下键值对：

<key>NSCameraUsageDescription</key>
<string>需要访问您的相机以拍摄照片。</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>需要访问您的相册以选择图片。</string>