Flutter卡片扫描插件card_scanner的使用

快速、准确且安全的信用卡与借记卡扫描器插件

card_scanner 是一个用于准确且快速扫描借记卡和信用卡的 Flutter 插件。

功能 #

• 🔒完全离线扫描，使其成为一个完全安全的扫描器！
• 🎈可以扫描 有效期、持卡人姓名 和 发卡机构（其他扫描器缺乏此功能）以及 卡号✨
• 🔋由 Google 的机器学习模型提供支持
• ⚡ 性能卓越且准确性高
• 🧹自动使用卡校验算法检查卡号错误
• 🎚支持控制参数以平衡速度和准确性
• ❤️ 简单、强大且直观的 API

获取演示应用 #

安装 #

在您的 pubspec.yaml 文件中添加以下内容：

dependencies:
  card_scanner: <latest-version>

获取最新版本号 此处

使用 #

只需导入包并调用 scanCard 方法：

import 'package:card_scanner/card_scanner.dart';
var cardDetails = await CardScanner.scanCard();

print(cardDetails);

示例输出：

Card Number = 5173949117389006
Expiry Date = 11/26

上述代码会打开设备相机，查找有效卡并获取所需信息，返回一个 CardDetails 对象。

扫描选项 #

如果您希望获取持卡人姓名和发卡机构，可以指定选项：

import 'package:card_scanner/card_scanner.dart';
var cardDetails = await CardScanner.scanCard(
    scanOptions: CardScanOptions(
        scanCardHolderName: true,
        scanCardIssuer: true,
    ),
);

print(cardDetails);

示例输出：

Card Number = 5173949117389006
Expiry Date = 11/26
Card Issuer = mastercard
Card Holder Name = PAUL SAMUELSON

iOS 要求 #

• iOS 的最低目标版本应为 >= 12.0.0。
• 在您的 Flutter 项目的 `Podfile` 中注释掉 `use_frameworks!` 行。 您可以在 `your_flutter_project/ios/Podfile` 中找到该文件。

文档与示例 📖 #

示例代码

以下是完整的示例代码：

import 'package:card_scanner_example/scan_option_configure_widget/scan_option_configure_widget.dart';
import 'package:flutter/material.dart';
import 'dart:async';
import 'package:card_scanner/card_scanner.dart';

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

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

class _MyAppState extends State<MyApp> {
  CardDetails? _cardDetails;
  CardScanOptions scanOptions = CardScanOptions(
    scanCardHolderName: true,
    // enableDebugLogs: true,
    validCardsToScanBeforeFinishingScan: 5,
    possibleCardHolderNamePositions: [
      CardHolderNameScanPosition.aboveCardNumber,
    ],
  );

  Future<void> scanCard() async {
    var cardDetails = await CardScanner.scanCard(scanOptions: scanOptions);
    if (!mounted) return;
    setState(() {
      _cardDetails = cardDetails;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('card_scanner app'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.spaceEvenly,
            children: [
              ElevatedButton(
                onPressed: () async {
                  scanCard();
                },
                child: Text('scan card'),
              ),
              Text('$_cardDetails'),
              Expanded(
                child: OptionConfigureWidget(
                  initialOptions: scanOptions,
                  onScanOptionChanged: (newOptions) => scanOptions = newOptions,
                ),
              )
            ],
          ),
        ),
      ),
    );
  }
}