Flutter快速条形码扫描插件icapps_fast_barcode_scanner的使用

Flutter快速条形码扫描插件icapps_fast_barcode_scanner的使用

icapps_fast_barcode_scanner 是一个基于 MLKit（Android）和 AVFoundation（iOS）的快速条形码扫描插件。该插件将UI设计留给了用户，但提供了对相机预览的访问。

注意：此插件仍在开发中，某些API可能尚未可用。如果您有任何问题、想法或建议，请在 GitHub 上创建一个issue或pull request。我自己也在生产环境中使用该插件，并会继续积极开发和维护它。

此插件要求 iOS 10.0 及以上版本，Android SDK 版本 21 或更高版本。

安装

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

dependencies:
  icapps_fast_barcode_scanner: ^1.1.0

iOS 配置

在 ios/Runner/Info.plist 文件中添加 NSCameraUsageDescription 键：

<key>NSCameraUsageDescription</key>
<string>此应用需要访问您的手机摄像头以扫描条形码</string>

Android 配置

在 android/app/build.gradle 文件中设置最低SDK版本为21或更高：

android {
    defaultConfig {
        minSdkVersion 21
    }
}

使用

icapps_fast_barcode_scanner 包含两个主要类：CameraController 和 BarcodeCamera。

完整的示例如下：

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

class MyScannerScreen extends StatelessWidget {
    @override
    Widget build(BuildContext context) {
        return Scaffold(
            appBar: AppBar(title: Text('条形码扫描器')),
            body: BarcodeCamera(
                types: const [
                    BarcodeType.ean8,
                    BarcodeType.ean13,
                    BarcodeType.code128
                ],
                resolution: Resolution.hd720,
                framerate: Framerate.fps30,
                mode: DetectionMode.pauseVideo,
                onScan: (code) => print(code),
                children: [
                    MaterialPreviewOverlay(animateDetection: false),
                    BlurPreviewOverlay(),
                    Positioned(
                      child: ElevatedButton(
                        onPressed: () =>
                            CameraController.instance.resumeDetector(),
                        child: Text('恢复'),
                      ),
                    )
                ],
            )
        );
    }
}

在上面的代码中，有两个覆盖层在 children 列表中。这两个覆盖层包含在包中：

• MaterialPreviewOverlay 模仿了官方的材料设计条形码扫描示例。
• BlurPreviewOverlay 在检测到条形码时模糊屏幕，并在恢复时取消模糊。这些是正常的Widget，它们显示在相机预览之上。查看它们的源代码可以找到如何响应来自条形码扫描器的事件。

CameraController

CameraController 单例管理相机。它处理所有低级操作，如与本地代码通信。它作为单例实现是为了保证始终有一个且相同的控制器来管理相机。可以通过 CameraController.instance 属性访问控制器。这些是可以访问的方法：

如果你使用 BarcodeCamera 小部件，你不必自己调用 initialize。

CameraState

CameraController.instance.state 包含扫描器的当前状态。你可以使用它来构建自己的覆盖层。可以访问的信息如下：

BarcodeCamera

BarcodeCamera 是一个显示相机视频流预览的小部件。它在后台调用 CameraController 进行初始化和配置。

所有可能的配置（要么传递给 BarcodeCamera，要么传递给 CameraController.initialize）如下：

示例代码

在 example/lib/main.dart 文件中的示例代码如下：

import 'package:flutter/material.dart';

import 'scanner_screen.dart';

void main() {
  runApp(const MaterialApp(home: ScannerScreen()));
}