有源標(biāo)簽

說(shuō)明： 本模塊首批接口從API version 8開(kāi)始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。 開(kāi)發(fā)前請(qǐng)熟悉鴻蒙開(kāi)發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

導(dǎo)入模塊

import connectedTag from '@ohos.connectedTag';

connectedTag.init

init(): boolean

初始化有源標(biāo)簽芯片。

需要權(quán)限 ：ohos.permission.NFC_TAG

系統(tǒng)能力 ：SystemCapability.Communication.ConnectedTag

• 返回值：| 類型 | 說(shuō)明 |
  | ---------------- | -------------------------------------- |
  | boolean | true:初始化成功， false:初始化失敗。 |

connectedTag.uninit

uninit(): boolean

卸載有源標(biāo)簽芯片資源。

需要權(quán)限 ：ohos.permission.NFC_TAG

系統(tǒng)能力 ：SystemCapability.Communication.ConnectedTag

• 返回值：| 類型 | 說(shuō)明 |
  | ---------------- | ------------------------------------------ |
  | boolean | true:卸載操作成功， false:卸載操作失敗。 |

connectedTag.readNdefTag

readNdefTag(): Promise

讀取有源標(biāo)簽內(nèi)容，使用promise方式作為異步方法。

需要權(quán)限 ：ohos.permission.NFC_TAG

系統(tǒng)能力 ：SystemCapability.Communication.ConnectedTag

• 返回值：

  類型	說(shuō)明
  Promise	返回讀取有源標(biāo)簽內(nèi)容。

• 示例

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

connectedTag.readNdefTag

readNdefTag(callback: AsyncCallback): void

讀取有源標(biāo)簽內(nèi)容，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.NFC_TAG

系統(tǒng)能力 ：SystemCapability.Communication.ConnectedTag

• 參數(shù)

  參數(shù)名	類型	必填	說(shuō)明
  callback	AsyncCallback	是	讀取有源標(biāo)簽內(nèi)容回調(diào)函數(shù)。

• 示例

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

connectedTag.writeNdefTag

writeNdefTag(data: string): Promise

寫(xiě)入內(nèi)容到有源標(biāo)簽，使用promise方式作為異步方法。

需要權(quán)限 ：ohos.permission.NFC_TAG

系統(tǒng)能力 ：SystemCapability.Communication.ConnectedTag

• 參數(shù)

  參數(shù)名	類型	必填	說(shuō)明
  data	string	是	有源標(biāo)簽內(nèi)容, 長(zhǎng)度最大是1024個(gè)字節(jié)。

• 返回值：

  類型	說(shuō)明
  Promise	無(wú)返回值。

• 示例

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

connectedTag.writeNdefTag

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

寫(xiě)入內(nèi)容到有源標(biāo)簽，使用callback方式作為異步方法。

需要權(quán)限 ：ohos.permission.NFC_TAG

系統(tǒng)能力 ：SystemCapability.Communication.ConnectedTag

• 參數(shù)

  參數(shù)名	類型	必填	說(shuō)明
  data	string	是	有源標(biāo)簽內(nèi)容, 長(zhǎng)度最大是1024個(gè)字節(jié)。
  callback	AsyncCallback	是	讀取有源標(biāo)簽內(nèi)容回調(diào)函數(shù)。

• 示例

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

connectedTag.on('notify')

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

注冊(cè)NFC場(chǎng)強(qiáng)狀態(tài)事件。

需要權(quán)限 ：ohos.permission.NFC_TAG

系統(tǒng)能力 ：SystemCapability.Communication.ConnectedTag

• 參數(shù)

  參數(shù)名	類型	必填	說(shuō)明
  type	string	是	固定填"notify"字符串
  callback	Callback	是	狀態(tài)改變回調(diào)函數(shù)。

• 狀態(tài)改變事件的枚舉。

  枚舉值	說(shuō)明
  0	NFC離場(chǎng)事件
  1	NFC進(jìn)場(chǎng)事件

connectedTag.off('notify')

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

取消NFC場(chǎng)強(qiáng)狀態(tài)事件的注冊(cè)。

需要權(quán)限 ：ohos.permission.NFC_TAG

系統(tǒng)能力 ：SystemCapability.Communication.ConnectedTag

• 參數(shù)

  參數(shù)名	類型	必填	說(shuō)明
  type	string	是	固定填"notify"字符串
  callback	Callback	否	狀態(tài)改變回調(diào)函數(shù)。如果callback不填，將“去注冊(cè)”該事件關(guān)聯(lián)的所有回調(diào)函數(shù)。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場(chǎng)強(qiáng)狀態(tài)的枚舉。

審核編輯 黃宇