Flutter文档扫描插件 document_scanner 的使用

document_scanner 是一个为 Flutter 应用添加文档扫描功能的平台视图插件，支持 Android 和 iOS 平台。

警告

当前，文档扫描器的自定义选项可能无法正常工作。

设置

处理相机访问权限

iOS

1. 在应用的 Info.plist 文件中添加布尔类型的属性，键名为 io.flutter.embedded_views_preview，值为 true，以启用嵌入式视图预览。

   <key>io.flutter.embedded_views_preview</key>
   <true/>
   

2. 同样在 Info.plist 文件中添加字符串类型的属性，键名为 NSCameraUsageDescription，值为描述应用需要相机权限的原因。

   <key>NSCameraUsageDescription</key>
   <string>Camera Permission Description</string>
   

Android

确保 minSdkVersion 至少为 19。

如何使用？

首先，在 pubspec.yaml 中添加依赖：

dependencies:
  document_scanner: ^latest_version

然后导入包并使用它作为小部件：

import 'package:document_scanner/document_scanner.dart';

// 示例代码片段
File scannedDocument;

DocumentScanner(
    onDocumentScanned: (ScannedImage scannedImage) {
        print("document : " + scannedImage.croppedImage);
        scannedDocument = scannedImage.getScannedDocumentAsFile();
    },
)

完整示例 Demo

以下是一个完整的示例代码，展示了如何集成和使用 document_scanner 插件。该示例还包括了对相机权限的处理。

import 'dart:io';
import 'package:flutter/material.dart';
import 'package:document_scanner/document_scanner.dart';
import 'package:permission_handler/permission_handler.dart';

void main() => runApp(MyApp());

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  File? scannedDocument;
  Future<PermissionStatus>? cameraPermissionFuture;

  @override
  void initState() {
    cameraPermissionFuture = Permission.camera.request();
    super.initState();
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
          appBar: AppBar(
            title: const Text('Plugin example app'),
          ),
          body: FutureBuilder<PermissionStatus>(
            future: cameraPermissionFuture,
            builder: (BuildContext context, AsyncSnapshot<PermissionStatus> snapshot) {
              if (snapshot.connectionState == ConnectionState.done) {
                if (snapshot.data!.isGranted)
                  return Stack(
                    children: <Widget>[
                      Column(
                        children: <Widget>[
                          Expanded(
                            child: scannedDocument != null
                                ? Image(image: FileImage(scannedDocument!))
                                : DocumentScanner(
                                    noGrayScale: true,
                                    onDocumentScanned: (ScannedImage scannedImage) {
                                      print("document : " + scannedImage.croppedImage!);
                                      setState(() {
                                        scannedDocument = scannedImage.getScannedDocumentAsFile();
                                      });
                                    },
                                  ),
                          ),
                        ],
                      ),
                      scannedDocument != null
                          ? Positioned(
                              bottom: 20,
                              left: 0,
                              right: 0,
                              child: RaisedButton(
                                  child: Text("retry"),
                                  onPressed: () {
                                    setState(() {
                                      scannedDocument = null;
                                    });
                                  }),
                            )
                          : Container(),
                    ],
                  );
                else
                  return Center(
                    child: Text("camera permission denied"),
                  );
              } else {
                return Center(
                  child: CircularProgressIndicator(),
                );
              }
            },
          )),
    );
  }
}

以上就是关于 document_scanner 插件的基本介绍及使用方法。希望对你有所帮助！