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

flutter_barcode_scanner 是一个用于Flutter应用的插件，它为Android和iOS平台添加了条形码扫描支持。以下是详细的使用说明，包括如何配置项目以及示例代码。

安装与配置

Android 配置

对于Android平台，无需额外配置。直接在pubspec.yaml中添加依赖即可。

dependencies:
  flutter_barcode_scanner: ^2.0.0

iOS 配置 - 需要Swift支持

新建项目

1. 创建一个新的Flutter项目，并确保选中包含iOS代码的Swift支持。
2. 打开/ios目录下的项目文件，在Xcode中设置最低部署目标为12，并将Swift版本设置为5。
3. 关闭Xcode后，在Flutter项目的/ios目录下运行pod install命令。

现有项目

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

权限配置

为了在iOS上正常使用摄像头权限，需在Info.plist文件中添加以下键值对：

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

使用方法

单次扫描

首先导入包：

import 'package:flutter_barcode_scanner/flutter_barcode_scanner.dart';

接着调用scanBarcode方法实现单次扫描功能：

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

连续扫描

若需要连续扫描而不停止摄像头，可以使用getBarcodeStreamReceiver方法：

FlutterBarcodeScanner.getBarcodeStreamReceiver(
  "#ff6666", 
  "Cancel", 
  false, 
  ScanMode.DEFAULT
).listen((barcode) { 
  // 处理接收到的条形码数据
});

示例代码

下面是一个完整的Dart文件示例，展示了如何集成并使用flutter_barcode_scanner插件来实现条形码和二维码的扫描功能：

import 'dart:async';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:flutter_barcode_scanner/flutter_barcode_scanner.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_barcode_scanner插件的基本介绍及使用指南。希望这些信息能够帮助您快速上手并在您的Flutter项目中集成条形码扫描功能。如果有任何问题或需要进一步的帮助，请随时联系开发者社区或者查阅官方文档。