鸿蒙开发通信与连接：ohos.connectedTag有源标签

有源标签

说明： 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 开发前请熟悉鸿蒙开发指导文档 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

导入模块

import connectedTag from '@ohos.connectedTag';

connectedTag.init

init(): boolean

初始化有源标签芯片。

需要权限 ：ohos.permission.NFC_TAG

系统能力 ：SystemCapability.Communication.ConnectedTag

• 返回值：| 类型 | 说明 |
  | ---------------- | -------------------------------------- |
  | boolean | true:初始化成功， false:初始化失败。 |

connectedTag.uninit

uninit(): boolean

卸载有源标签芯片资源。

需要权限 ：ohos.permission.NFC_TAG

系统能力 ：SystemCapability.Communication.ConnectedTag

• 返回值：| 类型 | 说明 |
  | ---------------- | ------------------------------------------ |
  | boolean | true:卸载操作成功， false:卸载操作失败。 |

connectedTag.readNdefTag

readNdefTag(): Promise

读取有源标签内容，使用promise方式作为异步方法。

需要权限 ：ohos.permission.NFC_TAG

系统能力 ：SystemCapability.Communication.ConnectedTag

• 返回值：

  类型	说明
  Promise	返回读取有源标签内容。

• 示例

  import connectedTag from '@ohos.connectedTag';
  
  connectedTag.readNdefTag().then(result = > {
      console.log("promise recv ndef response: " + result);
  });
  

connectedTag.readNdefTag

readNdefTag(callback: AsyncCallback): void

读取有源标签内容，使用callback方式作为异步方法。

需要权限 ：ohos.permission.NFC_TAG

系统能力 ：SystemCapability.Communication.ConnectedTag

• 参数

  参数名	类型	必填	说明
  callback	AsyncCallback	是	读取有源标签内容回调函数。

• 示例

  import connectedTag from '@ohos.connectedTag';
  
  connectedTag.readNdefTag(result = > {
      console.log("callback recv ndef response: " + result);
  });
  

connectedTag.writeNdefTag

writeNdefTag(data: string): Promise

写入内容到有源标签，使用promise方式作为异步方法。

需要权限 ：ohos.permission.NFC_TAG

系统能力 ：SystemCapability.Communication.ConnectedTag

• 参数

  参数名	类型	必填	说明
  data	string	是	有源标签内容, 长度最大是1024个字节。

• 返回值：

  类型	说明
  Promise	无返回值。

• 示例

  import connectedTag from '@ohos.connectedTag';
  
  writeNdefTag.write("010203")
      .then((value) = > {
          // 事件写入正常
          console.log(`success to write event: ${value}`);
      }).catch((err) = > {
          // 事件写入异常
          console.error(`failed to write event because ${err.code}`);
      });
  

connectedTag.writeNdefTag

writeNdefTag(data: string, callback: AsyncCallback): void

写入内容到有源标签，使用callback方式作为异步方法。

需要权限 ：ohos.permission.NFC_TAG

系统能力 ：SystemCapability.Communication.ConnectedTag

• 参数

  参数名	类型	必填	说明
  data	string	是	有源标签内容, 长度最大是1024个字节。
  callback	AsyncCallback	是	读取有源标签内容回调函数。

• 示例

  import connectedTag from '@ohos.connectedTag';
  
  connectedTag.writeNdefTag("010203", (err, value) = > {
      if (err) {
          // 事件写入异常
          console.error(`failed to write event because ${err.code}`);
          return;
      }
  
      // 事件写入正常
      console.log(`success to write event: ${value}`);
  });
  

connectedTag.on('notify')

on(type: "notify", callback: Callback): void

注册NFC场强状态事件。

需要权限 ：ohos.permission.NFC_TAG

系统能力 ：SystemCapability.Communication.ConnectedTag

• 参数

  参数名	类型	必填	说明
  type	string	是	固定填"notify"字符串
  callback	Callback	是	状态改变回调函数。

• 状态改变事件的枚举。

  枚举值	说明
  0	NFC离场事件
  1	NFC进场事件

connectedTag.off('notify')

off(type: "notify", callback?: Callback): void

取消NFC场强状态事件的注册。

需要权限 ：ohos.permission.NFC_TAG

系统能力 ：SystemCapability.Communication.ConnectedTag

• 参数

  参数名	类型	必填	说明
  type	string	是	固定填"notify"字符串
  callback	Callback	否	状态改变回调函数。如果callback不填，将“去注册”该事件关联的所有回调函数。HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿

  

• 示例

  import connectedTag from '@ohos.connectedTag';
  
  var NFC_RF_NOTIFY = "notify";
  
  var recvNfcRfNotifyFunc = result = > {
      console.info("nfc rf receive state: " + result);
  }
  
  // Register event
  connectedTag.on(NFC_RF_NOTIFY, recvNfcRfNotifyFunc);
  
  // Unregister event
  connectedTag.off(NFC_RF_NOTIFY, recvNfcRfNotifyFunc);
  

NfcRfType

表示NFC场强状态的枚举。

名称	默认值	说明
NFC_RF_LEAVE	0	NFC离场事件
NFC_RF_ENTER	1	NFC进场事件

审核编辑 黄宇