Flutter NFC经典Mifare卡操作插件nfc_classic_mifare的使用

Flutter NFC经典Mifare卡操作插件nfc_classic_mifare的使用

说明

这是一个用于Android的Flutter插件，用于读取和写入NFC卡片。本插件仅支持Mifare Classic卡，并且仅限于NfcA技术。此外，它仅在默认密码的情况下工作。

注意事项

• 仅支持Mifare Classic卡。
• 仅支持NfcA技术。
• 仅在默认密码的情况下工作。

设置

• 要求Android API级别为19或更高版本。
• 在AndroidManifest.xml文件中添加权限<uses-permission android:name="android.permission.NFC" />。

注意点

• 记住不要在任何卡的扇区0中写入数据。
• 如果在任何扇区的第4个块中写入数据，请记录下你写入的内容，因为这是新的密码，用于读取和写入该扇区的数据。
• 密码参数在所有情况下都是可选的，只有在扇区有自定义密码时才需要。

感谢

此插件基于Andres Maldonado的原始包mifare_nfc_classic（https://github.com/MaldonadoAndres/mifare_nfc_classic/）。遗憾的是，我的拉取请求尚未集成Null Safety功能，所以我发布了自己的分支并使用了新的包名。

使用方法

检查NFC可用性

// 检查NFC是否可用
AVAILABILITY isAvailable = await NfcClassicMifare.availability;

switch(isAvailable) {
  case(AVAILABILITY.AVAILABLE):
    // NFC已启用。
    break;
  case(AVAILABILITY.NOT_ENABLED):
    // 设备支持NFC但用户需要启用它。
    break;
  case(AVAILABILITY.NOT_SUPPORTED):
    // 设备不支持NFC。
    break;
}

获取扇区或块的数量

int _sectorCount = await NfcClassicMifare.sectorCount;
int _blockCount = await NfcClassicMifare.blockCount;

读取特定扇区

// 读取特定扇区
List<String> _sector = await NfcClassicMifare.readSector(sectorIndex: index, password: password);

/*
返回值示例：
[
  "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF"
]
*/

读取特定扇区内的特定块

// 读取特定扇区内的特定块
String _block = await NfcClassicMifare.readBlock(blockIndex: _blockIndex, password: password);

/*
返回值示例：
"FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF"
*/

读取卡片的所有扇区

// 读取卡片的所有扇区
List<List<String>> _card = await NfcClassicMifare.readAll(password: password);

/*
返回值示例：
[
  [
    "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF"
  ],
  ...
  ...
  ...
  [
    "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF"
  ]
]
*/

// 注意：此操作可能需要几秒钟时间，请保持卡片靠近手机至少2秒。

写入特定扇区内的特定块

// 写入特定扇区内的特定块
bool didWrite = await NfcClassicMifare.writeBlock(blockIndex: _blockIndex, message: _message, password: password);

/*
返回值示例：
didWrite 表示操作是否成功完成。
*/

更改扇区的密码

// 更改扇区的密码
await NfcClassicMifare.changePasswordOfSector(sectorIndex: _sectorIndex, newPassword: _newPassword, password: password);

写入原始十六进制数据

// 写入原始十六进制数据
await NfcClassicMifare.writeRawHexToBlock(blockIndex: _blockIndex, message: rawHex, password: password);

完整示例Demo

import 'package:flutter/material.dart';
import 'package:nfc_classic_mifare/nfc_classic_mifare.dart';

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

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

class _MyAppState extends State<MyApp> {
  final isAvailable = NfcClassicMifare.availability;

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: FutureBuilder(
        future: isAvailable,
        builder: (_, snapshot) {
          if (snapshot.connectionState == ConnectionState.done) {
            switch (snapshot.data) {
              case AVAILABILITY.AVAILABLE:
                return ExamplePage();
                break;
              case AVAILABILITY.NOT_ENABLED:
                return Scaffold(
                  body: Center(
                    child: Text('NFC Not Enabled.'),
                  ),
                );
                break;
              case AVAILABILITY.NOT_SUPPORTED:
                return Scaffold(
                  body: Center(
                    child: Text('NFC Not Supported.'),
                  ),
                );
                break;
              default:
                return Scaffold(
                  body: Center(
                    child: Text('How?'),
                  ),
                );
            }
          } else {
            return Container();
          }
        },
      ),
    );
  }
}