Class NfcCardEmulationAdapter
Definition
- Namespace:
- Tizen.Network.Nfc
- Assembly:
- Tizen.Network.Nfc.dll
- API Level:
- 3
- Privilege Level:
- public
- Privilege:
- http://tizen.org/privilege/nfc.cardemulation
A class for the NFC CardEmulation mode. It allows applications to handle Card Emulation informations.
public class NfcCardEmulationAdapter : IDisposable
- Inheritance
-
NfcCardEmulationAdapter
- Implements
Methods
View SourceDisableCardEmulation()
Disables the card emulation mode.
Declaration
public void DisableCardEmulation()
Exceptions
Type | Condition |
---|---|
NotSupportedException | Thrown when the NFC is not supported. |
InvalidOperationException | Thrown when the method fails due to an invalid operation. |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/nfc.cardemulation
View SourceDisableTransactionForegroundDispatch()
Disables the foreground dispatch for the "EVT_TRANSACTION" to the given application.
Declaration
public void DisableTransactionForegroundDispatch()
Exceptions
Type | Condition |
---|---|
NotSupportedException | Thrown when the NFC is not supported. |
InvalidOperationException | Thrown when the method fails due to an invalid operation. |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/nfc.cardemulation
View SourceDispose()
Dispose
Declaration
public void Dispose()
API Level: 3
View SourceEnableCardEmulation()
Enables the card emulation mode.
Declaration
public void EnableCardEmulation()
Exceptions
Type | Condition |
---|---|
NotSupportedException | Thrown when the NFC is not supported. |
InvalidOperationException | Thrown when the method fails due to an invalid operation. |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/nfc.cardemulation
View SourceEnableTransactionForegroundDispatch()
Gives the priority to the foreground application when dispatching the transaction event.
Declaration
public void EnableTransactionForegroundDispatch()
Exceptions
Type | Condition |
---|---|
NotSupportedException | Thrown when the NFC is not supported. |
InvalidOperationException | Thrown when the method fails due to an invalid operation. |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/nfc.cardemulation
View SourceFinalize()
NfcCardEmulationAdpater destructor.
Declaration
protected void Finalize()
GetCardEmulationMode()
Gets the current card emulation mode.
Declaration
public NfcSecureElementCardEmulationMode GetCardEmulationMode()
Returns
Type | Description |
---|---|
NfcSecureElementCardEmulationMode | Enumeration value for the NfcSecureElementCardEmulationMode. |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/nfc.cardemulation
View SourceGetRegisteredAidInformation(NfcSecureElementType, NfcCardEmulationCategoryType)
Retrieves all registered AIDs.
Declaration
public IEnumerable<NfcRegisteredAidInformation> GetRegisteredAidInformation(NfcSecureElementType seType, NfcCardEmulationCategoryType category)
Parameters
Type | Name | Description |
---|---|---|
NfcSecureElementType | seType | The type of the secure element. |
NfcCardEmulationCategoryType | category | Enumeration value of the category. |
Returns
Type | Description |
---|---|
IEnumerable<NfcRegisteredAidInformation> | The list of NfcRegisteredAidInformation objects. |
Exceptions
Type | Condition |
---|---|
NotSupportedException | Thrown when the NFC is not supported. |
ArgumentException | Thrown when the method fails due to an invalid parameter. |
InvalidOperationException | Thrown when the method fails due to an invalid operation. |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/nfc.cardemulation
View SourceIsActivatedHandlerForAid(NfcSecureElementType, String)
Gets the state, whether an application to call this API is currently the activated handler for the specific AID.
Declaration
public bool IsActivatedHandlerForAid(NfcSecureElementType seType, string aid)
Parameters
Type | Name | Description |
---|---|---|
NfcSecureElementType | seType | The type of the Secure Element. |
String | aid | The application ID specified in the ISO/IEC 7816-4. |
Returns
Type | Description |
---|---|
Boolean | 'True' when application is currently the activated handler, otherwise 'False'. |
Exceptions
Type | Condition |
---|---|
NotSupportedException | Thrown when the NFC is not supported. |
ArgumentException | Thrown when the method fails due to an invalid parameter. |
InvalidOperationException | Thrown when the method fails due to an invalid operation. |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/nfc.cardemulation
View SourceIsActivatedHandlerForCategory(NfcSecureElementType, NfcCardEmulationCategoryType)
Gets the state, whether an application to call this API is currently the activated handler for the category.
Declaration
public bool IsActivatedHandlerForCategory(NfcSecureElementType seType, NfcCardEmulationCategoryType category)
Parameters
Type | Name | Description |
---|---|---|
NfcSecureElementType | seType | The type of the secure element. |
NfcCardEmulationCategoryType | category | Enumeration value of the category. |
Returns
Type | Description |
---|---|
Boolean | 'True' when application is currently the activated handler, otherwise 'False'. |
Exceptions
Type | Condition |
---|---|
NotSupportedException | Thrown when the NFC is not supported. |
ArgumentException | Thrown when the method fails due to an invalid parameter. |
InvalidOperationException | Thrown when the method fails due to an invalid operation. |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/nfc.cardemulation
View SourceRegisterAid(NfcSecureElementType, NfcCardEmulationCategoryType, String)
Registers the AID for a specific category.
Declaration
public void RegisterAid(NfcSecureElementType seType, NfcCardEmulationCategoryType category, string aid)
Parameters
Type | Name | Description |
---|---|---|
NfcSecureElementType | seType | The type of the secure element. |
NfcCardEmulationCategoryType | category | Enumeration value of the category. |
String | aid | The application ID specified in the ISO/IEC 7816-4. |
Exceptions
Type | Condition |
---|---|
NotSupportedException | Thrown when the NFC is not supported. |
ArgumentException | Thrown when the method fails due to an invalid parameter. |
InvalidOperationException | Thrown when the method fails due to an invalid operation. |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/nfc.cardemulation
View SourceSetPreferredApplication()
Sets the application as a preferred handler.
Declaration
public void SetPreferredApplication()
Exceptions
Type | Condition |
---|---|
NotSupportedException | Thrown when the NFC is not supported. |
InvalidOperationException | Thrown when the method fails due to an invalid operation. |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/nfc.cardemulation
View SourceUnregisterAid(NfcSecureElementType, NfcCardEmulationCategoryType, String)
Unregisters a previously registered AID for the specified category.
Declaration
public void UnregisterAid(NfcSecureElementType seType, NfcCardEmulationCategoryType category, string aid)
Parameters
Type | Name | Description |
---|---|---|
NfcSecureElementType | seType | The type of the secure element. |
NfcCardEmulationCategoryType | category | Enumeration value of the category. |
String | aid | The application ID specified in the ISO/IEC 7816-4. |
Exceptions
Type | Condition |
---|---|
NotSupportedException | Thrown when the NFC is not supported. |
ArgumentException | Thrown when the method fails due to an invalid parameter. |
InvalidOperationException | Thrown when the method fails due to an invalid operation. |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/nfc.cardemulation
View SourceUnsetPreferredApplication()
Unsets the application as a preferred handler.
Declaration
public void UnsetPreferredApplication()
Exceptions
Type | Condition |
---|---|
NotSupportedException | Thrown when the NFC is not supported. |
InvalidOperationException | Thrown when the method fails due to an invalid operation. |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/nfc.cardemulation
Events
View SourceEseSecureElementTransactionEvent
An event that is called when receiving the Secure Element (SIM/UICC (Universal Integrated Circuit Card)) transaction event for the 'ESE(SmartMX)' type.
Declaration
public event EventHandler<SecureElementTranscationEventArgs> EseSecureElementTransactionEvent
Event Type
Type | Description |
---|---|
EventHandler<SecureElementTranscationEventArgs> |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/nfc.cardemulation
View SourceHostCardEmulationEvent
An event that is called when receiving the HCE (Host Card Emulation) event.
Declaration
public event EventHandler<HostCardEmulationEventArgs> HostCardEmulationEvent
Event Type
Type | Description |
---|---|
EventHandler<HostCardEmulationEventArgs> |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/nfc.cardemulation
View SourceSecureElementEvent
An event that is called when receiving the Secure Element (SIM/UICC(Universal Integrated Circuit Card)) event.
Declaration
public event EventHandler<SecureElementEventArgs> SecureElementEvent
Event Type
Type | Description |
---|---|
EventHandler<SecureElementEventArgs> |
API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/nfc.cardemulation
View SourceUiccSecureElementTransactionEvent
An event that is called when receiving the Secure Element (SIM/UICC (Universal Integrated Circuit Card)) transaction event for the 'UICC' type.
Declaration
public event EventHandler<SecureElementTranscationEventArgs> UiccSecureElementTransactionEvent
Event Type
Type | Description |
---|---|
EventHandler<SecureElementTranscationEventArgs> |