NFC-NFCAdapter

最近更新时间:2023-10-20 15:19:20

我的收藏

NFCAdapter

参数及说明:Object tech,标签类型枚举。
属性
类型
说明
ndef
String
对应 Ndef 实例,实例支持对 NDEF 格式的 NFC 标签上的 NDEF 数据的读写
nfcA
String
对应 NfcA 实例,实例支持 NFC-A (ISO 14443-3A) 标准的读写
nfcB
String
对应 NfcB 实例,实例支持 NFC-B (ISO 14443-3B) 标准的读写
isoDep
String
对应 IsoDep 实例,实例支持 ISO-DEP (ISO 14443-4) 标准的读写
nfcF
String
对应 NfcF 实例,实例支持 NFC-F (JIS 6319-4) 标准的读写
nfcV
String
对应 NfcV 实例,实例支持 NFC-V (ISO 15693) 标准的读写
mifareClassic
String
对应 MifareClassic 实例,实例支持 MIFARE Classic 标签的读写
mifareUltralight
String
对应 MifareUltralight 实例,实例支持 MIFARE Ultralight 标签的读写

.startDiscovery

该 方法 使用方式为 NFCAdapter.startDiscovery()
参数及说明:Object object。
属性
类型
默认值
必填
说明
success
Function
-
接口调用成功的回调函数
fail
Function
-
接口调用成功的回调函数
complete
Function
-
接口调用结束的回调函数(调用成功、失败都会执行)
错误码
错误码
错误信息
说明
13000
设备不支持 NFC
-
13001
系统 NFC 开关未打开
-
13010
未知错误
-
13019
user is not authorized
用户未授权
13011
invalid parameter
参数无效
13012
parse NdefMessage failed
将参数解析为 NdefMessage 失败
13021
NFC discovery already started
已经开始 NFC 扫描
13018
NFC discovery has not started
尝试在未开始 NFC 扫描时,停止 NFC 扫描
13022
Tech already connected
标签已经连接
13023
Tech has not connected
尝试在未连接标签时断开连接
13013
NFC tag has not been discovered
未扫描到 NFC 标签
13014
invalid tech
无效的标签技术
13015
unavailable tech
从标签上获取对应技术失败
13024
function not support
当前标签技术不支持该功能
13017
system internal error
相关读写操作失败
13016
connect fail
连接失败

.stopDiscovery

该 方法 使用方式为 NFCAdapter.stopDiscovery()
参数及说明:Object object。
属性
类型
默认值
必填
说明
success
function
-
接口调用成功的回调函数
fail
function
-
接口调用失败的回调函数
complete
function
-
接口调用结束的回调函数(调用成功、失败都会执行)
错误码
错误码
错误信息
说明
13000
设备不支持 NFC
-
13001
系统 NFC 开关未打开
-
13010
未知错误
-
13019
user is not authorized
用户未授权
13011
invalid parameter
参数无效
13012
parse NdefMessage failed
将参数解析为 NdefMessage 失败
13021
NFC discovery already started
已经开始 NFC 扫描
13018
NFC discovery has not started
尝试在未开始 NFC 扫描时,停止 NFC 扫描
13022
Tech already connected
标签已经连接
13023
Tech has not connected
尝试在未连接标签时断开连接
13013
NFC tag has not been discovered
未扫描到 NFC 标签
13014
invalid tech
无效的标签技术
13015
unavailable tech
从标签上获取对应技术失败
13024
function not support
当前标签技术不支持该功能
13017
system internal error
相关读写操作失败
13016
connect fail
连接失败

.getNdef

该 方法 使用方式为 Ndef NFCAdapter.getNdef()
功能说明:获取 Ndef 实例,实例支持对 NDEF 格式的 NFC 标签上的 NDEF 数据的读写。
返回值:Ndef

.getNfcA

该 方法 使用方式为 NfcA NFCAdapter.getNfcA()
功能说明:获取 NfcA 实例,实例支持 NFC-A (ISO 14443-3A) 标准的读写。
返回值:NfcA

.getNfcB

该 方法 使用方式为 NfcB NFCAdapter.getNfcB()
功能说明:获取 NfcB 实例,实例支持 NFC-B (ISO 14443-3B) 标准的读写。
返回值:NfcB

.getNfcF

该 方法 使用方式为 NfcF NFCAdapter.getNfcF()
功能说明:获取 NfcF 实例,实例支持 NFC-F (JIS 6319-4) 标准的读写。
返回值:NfcF

.getNfcV

该 方法 使用方式为 NfcV NFCAdapter.getNfcV()
功能说明:获取 NfcV 实例,实例支持 NFC-V (ISO 15693) 标准的读写。
返回值:NfcV

.getIsoDep

该 方法 使用方式为 IsoDep NFCAdapter.getlsoDep()
功能说明:获取 IsoDep 实例,实例支持 ISO-DEP (ISO 14443-4) 标准的读写。
返回值:IsoDep

.getMifareClassic

该 方法 使用方式为 MifareClassic NFCAdapter.getMifareClassic()
功能说明:获取 MifareClassic 实例,实例支持 MIFARE Classic 标签的读写。
返回值:MifareClassic

.getMifareUltralight

该 方法 使用方式为 MifareUltralight NFCAdapter.getMifareUltralight()
功能说明:获取 MifareUltralight 实例,实例支持 MIFARE Ultralight 标签的读写。
参数说明:MifareUltralight

.onDiscovered

该 方法 使用方式为 NFCAdapter.onDiscovered(function listener)
功能说明:监听 NFC Tag。
参数说明:function listener 的监听函数,参数为 Object res。
属性
类型
说明
id
ArrayBuffer
-
techs
Array
tech 数组,用于匹配 NFC 卡片具体可以使用什么标准( NfcA 等实例)处理
messages
Array
NdefMessage 数组,消息格式为 {id: ArrayBuffer, type: ArrayBuffer, payload: ArrayBuffer}

.offDiscovered

该 方法 使用方式为 NFCAdapter.offDiscovered(function listener)
功能说明:移除 NFC Tag 的监听函数。
参数及说明:function listener,onDiscovered 传入的监听函数。不传此参数则移除所有监听函数。
示例代码
const listener = function (res) { console.log(res) }

NFCAdapter.onDiscovered(listener)
NFCAdapter.offDiscovered(listener) // 需传入与监听时同一个的函数对象