微信小程序开发文档 第20页

NfcB 基础库 2.11.2 开始支持，低版本需做兼容处理。 NfcB 标签 方法： NfcB.close(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 断开连接 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） NfcB.connect(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 连接 NFC 标签 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） NfcB.getMaxTransceiveLength(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 获取最大传输长度 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） object.success 回调函数 参数 Object res 属性 类型 说明 length number 最大传输长度 NfcB.setTimeout(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 设置超时时间 参数 Object object 属性 类型 默认值 必填 说明 timeout number 是 设置超时时间 (ms) success function 否...

NFCAdapter 基础库 2.11.2 开始支持，低版本需做兼容处理。 属性 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标签的读写 方法： IsoDep NFCAdapter.getIsoDep() 基础库 2.11.2 开始支持，低版本需做兼容处理。 获取IsoDep实例，实例支持ISO-DEP (ISO 14443-4)标准的读写 返回值 IsoDep MifareClassic NFCAdapter.getMifareClassic() 基础库 2.11.2 开始支持，低版本需做兼容处理。 获取MifareClassic实例，实例支持MIFARE Classic标签的读写 返回值 MifareClassic MifareUltralight NFCAdapter.getMifareUltralight() 基础库 2.11.2 开始支持，低版本需做兼容处理。 获取MifareUltralight实例，实例支持MIFARE Ultralight标签的读写 返回值 MifareUltralight Ndef NFCAdapter.getNdef() 基础库 2.11.2 开始支持，低版本需做兼容处理。 获取Ndef实例，实例支持对NDEF格式的NFC标签上的NDEF数据的读写 返回值 Ndef NfcA NFCAdapter.getNfcA() 基础库 2.11.2 开始支持，低版本需做兼容处理。 获取NfcA实例，实例支持NFC-A (ISO 14443-3A)标准的读写 返回值 NfcA NfcB NFCAdapter.getNfcB() 基础库 2.11.2 开始支持，低版本需做兼容处理。 获取NfcB实例，实例支持NFC-B (ISO 14443-3B)标准的读写 返回值 NfcB NfcF NFCAdapter.getNfcF() 基础库 2.11.2 开始支持，低版本需做兼容处理。 获取NfcF实例，实例支持NFC-F (JIS 6319-4)标准的读写 返回值 NfcF NfcV NFCAdapter.getNfcV() 基础库 2.11.2 开始支持，低版本需做兼容处理。 获取NfcV实例，实例支持NFC-V (ISO 15693)标准的读写 返回值 NfcV NFCAdapter.offDiscovered(function callback) 基础库 2.11.2...

NfcA 基础库 2.11.2 开始支持，低版本需做兼容处理。 NfcA 标签 方法： NfcA.close(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 断开连接 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） NfcA.connect(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 连接 NFC 标签 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） NfcA.getAtqa(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 获取ATQA信息 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） object.success 回调函数 参数 Object res 属性 类型 说明 atqa ArrayBuffer 返回 ATQA/SENS_RES 数据 NfcA.getMaxTransceiveLength(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 获取最大传输长度 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function...

Ndef 基础库 2.11.2 开始支持，低版本需做兼容处理。 Ndef 标签 方法： Ndef.close(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 断开连接 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） Ndef.connect(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 连接 NFC 标签 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） Ndef.offNdefMessage(function callback) 基础库 2.11.2 开始支持，低版本需做兼容处理。 取消监听 Ndef 消息 参数 function callback Ndef.onNdefMessage(function callback) 基础库 2.11.2 开始支持，低版本需做兼容处理。 监听 Ndef 消息 参数 function callback Ndef.setTimeout(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 设置超时时间 参数 Object object 属性 类型 默认值 必填 说明 timeout number 是 设置超时时间 (ms) success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） Ndef.writeNdefMessage(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 重写...

MifareUltralight 基础库 2.11.2 开始支持，低版本需做兼容处理。 MifareUltralight 标签 方法： MifareUltralight.close(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 断开连接 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） MifareUltralight.connect(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 连接 NFC 标签 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） MifareUltralight.getMaxTransceiveLength(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 获取最大传输长度 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） object.success 回调函数 参数 Object res 属性 类型 说明 length number 最大传输长度 MifareUltralight.setTimeout(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 设置超时时间 参数 Object object 属性 类型 默认值 必填 说明 timeout number 是 设置超时时间 (ms) success function 否...

MifareClassic 基础库 2.11.2 开始支持，低版本需做兼容处理。 MifareClassic 标签 方法： MifareClassic.close(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 断开连接 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） MifareClassic.connect(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 连接 NFC 标签 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） MifareClassic.getMaxTransceiveLength(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 获取最大传输长度 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） object.success 回调函数 参数 Object res 属性 类型 说明 length number 最大传输长度 MifareClassic.setTimeout(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 设置超时时间 参数 Object object 属性 类型 默认值 必填 说明 timeout number 是 设置超时时间 (ms) success function 否...

IsoDep 基础库 2.11.2 开始支持，低版本需做兼容处理。 IsoDep 标签 方法： IsoDep.close(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 断开连接 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） IsoDep.connect(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 连接 NFC 标签 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） IsoDep.getHistoricalBytes(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 获取复位信息 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） object.success 回调函数 参数 Object res 属性 类型 说明 histBytes ArrayBuffer 返回历史二进制数据 IsoDep.getMaxTransceiveLength(Object object) 基础库 2.11.2 开始支持，低版本需做兼容处理。 获取最大传输长度 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数...

wx.getHCEState(Object object) 基础库 1.7.0 开始支持，低版本需做兼容处理。 判断当前设备是否支持 HCE 能力。 参数 Object object 属性 类型 默认值 必填 说明 success function 否 接口调用成功的回调函数 fail function 否 接口调用失败的回调函数 complete function 否 接口调用结束的回调函数（调用成功、失败都会执行） 错误 错误码 错误信息 说明 0 ok 正常 13000 当前设备不支持NFC 13001 当前设备支持NFC，但系统NFC开关未开启 13002 当前设备支持NFC，但不支持HCE 13003 AID列表参数格式错误 13004 未设置微信为默认NFC支付应用 13005 返回的指令不合法 13006 注册AID失败 示例代码 wx.getHCEState({ success (res) { console.log(res.errCode) } })

NFCAdapter wx.getNFCAdapter() 基础库 2.11.2 开始支持，低版本需做兼容处理。 获取 NFC 实例 返回值 NFCAdapter NFC 实例 错误 错误码 错误信息 说明 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 连接失败

wx.onHCEMessage(function callback) 基础库 1.7.0 开始支持，低版本需做兼容处理。 监听接收 NFC 设备消息事件，仅能注册一个监听 参数 function callback 接收 NFC 设备消息事件的回调函数 参数 Object res 属性 类型 说明 messageType number 消息类型 data ArrayBuffer messageType=1 时 ,客户端接收到 NFC 设备的指令 reason number messageType=2 时，原因 messageType 的合法值 值 说明 最低版本 1 HCE APDU Command类型，小程序需对此指令进行处理，并调用 sendHCEMessage 接口返回处理指令 2 设备离场事件类型