diff --git a/zh-cn/application-dev/reference/apis/js-apis-nfcController.md b/zh-cn/application-dev/reference/apis/js-apis-nfcController.md index a9c7ef7d72a5b0e11a2e4eda9bb9cc028e1f0550..87fc40e6959e3da7907f5f70ab18f26893e13854 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-nfcController.md +++ b/zh-cn/application-dev/reference/apis/js-apis-nfcController.md @@ -1,6 +1,6 @@ -# 标准NFC +# 标准NFC-Tag -本模块主要用于操作及管理NFC。 +本模块主要用于操作及管理NFC Tag。 > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > 本模块首批接口从API version 8开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 @@ -9,30 +9,17 @@ ## **导入模块** ``` -import controller from '@ohos.nfc.controller'; +import tag from '@ohos.nfc.tag'; ``` -## controller.isNfcAvailable +## tag.getNfcATag -isNfcAvailable(): boolean +getNfcATag(tagInfo: TagInfo): NfcATag -查询是否有NFC功能 +获取NFC A类型Tag对象,通过该对象访问NfcA技术类型的Tag。 -**返回值:** - -| **类型** | **说明** | -| -------- | -------- | -| boolean | true:有NFC功能, false:无NFC功能。 | - - -## controller.openNfc - -openNfc(): boolean - -打开NFC开关。 - -**需要权限**:ohos.permission.MANAGE_SECURE_SETTINGS +**需要权限**:ohos.permission.NFC_TAG **系统能力**:SystemCapability.Communication.NFC @@ -40,108 +27,52 @@ openNfc(): boolean | **类型** | **说明** | | -------- | -------- | -| boolean | true:打开NFC成功, false:打开NFC失败。 | +| NfcATag | NFC A类型Tag对象 | -## controller.closeNfc +## tag.getNfcBTag -closeNfc(): boolean +getNfcBTag(tagInfo: TagInfo): NfcBTag -关闭NFC开关。 +获取NFC B类型Tag对象,通过该对象访问NfcB技术类型的Tag。 -**需要权限**:ohos.permission.MANAGE_SECURE_SETTINGS +**需要权限**:ohos.permission.NFC_TAG **系统能力**:SystemCapability.Communication.NFC **返回值:** -| **类型** | **说明** | -| -------- | ------------------------------------------- | -| boolean | true:关闭NFC成功, false:关闭NFC失败。 | - -## controller.isNfcOpen +| **类型** | **说明** | +| -------- | ---------------- | +| NfcBTag | NFC B类型Tag对象 | -isNfcOpen(): boolean +## tag.getNfcFTag -查询NFC是否打开。 +getNfcFTag(tagInfo: TagInfo): NfcFTag -**系统能力**:SystemCapability.Communication.NFC - -**返回值:** +获取NFC F类型Tag对象,通过该对象访问NfcF技术类型的Tag。 -| **类型** | **说明** | -| -------- | ----------------------------------- | -| boolean | true:NFC打开, false:NFC关闭。 | - -## controller.getNfcState - -isNfcOpen(): boolean - -查询NFC是否打开。 +**需要权限**:ohos.permission.NFC_TAG **系统能力**:SystemCapability.Communication.NFC **返回值:** -| **类型** | **说明** | -| -------- | ----------------------------------- | -| boolean | true:NFC打开, false:NFC关闭。 | - -## controller.on('nfcStateChange') - -on(type: "notify", callback: Callback<NfcState>): void - -注册NFC开关状态事件。 - -**系统能力**:SystemCapability.Communication.NFC - -- **参数** - - | **参数名** | **类型** | **必填** | **说明** | - | -------- | -------- | -------- | -------- | - | type | string | 是 | 固定填"nfcStateChange"字符串 | - | callback | Callback<NfcState> | 是 | 状态改变回调函数。 | +| **类型** | **说明** | +| -------- | ---------------- | +| NfcFTag | NFC F类型Tag对象 | +## tag.getNfcVTag +getNfcVTag(tagInfo: TagInfo): NfcVTag -## controller.off('nfcStateChange') +获取NFC V类型Tag对象,通过该对象访问NfcV技术类型的Tag。 -off(type: "nfcStateChange", callback?: Callback<NfcState>): void - -取消NFC开关状态事件的注册。 +**需要权限**:ohos.permission.NFC_TAG **系统能力**:SystemCapability.Communication.NFC -- **参数** - - | **参数名** | **类型** | **必填** | **说明** | - | -------- | -------- | -------- | -------- | - | type | string | 是 | 固定填"nfcStateChange"字符串 | -| callback | Callback<NfcState> | 否 | 状态改变回调函数。如果callback不填,将“去注册”该事件关联的所有回调函数。 | - -- 示例 - ``` - import nfcController from '@ohos.nfcController'; - - var NFC_STATE_NOTIFY = "nfcStateChange"; - - var recvNfcStateNotifyFunc = result => { - console.info("nfc state receive state: " + result); - } - - // 注册事件 - nfcController.on(NFC_STATE_NOTIFY, recvNfcStateNotifyFunc); - - // 解注册事件 - nfcController.off(NFC_STATE_NOTIFY, recvNfcStateNotifyFunc); - ``` - -## NfcState - -表示NFC状态的枚举。 - -| 名称 | 默认值 | 说明 | -| -------- | -------- | -------- | -| STATE_OFF | 1 | NFC关闭状态 | -| STATE_TURNING_ON | 2 | NFC正在打开状态 | -| STATE_ON | 3 | NFC打开状态 | -| STATE_TURNING_OFF | 4 | NFC正在关闭状态 | +**返回值:** + +| **类型** | **说明** | +| -------- | ---------------- | +| NfcVTag | NFC V类型Tag对象 | \ No newline at end of file