管理NFC狀態(tài)

導(dǎo)入模塊

import controller from '@ohos.nfc.controller';

NfcState

定義不同的NFC狀態(tài)值。

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

controller.isNfcAvailable

isNfcAvailable(): boolean

查詢?cè)O(shè)備是否有NFC能力。

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

返回值：

controller.openNfc

openNfc(): boolean

打開NFC開關(guān)。

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

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

返回值：

controller.enableNfc9+

enableNfc(): boolean

打開NFC開關(guān)。

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

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

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見NFC錯(cuò)誤碼。

controller.closeNfc

closeNfc(): boolean

關(guān)閉NFC開關(guān)。

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

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

返回值：

controller.disableNfc9+

disableNfc(): boolean

關(guān)閉NFC開關(guān)。

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

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

錯(cuò)誤碼：

以下錯(cuò)誤碼的詳細(xì)介紹請(qǐng)參見NFC錯(cuò)誤碼。

controller.isNfcOpen

isNfcOpen(): boolean

查詢NFC是否打開。

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

返回值：

controller.getNfcState

getNfcState(): NfcState

查詢NFC狀態(tài)。

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

返回值：

controller.on('nfcStateChange')

on(type: "nfcStateChange", callback: Callback<NfcState>): void

注冊(cè)NFC開關(guān)狀態(tài)事件，通過Callback方式獲取NFC狀態(tài)的變化通知。

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

參數(shù)

controller.off('nfcStateChange')

off(type: "nfcStateChange", callback?: Callback<NfcState>): void

取消NFC開關(guān)狀態(tài)事件的注冊(cè)，取消后NFC狀態(tài)變化時(shí)，就不會(huì)再收到Callback的通知。

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

參數(shù)

示例

import controller from '@ohos.nfc.controller';

// register callback to receive the nfc state changed notification
controller.on("nfcStateChange", (err, nfcState)=> {
  if (err) {
      console.log("controller on callback err: " + err);
  } else {
      console.log("controller on callback nfcState: " + nfcState);
  }
});

// open nfc, require permission: ohos.permission.MANAGE_SECURE_SETTINGS
if (!controller.isNfcOpen()) {
  var ret = controller.openNfc();
  console.log("controller openNfc ret: " + ret);
}

// from api9, use 'enableNfc' to open nfc.
try {
    controller.enableNfc();
    console.log("controller enableNfc success");
} catch (busiError) {
    console.log("controller enableNfc busiError: " + busiError);
}

// close nfc, require permission: ohos.permission.MANAGE_SECURE_SETTINGS
if (controller.isNfcOpen()) {
  var ret = controller.closeNfc();
  console.log("controller closeNfc ret: " + ret);
}

// from api9, use 'disableNfc' to close nfc.
try {
    controller.disableNfc();
    console.log("controller disableNfc success");
} catch (busiError) {
    console.log("controller disableNfc busiError: " + busiError);
}

// unregister callback
controller.off("nfcStateChange");