Flutter NFC检测与EMV卡识别插件ad_hoc_ident_nfc_detect_emv的使用

该插件是ad_hoc_ident框架的一部分，提供了基于EMV-NFC-Paycard-Enrollment读取EMV卡的功能。该插件依赖于来自ad_hoc_ident_nfc的NfcTag实现。

注意事项

1. 目前仅支持Android平台。
2. 使用NFC和相机同时工作可能会导致应用程序崩溃。在展示NFC标签之前，请禁用相机。

特性

该包包含三个领域包，并且每个领域包都提供了一些实现包。

• 检测EMV卡号并解析为AdHocIdentity。
• 基于EMV-NFC-Paycard-Enrollment。

开始使用

在你的应用的pubspec.yaml文件中添加主领域包，并添加你需要的特性的包。

使用示例

熟悉ad_hoc_ident包中的示例应用，因为它提供了如何组合不同包的良好概述。否则，你可以根据需要选择和匹配功能。所有已经实现的功能在其对应的领域包中都有接口定义，因此你可以轻松地创建和集成你自己的实现。

完整示例代码

以下是完整的示例代码，展示了如何使用该插件进行NFC检测和EMV卡识别。

import 'dart:async';

import 'package:ad_hoc_ident/ad_hoc_ident.dart';
import 'package:ad_hoc_ident_nfc/ad_hoc_ident_nfc.dart';
import 'package:ad_hoc_ident_nfc_detect_emv/ad_hoc_ident_nfc_detect_emv.dart';
import 'package:ad_hoc_ident_nfc_scanner_nfc_manager/ad_hoc_ident_nfc_scanner_nfc_manager.dart';
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

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

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  late final NfcScanner _nfcScanner;

  Stream<AdHocIdentity?> get _identityStream => _nfcScanner.stream;
  String? _error;

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

    initPlatformState();
  }

  // 平台消息是异步的，所以我们初始化在一个异步方法中。
  Future<void> initPlatformState() async {
    String? error;
    try {
      _nfcScanner = NfcManagerNfcScanner(
        detector: NfcDetectorEmv(),
        encrypter: AdHocIdentityEncrypter.fromDelegate(
          // 在生产代码中使用一个合适的加密器
          // 一些实现可以在ad_hoc_ident_util_crypto中找到
          (identity) async => identity,
        ),
      );
      final available = await _nfcScanner.isAvailable();
      if (available) {
        _nfcScanner.start();
      } else {
        _error = 'NFC不可用。打开手机的NFC设置并重新尝试。';
      }
    } on PlatformException catch (e) {
      error = '启动NFC服务失败: $e';
    }

    // 如果小部件在异步平台消息飞行时从树中被移除，我们希望丢弃回复而不是调用setState来更新我们的非存在的外观。
    if (!mounted) return;

    setState(() {
      _error = error;
    });
  }

  [@override](/user/override)
  void dispose() {
    _nfcScanner.stop();
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    final error = _error;
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
          actions: [
            IconButton.outlined(
                onPressed: _nfcScanner.restart,
                icon: const Icon(Icons.restart_alt)),
          ],
        ),
        body: Center(
          child: error != null
              ? Text(error)
              : StreamBuilder(
                  stream: _identityStream,
                  builder: (context, snapshot) =>
                      snapshot.hasData
                          ? Text(snapshot.data!.identifier)
                          : snapshot.connectionState == ConnectionState.waiting
                              ? const Text('请扫描NFC标签。')
                              : snapshot.hasError
                                  ? Text(snapshot.error!.toString())
                                  : const Text(
                                      '此NFC标签未检测到身份。'),
                ),
        ),
      ),
    );
  }
}