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

flutter_barcode_scanner_ohos

flutter_barcode_scanner_ohos 是一个为 Flutter 应用添加条形码扫描功能的插件，支持在 Ohos 平台上运行。

如何使用？

要在 Ohos 上使用此插件，首先需要在 module.json5 文件中添加相机权限。

"requestPermissions": [
    {
        "name": "ohos.permission.CAMERA",
        "reason": "$string:reason",
        "usedScene": {
            "abilities": [
                "EntryAbility"
            ],
            "when": "inuse"
        }
    }
]

之后，在 pubspec.yaml 文件中添加依赖：

dependencies:
  ...
  flutter_barcode_scanner: ^2.0.0

使用方法

一、单次扫描

步骤 1：导入包

首先需要导入 flutter_barcode_scanner_ohos 包。

import 'package:flutter_barcode_scanner_ohos/flutter_barcode_scanner_ohos.dart';

步骤 2：调用 scanBarcode 方法

使用 scanBarcode 方法来访问条形码扫描功能。

String barcodeScanRes = await FlutterBarcodeScanner.scanBarcode(
    COLOR_CODE, 
    CANCEL_BUTTON_TEXT, 
    isShowFlashIcon, 
    scanMode);

参数说明：

• COLOR_CODE: 条形码覆盖层线条的颜色，可以传递你选择的十六进制颜色值。
• CANCEL_BUTTON_TEXT: 取消按钮的文字，可以根据你的语言需求自定义。
• isShowFlashIcon: 布尔值，用于控制是否显示闪光灯图标。
• scanMode: 枚举类型，用户可以选择 { QR, BARCODE, DEFAULT } 中的任意一种。如果没有指定，默认值为 QR。

注意: 当前 scanMode 仅用于显示条形码和二维码的图形覆盖，无论选择哪种模式，都会扫描条形码和二维码。

二、连续扫描

如果需要持续扫描条形码而不关闭摄像头，可以使用 getBarcodeStreamReceiver 方法。

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

参数与单次扫描类似。

完整示例代码

以下是一个完整的示例代码，展示如何使用 flutter_barcode_scanner_ohos 插件进行条形码扫描。

import 'dart:async';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:flutter_barcode_scanner_ohos/flutter_barcode_scanner_ohos.dart';

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

class MyApp extends StatefulWidget {
  [@override](/user/override)
  _MyAppState createState() => _MyAppState();
}

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

  [@override](/user/override)
  void initState() {
    super.initState();
  }

  // 开始连续扫描
  Future<void> startBarcodeScanStream() async {
    FlutterBarcodeScanner.getBarcodeStreamReceiver(
        '#ff6666', 'Cancel', true, ScanMode.both)!
        .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 = '扫描失败';
    }

    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 = '扫描失败';
    }

    if (!mounted) return;

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
        home: Scaffold(
            appBar: AppBar(title: const Text('条形码扫描')),
            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('开始条形码扫描')),
                        ElevatedButton(
                            onPressed: () => scanQR(),
                            child: Text('开始二维码扫描')),
                        ElevatedButton(
                            onPressed: () => startBarcodeScanStream(),
                            child: Text('开始连续扫描')),
                        Text('扫描结果: $_scanBarcode\n',
                            style: TextStyle(fontSize: 20))
                      ]));
            })));
  }
}