Flutter边缘自动检测插件edge_auto_detection的使用

Flutter边缘自动检测插件edge_auto_detection的使用

一个用于检测物体边缘、扫描纸张、检测角点和矩形的Flutter插件。它允许裁剪检测到的对象图像，并返回裁剪图像的路径。

iOS

iOS 13.0或更高版本才可使用该插件。如果编译版本低于13.0，请确保在使用插件之前检查iOS版本。将ios/Podfile文件中的最低平台版本改为13（或更高），并根据permission_handler请求访问权限。

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    target.build_configurations.each do |config|
      config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
        '$(inherited)',

        ## dart: PermissionGroup.camera
         'PERMISSION_CAMERA=1',

        ## dart: PermissionGroup.photos
         'PERMISSION_PHOTOS=1',
      ]
    end
    # End of the permission_handler configuration
  end
end

Fix build on xCode 15

在你的项目Podfile中添加以下行：

pod 'WeScan', :path => '.symlinks/plugins/edge_auto_detection/ios/WeScan-3.0.0'

例如：

target 'Runner' do
  use_frameworks!
  use_modular_headers!
  pod 'WeScan', :path => '.symlinks/plugins/edge_auto_detection/ios/WeScan-3.0.0'
  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
end

在ios/Runner/Info.plist中添加以下权限：

• 一个键为Privacy - Camera Usage Description，并附上使用描述。

或者以文本格式添加以下键：

<key>NSCameraUsageDescription</key>
<string>Can I use the camera please?</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>Can I use the photos please?</string>
<key>NSPhotoLibraryAddUsageDescription</key>
<string>Can I use the photos please?</string>

通过XCode添加本地化到你的应用中，以便本地化WeScan的动作按钮。

Android

插件代码是用Kotlin 1.8.0编写的，因此你的Android项目的Kotlin版本也应设置为1.8.0。

在android/build.gradle文件中更改Kotlin版本：

ext.kotlin_version = '1.8.0'

在android/app/build.gradle文件中将最小Android SDK版本改为21（或更高）：

minSdkVersion 21

添加依赖

请在安装前检查最新版本。

dependencies:
  flutter:
    sdk: flutter
  edge_auto_detection: ^1.1.3
  permission_handler: ^10.0.0
  path_provider: ^2.0.11
  path: ^1.8.2

在Dart代码中添加以下导入

import 'package:edge_auto_detection/edge_auto_detection.dart';

示例代码

以下是使用该插件的示例代码：

import 'dart:async';
import 'dart:io';
import 'package:edge_auto_detection/edge_auto_detection.dart';
import 'package:flutter/material.dart';
import 'package:path/path.dart';
import 'package:path_provider/path_provider.dart';
import 'package:permission_handler/permission_handler.dart';

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

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  String? _imagePath;

  [@override](/user/override)
  void initState() {
    super.initState();
  }

  Future<void> getImageFromCamera() async {
    bool isCameraGranted = await Permission.camera.request().isGranted;
    if (!isCameraGranted) {
      isCameraGranted = await Permission.camera.request() == PermissionStatus.granted;
    }

    if (!isCameraGranted) {
      // 没有相机权限
      return;
    }

    // 生成保存路径
    String imagePath = join((await getApplicationSupportDirectory()).path,
        "${(DateTime.now().millisecondsSinceEpoch / 1000).round()}.jpeg");

    bool success = false;

    try {
      // 确保调用detectEdge时等待完成
      success = await EdgeDetection.detectEdge(
        imagePath,
        canUseGallery: false,
        androidScanTitle: 'Scanning', // 使用自定义本地化
        androidCropTitle: 'Crop',
        androidCropBlackWhiteTitle: 'Black White',
        androidCropReset: 'Reset',
      );
      print("success: $success");
    } catch (e) {
      print(e);
    }

    // 如果在异步平台消息飞行时小部件从树中移除，则我们希望丢弃回复而不是调用setState来更新我们的非存在外观。
    if (!mounted) return;

    setState(() {
      if (success) {
        _imagePath = imagePath;
      }
    });
  }

  Future<void> getImageFromGallery() async {
    // 生成保存路径
    String imagePath = join((await getApplicationSupportDirectory()).path,
        "${(DateTime.now().millisecondsSinceEpoch / 1000).round()}.jpeg");

    bool success = false;
    try {
      // 确保调用detectEdgeFromGallery时等待完成
      success = await EdgeDetection.detectEdgeFromGallery(
        imagePath,
        androidCropTitle: 'Crop', // 使用自定义本地化
        androidCropBlackWhiteTitle: 'Black White',
        androidCropReset: 'Reset',
      );
      print("success: $success");
    } catch (e) {
      print(e);
    }

    // 如果在异步平台消息飞行时小部件从树中移除，则我们希望丢弃回复而不是调用setState来更新我们的非存在外观。
    if (!mounted) return;

    setState(() {
      if (success) {
        _imagePath = imagePath;
      }
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: SingleChildScrollView(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            crossAxisAlignment: CrossAxisAlignment.center,
            children: [
              Center(
                child: ElevatedButton(
                  onPressed: getImageFromCamera,
                  child: Text('扫描'),
                ),
              ),
              SizedBox(height: 20),
              Text('裁剪图像路径：'),
              Padding(
                padding: const EdgeInsets.only(top: 0, left: 0, right: 0),
                child: Text(
                  _imagePath?.toString() ?? '',
                  textAlign: TextAlign.center,
                  style: TextStyle(fontSize: 14),
                ),
              ),
              Visibility(
                visible: _imagePath != null,
                child: Padding(
                  padding: const EdgeInsets.all(8.0),
                  child: Image.file(
                    File(_imagePath ?? ''),
                  ),
                ),
              ),
            ],
          ),
        ),
      ),
    );
  }
}