Share via


CardEmulation Class

Definition

This class can be used to query the state of NFC card emulation services.

[Android.Runtime.Register("android/nfc/cardemulation/CardEmulation", DoNotGenerateAcw=true)]
public sealed class CardEmulation : Java.Lang.Object
[<Android.Runtime.Register("android/nfc/cardemulation/CardEmulation", DoNotGenerateAcw=true)>]
type CardEmulation = class
    inherit Object
Inheritance
CardEmulation
Attributes

Remarks

This class can be used to query the state of NFC card emulation services.

For a general introduction into NFC card emulation, please read the NFC card emulation developer guide.</p>

<p class="note">Use of this class requires the PackageManager#FEATURE_NFC_HOST_CARD_EMULATION to be present on the device.

Java documentation for android.nfc.cardemulation.CardEmulation.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Fields

ActionChangeDefault

Activity action: ask the user to change the default card emulation service for a certain category.

CategoryOther

Category that can be used for all other card emulation services.

CategoryPayment

Category used for NFC payment services.

ExtraCategory

The category extra for #ACTION_CHANGE_DEFAULT.

ExtraServiceComponent

The service ComponentName object passed in as an extra for #ACTION_CHANGE_DEFAULT.

SelectionModeAlwaysAsk
Obsolete.

Return value for #getSelectionModeForCategory(String).

SelectionModeAskIfConflict
Obsolete.

Return value for #getSelectionModeForCategory(String).

SelectionModePreferDefault
Obsolete.

Return value for #getSelectionModeForCategory(String).

Properties

AidsForPreferredPaymentService

Retrieves the registered AIDs for the preferred payment service.

Class

Returns the runtime class of this Object.

(Inherited from Object)
DescriptionForPreferredPaymentService
DescriptionForPreferredPaymentServiceFormatted

Returns a user-visible description of the preferred payment service.

Handle

The handle to the underlying Android instance.

(Inherited from Object)
JniIdentityHashCode (Inherited from Object)
JniPeerMembers
PeerReference (Inherited from Object)
RouteDestinationForPreferredPaymentService

Retrieves the route destination for the preferred payment service.

ThresholdClass

This API supports the Mono for Android infrastructure and is not intended to be used directly from your code.

(Inherited from Object)
ThresholdType

This API supports the Mono for Android infrastructure and is not intended to be used directly from your code.

(Inherited from Object)

Methods

CategoryAllowsForegroundPreference(String)

Returns whether the user has allowed AIDs registered in the specified category to be handled by a service that is preferred by the foreground application, instead of by a pre-configured default.

Clone()

Creates and returns a copy of this object.

(Inherited from Object)
Dispose() (Inherited from Object)
Dispose(Boolean) (Inherited from Object)
Equals(Object)

Indicates whether some other object is "equal to" this one.

(Inherited from Object)
GetAidsForService(ComponentName, String)

Retrieves the currently registered AIDs for the specified category for a service.

GetHashCode()

Returns a hash code value for the object.

(Inherited from Object)
GetInstance(NfcAdapter)

Helper to get an instance of this class.

GetSelectionModeForCategory(String)

Returns the service selection mode for the passed in category.

IsDefaultServiceForAid(ComponentName, String)

Allows an application to query whether a service is currently the default handler for a specified ISO7816-4 Application ID.

IsDefaultServiceForCategory(ComponentName, String)

Allows an application to query whether a service is currently the default service to handle a card emulation category.

JavaFinalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

(Inherited from Object)
Notify()

Wakes up a single thread that is waiting on this object's monitor.

(Inherited from Object)
NotifyAll()

Wakes up all threads that are waiting on this object's monitor.

(Inherited from Object)
RegisterAidsForService(ComponentName, String, IList<String>)

Registers a list of AIDs for a specific category for the specified service.

RemoveAidsForService(ComponentName, String)

Removes a previously registered list of AIDs for the specified category for the service provided.

SetHandle(IntPtr, JniHandleOwnership)

Sets the Handle property.

(Inherited from Object)
SetOffHostForService(ComponentName, String)

Sets the off-host Secure Element for the given service.

SetPreferredService(Activity, ComponentName)

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

SupportsAidPrefixRegistration()

Some devices may allow an application to register all AIDs that starts with a certain prefix, e.

ToArray<T>() (Inherited from Object)
ToString()

Returns a string representation of the object.

(Inherited from Object)
UnregisterFromRuntime() (Inherited from Object)
UnsetOffHostForService(ComponentName)

Unsets the off-host Secure Element for the given service.

UnsetPreferredService(Activity)

Unsets the preferred service for the specified Activity.

Wait()

Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>.

(Inherited from Object)
Wait(Int64, Int32)

Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed.

(Inherited from Object)
Wait(Int64)

Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed.

(Inherited from Object)

Explicit Interface Implementations

IJavaPeerable.Disposed() (Inherited from Object)
IJavaPeerable.DisposeUnlessReferenced() (Inherited from Object)
IJavaPeerable.Finalized() (Inherited from Object)
IJavaPeerable.JniManagedPeerState (Inherited from Object)
IJavaPeerable.SetJniIdentityHashCode(Int32) (Inherited from Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) (Inherited from Object)
IJavaPeerable.SetPeerReference(JniObjectReference) (Inherited from Object)

Extension Methods

JavaCast<TResult>(IJavaObject)

Performs an Android runtime-checked type conversion.

JavaCast<TResult>(IJavaObject)
GetJniTypeName(IJavaPeerable)

Applies to