flutter_nfc_kit如何封装使用

在Flutter项目中集成flutter_nfc_kit时遇到几个问题：

  1. 如何正确配置Android/iOS的权限和依赖？
  2. 读取NFC标签数据的具体代码示例是怎样的？
  3. 如何处理不同NFC协议（如ISO14443/NDEF）的兼容性问题？
  4. 是否需要额外处理后台扫描或超时逻辑？
  5. 有没有推荐的最佳实践来封装成可复用的组件？
    希望有实际使用经验的大佬分享一下具体实现步骤和避坑指南！
2 回复

使用flutter_nfc_kit需在pubspec.yaml添加依赖，导入包后调用NfcKit.read()读取NFC标签。支持NDEF、ISO14443等协议，需处理权限和平台配置。

更多关于flutter_nfc_kit如何封装使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


Flutter NFC Kit 是一个用于在 Flutter 应用中访问 NFC 功能的插件。以下是其封装和使用的基本步骤：

1. 添加依赖

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

dependencies:
  flutter_nfc_kit: ^4.0.0

运行 flutter pub get 安装。

2. 配置平台权限

  • Android：在 AndroidManifest.xml 中添加 NFC 权限：
    <uses-permission android:name="android.permission.NFC" />
  • iOS：在 Info.plist 中添加 NFC 使用描述：
    <key>NFCReaderUsageDescription</key>
<string>需要NFC功能进行数据交互</string>

3. 封装 NFC 服务类

创建一个 NFCService 类来封装常用操作：

import 'package:flutter_nfc_kit/flutter_nfc_kit.dart';

class NFCService {
  // 检查设备是否支持 NFC
  static Future<bool> get isAvailable async {
    return await FlutterNfcKit.nfcAvailability == NFCAvailability.available;
  }

  // 开始 NFC 会话并读取标签
  static Future<NFCTag?> readTag() async {
    try {
      return await FlutterNfcKit.poll(
        timeout: const Duration(seconds: 10),
      );
    } catch (e) {
      print("读取失败: $e");
      return null;
    }
  }

  // 写入 NDEF 消息
  static Future<void> writeNDEF(List<String> records) async {
    try {
      await FlutterNfcKit.writeNDEFRecords(records);
    } catch (e) {
      print("写入失败: $e");
    }
  }

  // 结束 NFC 会话
  static Future<void> stopSession() async {
    await FlutterNfcKit.finish();
  }
}

4. 在界面中使用

在 Flutter 页面中调用封装的方法：

Future<void> startNFCReading() async {
  if (await NFCService.isAvailable) {
    NFCTag? tag = await NFCService.readTag();
    if (tag != null) {
      print("检测到标签: ${tag.standard}");
      // 处理标签数据
    }
  } else {
    print("设备不支持NFC");
  }
}

// 在按钮点击事件中调用
ElevatedButton(
  onPressed: startNFCReading,
  child: Text("读取NFC"),
)

5. 注意事项

  • Android 需要在前台活动才能使用 NFC。
  • iOS 仅支持 NDEF 格式，且需要用户明确授权。
  • 使用后务必调用 finish() 结束会话。

通过以上封装，可以简化 NFC 操作，提高代码复用性。

回到顶部