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) // 需传入与监听时同一个的函数对象