更新记录

1.0.1（2026-07-05）

1.新增 Android 2.兼容uni-app x

功能添加如下： | 检查支持 | 检测设备是否支持 NFC | 检查开关 | 检测 NFC 是否开启 | 开启监听 | 开始监听 NFC 卡片 | 读取数据 | 读取 NFC 卡片数据 | 关闭监听 | 停止监听 NFC 卡片

平台兼容性

uni-app x(5.07)

dj-nfc - NFC 读取插件 for uniapp-x

NFC 读取功能插件，支持真实 NFC 标签读取

前置

调试前，需制定自定义调试基座

安装

无需安装，项目已内置

使用示例

1. 引入插件

import {
    isNfcSupported,
    isNfcEnabled,
    open,
    close,
    setOnNfcDataListener
} from '@/uni_modules/dj-nfc'

2. 基础 API

// 检查设备是否支持 NFC
isNfcSupported({
    success: (res) => {
        console.log('设备是否支持:', res.supported)
    }
})

// 检查 NFC 是否开启
isNfcEnabled({
    success: (res) => {
        console.log('NFC 是否开启:', res.enabled)
    }
})

// 设置 NFC 数据监听回调
setOnNfcDataListener((data: string) => {
    console.log('读取到的 NFC 数据:', data)
})

// 开启 NFC 监听
open({
    success: (res) => {
        console.log(res.msg)
    }
})

// 关闭 NFC 监听
close({
    success: (res) => {
        console.log(res.msg)
    }
})

功能说明

API 接口

isNfcSupported(options)

检查设备是否支持 NFC

参数

• options.success: 成功回调函数，返回 { code: 0, msg: 'success', supported: boolean }

isNfcEnabled(options)

检查 NFC 是否开启

参数

• options.success: 成功回调函数，返回 { code: 0, msg: 'success', enabled: boolean }

open(options)

开启 NFC 监听

参数

• options.success: 成功回调函数，返回 { code: 0, msg: 'NFC 监听已开启' }

close(options)

关闭 NFC 监听

参数

• options.success: 成功回调函数，返回 { code: 0, msg: 'NFC 监听已关闭' }

setOnNfcDataListener(callback)

设置 NFC 数据监听回调，当读取到 NFC 标签时会自动触发

参数

• callback: 回调函数，接收读取到的 NFC 数据字符串

平台支持

注意事项

1. 使用前请确保设备支持 NFC 且已在系统设置中开启
2. 开启 NFC 监听后，将 NFC 标签贴近手机背面即可读取
3. 本插件仅支持 NFC 读取功能，不支持写入

许可证

MIT