Flutter文档扫描插件 document_scanner_plus 的使用

document_scanner_plus 是一个为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_plus: ^latest_version

然后导入并使用该插件：

import 'package:document_scanner_plus/document_scanner.dart';

下面是一个完整的示例代码，展示了如何集成和使用document_scanner_plus插件：

示例Demo

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

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

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

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

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

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

  [@override](/user/override)
  Widget build(BuildContext context) => MaterialApp(
        home: Scaffold(
          appBar: AppBar(
            title: const Text('Plugin example app'),
          ),
          body: FutureBuilder<PermissionStatus>(
            future: cameraPermissionFuture,
            builder: (context, 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(
                                    onDocumentScanned: (scannedImage) {
                                      setState(() {
                                        scannedDocument =
                                            scannedImage.getScannedDocumentAsFile();
                                      });
                                    },
                                  ),
                          ),
                        ],
                      ),
                      scannedDocument != null
                          ? Positioned(
                              bottom: 20,
                              left: 0,
                              right: 0,
                              child: TextButton(
                                child: const Text('retry'),
                                onPressed: () {
                                  setState(() {
                                    scannedDocument = null;
                                  });
                                },
                              ),
                            )
                          : const SizedBox(),
                    ],
                  );
                } else {
                  return const Center(
                    child: Text('camera permission denied'),
                  );
                }
              } else {
                return const Center(
                  child: CircularProgressIndicator(),
                );
              }
            },
          ),
        ),
      );
}