搜索插件、代码仓与 APP 分类

插件详情v0.4.0

ndef

一个 Dart 库,用于解码和编码 NDEF 记录,支持多种类型。

AndroidiOSWebmacOSWindowsLinux
近 30 天下载
9.7万
喜欢数
17
Pub 分数
160

安装插件

flutter pub add ndef

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

ndef 包是一个 Dart 库,旨在解码和编码 NDEF(NFC 数据交换格式)记录,从而实现跨多个平台与 NFC 标签的无缝交互。它支持多种 NDEF 记录类型,非常适合涉及非接触式数据交换的应用程序。该库在设计时注重安全性,与加密和基于权限的工作流程高度契合。该库兼容 Android、iOS、Web、macOS、Windows 和 Linux,为 NFC 应用提供了广泛的跨平台功能。

适合场景

  • 读取和写入NFC标签
  • 构建无接触支付系统
  • 启用智能海报交互
  • 创建安全的设备配对流程
  • 开发物联网设备配置工具

主要特点

  • 支持多种NDEF记录类型
  • 跨平台NFC兼容性
  • 安全的数据编码和解码
  • 轻量且易于集成
  • NDEF 结构的内置验证

适合对象

  • 使用NFC的移动应用开发者
  • 注重安全的应用程序构建者
  • 物联网和智能设备集成商
  • 需要NFC支持的Web和桌面应用程序

使用建议

  • 需要设备级别的NFC硬件
  • 必须处理平台特定的权限
  • 仅限NDEF格式
  • 无内置加密(需要外部处理)
  • 可能需要额外的平台设置才能实现完整功能

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

ndef

pub version Test

ndef is a Dart library to decode & encode NDEF records, supporting multiple types including (grouped by Type Name Format):

  • NFC Well-known Records (TNF 1 / urn:nfc:wkt:), with:
    • Text (class T)
    • URI with well-known prefix (class U)
    • Digital signature (class Sig)
    • Smart poster (class Sp), including sub-record:
      • Action (class act)
      • Size (class s)
      • Type (class t)
    • Connection handover (class Hr/Hs/Hm/Hi/Hc/ac/cr)
  • Media Records (TNF 2, containing MIME data), with:
    • Bluetooth easy pairing (class application/vnd.bluetooth.ep.oob)
    • Bluetooth low energy (class application/vnd.bluetooth.le.oob)
  • Absolute URI Records (TNF 3)
  • External Records (TNF 4 / urn:nfc:ext:), with:
    • Android application record (class android.com:pkg)

This library is still under active development and subject to breaking API changes and malfunction. Pull requests and issues are most welcomed, especially on:

  • Bug fixes
  • New support for other record types

Usage

import 'package:ndef/ndef.dart' as ndef;

// encoding
var uriRecord = new ndef.UriRecord.fromString("https://github.com/nfcim/ndef");
var textRecord = new ndef.TextRecord(text: "Hello");
var encodedUriRecord = uriRecord.encode().toHexString(); /// encode a single record, and use our extension method on [Uint8List]
var encodedAllRecords = ndef.encodeNdefMessage([uriRecord, textRecord]).toHexString(); // encode several records as a message

// decoding
var encodedTextRecord = "d1010f5402656e48656c6c6f20576f726c6421";
var decodedRecords = ndef.decodeRawNdefMessage(encodedTextRecord.toBytes());
assert(decodedRecords.length == 1);
if (decodedRecords[0] is ndef.TextRecord) {
  assert(decodeRecords[0].text == "Hello");
}  else {
  // we will not reach here
}

// data-binding (by implementing payload as dynamic getter / setter)
var origPayload = uriRecord.payload!;
print(origPayload.toHexString());
uriRecord.content = "github.com/nfcim/flutter_nfc_kit";
print(uriRecord.payload!.toHexString()); // changed
uriRecord.payload = origPayload;
print(uriRecord.content); // changed back

// decoding by providing parts of a record
var partiallyDecodedUrlRecord = ndef.decodePartialNdefMessage(ndef.TypeNameFormat.nfcWellKnown, utf8.encode("U"), origPayload, id: Uint8List.fromList([0x1, 0x2]));

See example code for a more complete example.

Refer to the documentation for detailed usage.

所属分类

依赖

依赖清单 1 项

源码仓库

使用此插件的项目