Added in API level 24

NfcFCardEmulation


class NfcFCardEmulation
kotlin.Any
   ↳ android.nfc.cardemulation.NfcFCardEmulation

This class can be used to query the state of NFC-F card emulation services. For a general introduction into NFC card emulation, please read the NFC card emulation developer guide.

Use of this class requires the PackageManager#FEATURE_NFC_HOST_CARD_EMULATION_NFCF to be present on the device.

Summary

Public methods
Boolean

Disables the service for the specified Activity.

Boolean
enableService(activity: Activity!, service: ComponentName!)

Allows a foreground application to specify which card emulation service should be enabled while a specific Activity is in the foreground.

static NfcFCardEmulation!

Helper to get an instance of this class.

String!

Retrieves the current NFCID2 for the specified service.

String!

Retrieves the current System Code for the specified service.

Boolean

Registers a System Code for the specified service.

Boolean

Set a NFCID2 for the specified service.

Boolean

Removes a registered System Code for the specified service.

Public methods

disableService

Added in API level 24
fun disableService(activity: Activity!): Boolean

Disables the service for the specified Activity.

Note that the specified Activity must still be in resumed state at the time of this call. A good place to call this method is in your Activity#onPause implementation.

Parameters
activity Activity!: The activity which the service was registered for
Return
Boolean true when successful

enableService

Added in API level 24
fun enableService(
    activity: Activity!,
    service: ComponentName!
): Boolean

Allows a foreground application to specify which card emulation service should be enabled while a specific Activity is in the foreground.

The specified HCE-F service is only enabled when the corresponding application is in the foreground and this method has been called. When the application is moved to the background, disableService(android.app.Activity) is called, or NFCID2 or System Code is replaced, the HCE-F service is disabled.

The specified Activity must currently be in resumed state. A good paradigm is to call this method in your Activity#onResume, and to call disableService(android.app.Activity) in your Activity#onPause.

Note that this preference is not persisted by the OS, and hence must be called every time the Activity is resumed.

Parameters
activity Activity!: The activity which prefers this service to be invoked
service ComponentName!: The service to be preferred while this activity is in the foreground
Return
Boolean whether the registration was successful

getInstance

Added in API level 24
static fun getInstance(adapter: NfcAdapter!): NfcFCardEmulation!

Helper to get an instance of this class.

Parameters
adapter NfcAdapter!: A reference to an NfcAdapter object.
Return
NfcFCardEmulation!

getNfcid2ForService

Added in API level 24
fun getNfcid2ForService(service: ComponentName!): String!

Retrieves the current NFCID2 for the specified service.

Before calling setNfcid2ForService(android.content.ComponentName,java.lang.String), the NFCID2 contained in the Manifest file is returned. If "random" is specified in the Manifest file, a random number assigned by the system at installation time is returned. After setting an NFCID2 with setNfcid2ForService(android.content.ComponentName,java.lang.String), this NFCID2 is returned.

Parameters
service ComponentName!: The component name of the service
Return
String! the current NFCID2

getSystemCodeForService

Added in API level 24
fun getSystemCodeForService(service: ComponentName!): String!

Retrieves the current System Code for the specified service.

Before calling registerSystemCodeForService(android.content.ComponentName,java.lang.String), the System Code contained in the Manifest file is returned. After calling registerSystemCodeForService(android.content.ComponentName,java.lang.String), the System Code registered there is returned. After calling unregisterSystemCodeForService(android.content.ComponentName), "null" is returned.

Parameters
service ComponentName!: The component name of the service
Return
String! the current System Code

registerSystemCodeForService

Added in API level 24
fun registerSystemCodeForService(
    service: ComponentName!,
    systemCode: String!
): Boolean

Registers a System Code for the specified service.

The System Code must be in range from "4000" to "4FFF" (excluding "4*FF").

If a System Code was previously registered for this service (either statically through the manifest, or dynamically by using this API), it will be replaced with this one.

Even if the same System Code is already registered for another service, this method succeeds in registering the System Code.

Note that you can only register a System Code for a service that is running under the same UID as the caller of this API. Typically this means you need to call this from the same package as the service itself, though UIDs can also be shared between packages using shared UIDs.

Parameters
service ComponentName!: The component name of the service
systemCode String!: The System Code to be registered
Return
Boolean whether the registration was successful.

setNfcid2ForService

Added in API level 24
fun setNfcid2ForService(
    service: ComponentName!,
    nfcid2: String!
): Boolean

Set a NFCID2 for the specified service.

The NFCID2 must be in range from "02FE000000000000" to "02FEFFFFFFFFFFFF".

If a NFCID2 was previously set for this service (either statically through the manifest, or dynamically by using this API), it will be replaced.

Note that you can only set the NFCID2 for a service that is running under the same UID as the caller of this API. Typically this means you need to call this from the same package as the service itself, though UIDs can also be shared between packages using shared UIDs.

Parameters
service ComponentName!: The component name of the service
nfcid2 String!: The NFCID2 to be registered
Return
Boolean whether the setting was successful.

unregisterSystemCodeForService

Added in API level 24
fun unregisterSystemCodeForService(service: ComponentName!): Boolean

Removes a registered System Code for the specified service.

Parameters
service ComponentName!: The component name of the service
Return
Boolean whether the System Code was successfully removed.