Flutter条形码扫描插件flutter_barcode_scanner_plus的使用

flutter_barcode_scanner_plus 是一个为Flutter应用提供条形码和二维码扫描支持的插件，适用于Android和iOS平台。以下是该插件的详细介绍与使用方法。

插件信息

开始使用

项目配置

Android

对于Android平台，无需额外配置，直接添加依赖即可使用。

iOS - 需要Swift支持

1. Fresh Start:

   • 创建新的Flutter项目时，请确保选择包含对iOS代码的Swift支持。
   • 打开/ios文件夹下的Xcode项目，并将最低部署目标设置为12，Swift版本设置为5。
   • 关闭Xcode后，在Flutter项目的/ios目录下运行pod install。

2. 现有Flutter应用:

   • 如果现有的iOS代码是用Swift编写的，则只需设置最低部署目标为12，Swift版本为5，并在/ios目录中运行pod install。
   • 如果现有的iOS代码是Objective-C编写的，则需要创建一个新的Flutter项目（记得选择包含Swift支持），然后将新项目的/ios文件夹复制并替换现有项目的/ios文件夹，再进行上述配置步骤。

权限配置

为了在iOS上使用相机权限，需在Info.plist中添加如下内容：

<key>NSCameraUsageDescription</key>
<string>Camera permission is required for barcode scanning.</string>

如何使用

添加依赖

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

dependencies:
  ...
  flutter_barcode_scanner_plus: ^3.0.7

使用示例

导入包

首先需要导入此插件：

import 'package:flutter_barcode_scanner/flutter_barcode_scanner.dart';

单次扫描

可以通过调用scanBarcode方法来执行单次扫描操作：

String barcodeScanRes = await FlutterBarcodeScanner.scanBarcode(
  "#ff6666", // 线条颜色
  "取消",    // 取消按钮文本
  true,      // 是否显示闪光灯图标
  ScanMode.BARCODE // 扫描模式 (QR, BARCODE, DEFAULT)
);

连续扫描

如果需要连续扫描而不需要关闭摄像头，可以使用getBarcodeStreamReceiver方法：

FlutterBarcodeScanner.getBarcodeStreamReceiver("#ff6666", "Cancel", false, ScanMode.DEFAULT)
         .listen((barcode) { 
         /// 处理扫描结果
         });

完整示例代码

下面是一个完整的Flutter应用程序示例，展示了如何集成并使用flutter_barcode_scanner_plus插件进行条形码和二维码的扫描。

import 'dart:async';

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:flutter_barcode_scanner_plus/flutter_barcode_scanner_plus.dart';

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

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

class _MyAppState extends State<MyApp> {
  String _scanBarcode = 'Unknown';

  Future<void> startBarcodeScanStream() async {
    FlutterBarcodeScanner.getBarcodeStreamReceiver(
            '#ff6666', 'Cancel', true, ScanMode.BARCODE)!
        .listen((barcode) => print(barcode));
  }

  Future<void> scanQR() async {
    String barcodeScanRes;
    try {
      barcodeScanRes = await FlutterBarcodeScanner.scanBarcode(
          '#ff6666', 'Cancel', true, ScanMode.QR);
      print(barcodeScanRes);
    } on PlatformException {
      barcodeScanRes = 'Failed to get platform version.';
    }
    if (!mounted) return;

    setState(() {
      _scanBarcode = barcodeScanRes;
    });
  }

  Future<void> scanBarcodeNormal() async {
    String barcodeScanRes;
    try {
      barcodeScanRes = await FlutterBarcodeScanner.scanBarcode(
          '#ff6666', 'Cancel', true, ScanMode.BARCODE);
      print(barcodeScanRes);
    } on PlatformException {
      barcodeScanRes = 'Failed to get platform version.';
    }
    if (!mounted) return;

    setState(() {
      _scanBarcode = barcodeScanRes;
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
        home: Scaffold(
            appBar: AppBar(title: const Text('Barcode scan')),
            body: Builder(builder: (BuildContext context) {
              return Container(
                  alignment: Alignment.center,
                  child: Flex(
                      direction: Axis.vertical,
                      mainAxisAlignment: MainAxisAlignment.center,
                      children: <Widget>[
                        ElevatedButton(
                            onPressed: () => scanBarcodeNormal(),
                            child: Text('Start barcode scan')),
                        ElevatedButton(
                            onPressed: () => scanQR(),
                            child: Text('Start QR scan')),
                        ElevatedButton(
                            onPressed: () => startBarcodeScanStream(),
                            child: Text('Start barcode scan stream')),
                        Text('Scan result : $_scanBarcode\n',
                            style: TextStyle(fontSize: 20))
                      ]));
            })));
  }
}

通过以上步骤，您可以轻松地在Flutter应用中实现条形码和二维码的扫描功能。如果有任何问题或建议，欢迎联系开发者或提交贡献。