# wx.onHCEMessage(function listener)

> 基础库 1.7.0 开始支持，低版本需做[兼容处理](1003706)。

> __小程序插件__：支持，需要小程序基础库版本不低于 [2.9.1](1003706)
> 
> __微信 iOS 版__：不支持
> 
> __微信 鸿蒙 OS 版__：支持

> 相关文档: [近场通信 (NFC)](/miniprogram/dev/framework/device/nfc.md)

## 功能描述

监听接收 NFC 设备消息事件。仅能注册一个监听

## 参数

### function listener

接收 NFC 设备消息事件的监听函数

#### 参数

##### Object res


```json
[
  {
    "属性": "messageType",
    "类型": "number",
    "说明": "消息类型",
    "子项": [
      {
        "合法值": "1",
        "说明": "HCE APDU Command类型，小程序需对此指令进行处理，并调用 sendHCEMessage 接口返回处理指令"
      },
      {
        "合法值": "2",
        "说明": "设备离场事件类型"
      }
    ]
  },
  {
    "属性": "data",
    "类型": "ArrayBuffer",
    "说明": "\u0000INLINECODE_0\u0000 时 ,客户端接收到 NFC 设备的指令"
  },
  {
    "属性": "reason",
    "类型": "number",
    "说明": "\u0000INLINECODE_1\u0000 时，原因"
  }
]
```