更新记录

1.0.0（2026-05-18）

1.实现鸿蒙NFC Tag读写封装 2.Tag扫描发现连接 3.NDEF读写 4.原始命令传输 5.NFC能力检测

平台兼容性

鸿蒙 NFC 标签读写插件

安装

插件市场搜索 szy-harmony-nfc 安装。

基础用法

const nfc = uni.requireNativePlugin('szy-harmony-nfc')

// 检查 NFC 支持
const supported = await nfc.isNFCSupported()

// 扫描 Tag
const tag = await nfc.startDiscovery(30000)
console.log('UID:', tag.uid, '技术:', tag.technologies)

// 连接并读取 NDEF
await nfc.connectTag()
const ndef = await nfc.readNDEF()

// 停止扫描
nfc.stopDiscovery()

写入 NDEF

const result = await nfc.writeNDEF({
  records: [{ tnf: 1, type: '', id: '', payload: 'hex_encoded_text' }],
  formatBeforeWrite: false
})

系统要求

• HarmonyOS NEXT 5.0+
• 设备需支持 NFC