输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心
全部文档版本说明工具设计指南与API参考开发与测试上架分发与运营问题处理与运维最佳实践行业解决方案
指南与API参考
指南
API
高级筛选
API version全部版本
设备全部
元服务API集不筛选
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
指南与API参考API参考系统网络Connectivity Kit（短距通信服务）ArkTS API@ohos.nfc.controller (标准NFC)

@ohos.nfc.controller (标准NFC)

Phone12+PC/2in113+Tablet12+Wearable18+
更新时间: 2026-08-29 09:41
复制页面
本文导读
展开章节

本模块主要用于管理NFC状态，包括打开和关闭NFC，读取NFC的状态等。

说明

本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

收起
自动换行
深色代码主题
复制
  1. import { nfcController } from '@kit.ConnectivityKit';

NfcState

Phone12+PC/2in113+Tablet12+Wearable18+

定义不同的NFC状态值。

系统能力： SystemCapability.Communication.NFC.Core

元服务API： 从API version 12开始，该接口支持在元服务中使用。

展开
名称 值 说明
STATE_OFF 1 NFC已关闭状态。
STATE_TURNING_ON 2 NFC正在打开状态。
STATE_ON 3 NFC已打开状态。
STATE_TURNING_OFF 4 NFC正在关闭状态。

nfcController.isNfcAvailable(deprecated)

Phone12+PC/2in113+Tablet12+Wearable18+

isNfcAvailable(): boolean

查询设备是否有NFC能力。

说明

从API version 7开始支持，从API version 9开始废弃，API version 26前建议使用canIUse("SystemCapability.Communication.NFC.Core") && nfcController.isNfcAvailable共同判断设备是否支持NFC，从API version 26开始，建议使用canIUse("SystemCapability.Communication.NFC.Core") && nfcController.isNfcSupported 替代。

系统能力： SystemCapability.Communication.NFC.Core

返回值：

展开
类型 说明
boolean true: 设备具备NFC能力， false: 设备不具备NFC能力。

nfcController.isNfcSupported

Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+Wearable26.0.0+

isNfcSupported(): boolean

查询设备是否有NFC能力。

起始版本： 26.0.0

系统能力： SystemCapability.Communication.NFC.Core

模型约束： 此接口仅可在Stage模型下使用。

返回值：

展开
类型 说明
boolean true: 设备具备NFC能力， false: 设备不具备NFC能力。

nfcController.openNfc(deprecated)

Phone12+PC/2in113+Tablet12+Wearable18+

openNfc(): boolean

打开NFC开关。

说明

从 API version 7 开始支持，从 API version 9 开始废弃，建议使用enableNfc替代。

需要权限： ohos.permission.MANAGE_SECURE_SETTINGS（该权限仅系统应用可申请）

系统能力： SystemCapability.Communication.NFC.Core

返回值：

展开
类型 说明
boolean true: 打开NFC成功， false: 打开NFC失败。

nfcController.enableNfc9+

Phone12+PC/2in113+Tablet12+Wearable18+

enableNfc(): void

打开NFC开关，该接口只能被系统应用调用。

需要权限： ohos.permission.MANAGE_SECURE_SETTINGS（该权限仅系统应用可申请）

系统能力： SystemCapability.Communication.NFC.Core

错误码：

以下错误码的详细介绍请参见NFC错误码。

展开
错误码ID 错误信息
201 Permission denied.
801 Capability not supported.
3100101 The NFC state is abnormal in the service.

示例：

示例参见off接口。

nfcController.closeNfc(deprecated)

Phone12+PC/2in113+Tablet12+Wearable18+

closeNfc(): boolean

关闭NFC开关。

说明

从 API version 7 开始支持，从 API version 9 开始废弃，建议使用disableNfc替代。

需要权限： ohos.permission.MANAGE_SECURE_SETTINGS（该权限仅系统应用可申请）

系统能力： SystemCapability.Communication.NFC.Core

返回值：

展开
类型 说明
boolean true: 关闭NFC成功， false: 关闭NFC失败。

nfcController.disableNfc9+

Phone12+PC/2in113+Tablet12+Wearable18+

disableNfc(): void

关闭NFC开关，该接口只能被系统应用调用。

需要权限： ohos.permission.MANAGE_SECURE_SETTINGS（该权限仅系统应用可申请）

