@ohos.nfc.cardEmulation (Standard NFC Card Emulation) (System API)

The cardEmulation module implements Near-Field Communication (NFC) card emulation. You can use the APIs provided by this module to determine the card emulation type supported and implement Host Card Emulation (HCE). HCE provides card emulation that does not depend on a secure element. It allows an application to emulate a card and communicate with an NFC card reader through the NFC service.

NOTE

  • The initial APIs of this module are supported since API version 6. Newly added APIs will be marked with a superscript to indicate their earliest API version.
  • This topic describes only the system APIs provided by the module. For details about its public APIs, see @ohos.nfc.cardEmulation (Standard NFC Card Emulation).

Modules to Import

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

getPaymentServices11+

getPaymentServices(): AbilityInfo[]

Obtains all payment services. If an application declares the support for the HCE feature and payment-aid, the application is contained in the payment service list. For details, see HCE and AID Declaration.

System API: This is a system API.

System capability: SystemCapability.Communication.NFC.CardEmulation

Required permissions: ohos.permission.NFC_CARD_EMULATION

Return value

Type Description
AbilityInfo[] List of payment services obtained.

Example

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

let paymentServices = cardEmulation.getPaymentServices();
if (paymentServices == undefined || paymentServices.length == 0) {
  console.log('paymentServices is null.');
}