Flutter二维码扫描插件 code_scan 的使用

code_scan 是一个灵活的二维码和条形码扫描插件，支持多种格式。它基于 Google 的 ML Kit 实现，并且提供了方便的 Widget 以及方法调用接口。

特性

• 支持多种线性和二维格式：QR Code、Barcode 等。
• 提供集成摄像头的 Widget。
• 提供回调以监听每次扫描的结果。
• 可选择要扫描的格式。
• 可覆盖摄像头预览以自定义视图。
• 控制摄像头生命周期。

支持的格式

• Aztec
• Codabar
• Code 39
• Code 93
• Code 128
• Data Matrix
• EAN-8
• EAN-13
• ITF
• PDF417
• QR Code
• UPC-A
• UPC-E

开始使用

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

dependencies:
  code_scan: ^latest_version

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

flutter pub get

在 Dart 文件中导入包：

import 'package:code_scan/code_scan.dart';

使用示例

下面是一个完整的示例 Demo，展示如何使用 CodeScanner Widget 进行二维码扫描：

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

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

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> with TickerProviderStateMixin {
  String? code;

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Code Scanner Example'),
        ),
        body: code == null
            ? CodeScanner(
                onScan: (code, details, controller) =>
                    setState(() => this.code = code),
                onScanAll: (codes, controller) => print(
                    'Codes: ' + codes.map((code) => code.rawValue).toString()),
                formats: const [BarcodeFormat.qrCode],
                once: true,
              )
            : GestureDetector(
                onTap: () => setState(() => code = null),
                child: Container(
                  color: Colors.transparent,
                  child: Center(child: Text(code!)),
                ),
              ),
      ),
    );
  }
}

自定义配置

你还可以根据需求进行更多的自定义配置，例如设置加载动画、自定义覆盖层、选择摄像头方向等：

CodeScanner(
    loading: Center(child: CircularProgressIndicator()),
    overlay: Center(child: Text('Scanning...')),
    direction: CameraLensDirection.back,
    resolution: ResolutionPreset.medium,
    formats: const [ BarcodeFormat.all ],
    scanInterval: const Duration(seconds: 1),
    aspectRatio: 480 / 720, // height / width
    once: false,
)

使用自己的摄像头控制器

如果你希望使用自己的摄像头控制器而不使用默认的扫描 Widget，可以这样做：

final cameraController = CameraController();

CodeScannerCameraView(
    controller: cameraController,
)

注意：如果使用自己的摄像头控制器，请确保正确管理摄像头资源，参考 camera package 文档 来处理生命周期状态。

提供的方法

你可以创建一个摄像头监听器并与任何摄像头控制器结合使用来扫描代码：

final listener = CodeScannerCameraListener(
    cameraController,
    
    formats: const [ BarcodeFormat.all ],
    interval: const Duration(milliseconds: 500),
    once: false,
    
    onScan: (code, details, controller) => ...,
    onScanAll: (codes, controller) => ...,
);

停止监听器：

listener.stop();