Package com.gemalto.mfs.mwsdk.dcm.cdcvm

Enum DeviceCVMManager

java.lang.Object

java.lang.Enum<DeviceCVMManager>

com.gemalto.mfs.mwsdk.dcm.cdcvm.DeviceCVMManager

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<DeviceCVMManager>

public enum DeviceCVMManager
extends java.lang.Enum<DeviceCVMManager>

This class is used in line with the support of Biometric Fingerprint and Device keyguard as CHVerificationMethod.
NOTE:This can only be used if the card profile supports Flexible CD_CVM.

Enum Constant Summary

Enum Constants

Enum Constant	Description
INSTANCE

Method Summary

Modifier and Type	Method	Description
int	getExistingKeyValidityPeriod(android.content.Context context)	An API to get the existing stored key validity period; this API does not depend on SDKInitializer.initialize(Context, Notification, CustomConfiguration) or SDKInitializer.configure(Context, Notification, CustomConfiguration) If the key validity period is not stored, then API will return -1.
void	initialize(CHVerificationMethod chVerificationMethod)	An API to initialize the biometric fingerprint or device keyguard.
void	setPreEntryActivation(byte[] param)	Set the activation for the pre-entry behavior.
static DeviceCVMManager	valueOf(java.lang.String name)	Returns the enum constant of this type with the specified name.
static DeviceCVMManager[]	values()	Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

INSTANCE

public static final DeviceCVMManager INSTANCE

Method Detail

values

public static DeviceCVMManager[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (DeviceCVMManager c : DeviceCVMManager.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static DeviceCVMManager valueOf(java.lang.String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

java.lang.IllegalArgumentException - if this enum type has no constant with the specified name

java.lang.NullPointerException - if the argument is null

initialize

public void initialize(CHVerificationMethod chVerificationMethod)
                throws DeviceCVMException

An API to initialize the biometric fingerprint or device keyguard. This method is called when the MPA would like to support either the biometric fingerprint or device keyguard as the default Card Holder Verification Method during payment transactions. This API should only be call once.

Parameters:

chVerificationMethod - Enumeration of possible cardholder verification method that may be required when activating a digitized card for transaction

Throws:

DeviceCVMException - An exception thrown if there are error encountered while performing biometric fingerprint operation

setPreEntryActivation

public void setPreEntryActivation(byte[] param)

Set the activation for the pre-entry behavior. Must be called by the BroadcastReceiver when it is initialized.

Parameters:

param - the activation value. 0x00 for no activation, 0x01 for activation.

getExistingKeyValidityPeriod

public int getExistingKeyValidityPeriod(@NonNull
                                        android.content.Context context)

An API to get the existing stored key validity period; this API does not depend on SDKInitializer.initialize(Context, Notification, CustomConfiguration) or SDKInitializer.configure(Context, Notification, CustomConfiguration)

If the key validity period is not stored, then API will return -1. If API returns a key validity period, then use the same value for SDK initialization or can use a new key validity period or default value.

For example

     int existingKeyValidityPeriod = DeviceCVMManager.INSTANCE.getExistingKeyValidityPeriod();
     if (existingKeyValidityPeriod != -1) {
            CustomConfiguration newCustomConfig = new CustomConfiguration.Builder()
                    .domesticCurrencyCode(250)
                    .keyValidityPeriod(existingKeyValidityPeriod)
                    .build();
            SDKInitializer.INSTANCE.initialize(context, notification, newCustomConfig);
      } else {
              SDKInitializer.INSTANCE.initialize(context, notification, customConfig);
      }
       

Also, please refer to SDKInitializer.configure(Context, Notification, CustomConfiguration) and SDKInitializer.initialize(Context, Notification, CustomConfiguration).

Parameters:

context - Context used for obtaining device resources.

Returns:

existing key validity period or else -1 (-1 indicates no existing value)

Since:

6.7.0