更新记录

1.0.0（2026-07-15）

首次发布

平台兼容性

CJ NFC 插件

ly-nfc 是一个 uni-app 插件市场的 uni_modules UTS API 插件，用于封装 App 端 Android NFC 能力。

平台

Android NFC 不需要运行时权限，但需要声明 android.permission.NFC。插件已在 utssdk/app-android/AndroidManifest.xml 中声明。

安装

把插件目录放到项目：

uni_modules/cj-nfc

页面中按插件根路径导入：

import {
  getNfcStatus,
  openNfcSettings,
  startNfcReader,
  stopNfcReader,
  writeNfcText,
  writeNfcUri
} from '@/uni_modules/cj-nfc'

API

getNfcStatus()

同步获取 NFC 状态。

const status = getNfcStatus()
console.log(status.isSupported, status.isEnabled)

返回：

{
  errMsg: string
  isSupported: boolean
  isEnabled: boolean
}

openNfcSettings(options)

打开系统 NFC 设置页。

openNfcSettings({
  success(res) {
    console.log(res.errMsg)
  },
  fail(err) {
    console.log(err.errCode, err.errMsg)
  }
})

startNfcReader(options)

开启 NFC 读卡。贴近标签后会多次触发 onDiscovered。

startNfcReader({
  noPlatformSounds: false,
  success(res) {
    console.log('reader started', res.errMsg)
  },
  onDiscovered(res) {
    console.log(res.tag.id)
    console.log(res.tag.records)
  },
  fail(err) {
    console.log(err.errCode, err.errMsg)
  }
})

stopNfcReader(options)

停止 NFC 读卡。

stopNfcReader({
  success(res) {
    console.log(res.errMsg)
  }
})

writeNfcText(options)

等待贴卡并写入 NDEF Text 记录。默认写入成功后自动停止 reader mode。

writeNfcText({
  text: 'hello uni-app',
  language: 'zh',
  autoStop: true,
  success(res) {
    console.log(res.tag.id)
  },
  fail(err) {
    console.log(err.errCode, err.errMsg)
  }
})

writeNfcUri(options)

等待贴卡并写入 NDEF URI 记录。

writeNfcUri({
  uri: 'https://uniapp.dcloud.net.cn',
  success(res) {
    console.log(res.tag.id)
  }
})

注意

• Android 系统的 NFC 读写必须在真机上测试，模拟器一般没有 NFC 硬件。
• writeNfcText 和 writeNfcUri 仅支持 NDEF 标签；非 NDEF 标签会返回错误。
• iOS CoreNFC 需要额外 entitlement、系统弹窗会话和设备限制，本版本先返回不支持。