系统能力： SystemCapability.Communication.NFC.Core

错误码：

以下错误码的详细介绍请参见NFC错误码。

展开
错误码ID 错误信息
201 Permission denied.
801 Capability not supported.
3100101 The NFC state is abnormal in the service.

示例：

示例参见off接口。

nfcController.isNfcOpen

Phone12+PC/2in113+Tablet12+Wearable18+

isNfcOpen(): boolean

查询NFC是否打开。

系统能力： SystemCapability.Communication.NFC.Core

元服务API： 从API version 12开始，该接口支持在元服务中使用。

返回值：

展开
类型 说明
boolean true: NFC是打开的， false: NFC是关闭的。

示例：

示例参见off接口。

nfcController.getNfcState

Phone12+PC/2in113+Tablet12+Wearable18+

getNfcState(): NfcState

查询NFC状态。

系统能力： SystemCapability.Communication.NFC.Core

元服务API： 从API version 12开始，该接口支持在元服务中使用。

返回值：

展开
类型 说明
NfcState NFC状态值，详细请见NfcState枚举值。

示例：

收起
自动换行
深色代码主题
复制
  1. import { nfcController } from '@kit.ConnectivityKit';
  2. 

  3. // 查询nfc状态
  4. let nfcState: nfcController.NfcState = nfcController.getNfcState();
  5. console.info("nfcController on callback nfcstate: " + nfcState);

nfcController.on('nfcStateChange')

Phone12+PC/2in113+Tablet12+Wearable18+

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

注册NFC开关状态事件，获取NFC状态的变化通知。使用callback异步回调。

系统能力： SystemCapability.Communication.NFC.Core

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

展开
参数名 类型 必填 说明
type string 是 固定填"nfcStateChange"字符串。
callback Callback<NfcState> 是 回调函数，返回NFC状态的枚举值。

示例：

示例参见off接口。

nfcController.off('nfcStateChange')

Phone12+PC/2in113+Tablet12+Wearable18+

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

取消NFC开关状态事件的注册，取消后NFC状态变化时，就不会再收到Callback的通知。使用callback异步回调。

系统能力： SystemCapability.Communication.NFC.Core

元服务API： 从API version 12开始，该接口支持在元服务中使用。

参数：

展开
参数名 类型 必填 说明
type string 是 固定填"nfcStateChange"字符串。
callback Callback<NfcState> 否 NFC状态改变回调函数，可以空缺不填。如果callback不填，将取消注册该事件关联的所有回调函数。

示例：

收起
自动换行
深色代码主题
复制
  1. import { nfcController } from '@kit.ConnectivityKit';
  2. 

  3. // 注册回调以接收nfc状态更改通知
  4. nfcController.on("nfcStateChange", (nfcState : number) => {
  5.   console.info("nfcController on callback nfcState: " + nfcState);
  6. });
  7. 

  8. // 打开nfc需要权限：ohos.permission.MANAGE_SECURE_SETTINGS（此权限仅系统应用可申请）
  9. if (!nfcController.isNfcOpen()) {
  10.   // 从api9开始，使用'enableNfc'打开nfc
  11.   try {
  12.     nfcController.enableNfc();
  13.     console.info("nfcController enableNfc success");
  14.   } catch (businessError) {
  15.     console.error("nfcController enableNfc businessError: " + businessError);
  16.   }
  17. } else {
  18.   console.info("nfcController NFC has been opened");
  19. }
  20. 

  21. // 关闭nfc需要权限：ohos.permission.MANAGE_SECURE_SETTINGS（此权限仅系统应用可申请）
  22. if (nfcController.isNfcOpen()) {
  23.   // 从api9开始，使用'disableNfc'关闭nfc
  24.   try {
  25.     nfcController.disableNfc();
  26.     console.info("nfcController disableNfc success");
  27.   } catch (businessError) {
  28.     console.error("nfcController disableNfc businessError: " + businessError);
  29.   }
  30. } else {
  31.   console.info("nfcController NFC has been closed");
  32. }
  33. 

  34. // 取消注册回调
  35. nfcController.off("nfcStateChange");
@ohos.nfc.cardEmulation (标准NFC-cardEmulation)
@ohos.nfc.tag (标准NFC-Tag)
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明