com.gemalto.idp.mobile.ui.secureinput

Interface SecurePinpadListenerV2

public interface SecurePinpadListenerV2

An interface that will get callbacks from the secure keypad when keypad buttons are pressed.

Method Summary

Modifier and Type	Method and Description
void	onDeleteButtonPressed() Called when the user interacts with the secure keypad by pressing the "Delete" button.
void	onError(String errorMessage) Called when errors happened inside secure input.
void	onFinish(PinAuthInput firstPin, PinAuthInput secondPin) This method is used to get the callback from keypad when user finished entering the pin(s) and pressing the OK button in the end.
void	onInputFieldSelected(int inputField) Called when the user interacts with the secure keypad and causes a focus change of the input field
void	onKeyPressedCountChanged(int newCount, int inputField) Called when user presses the keypad button and changes the number of PIN digits in the selected input field.
void	onOkButtonPressed() Called when the user interacts with the secure keypad by pressing the "OK" button.

Method Detail

onKeyPressedCountChanged

void onKeyPressedCountChanged(int newCount,
                              int inputField)

Called when user presses the keypad button and changes the number of PIN digits in the selected input field. Application could update custom UI accordingly to display how many digits has been entered for each input field.

Parameters:

newCount - PIN digits count for the selected input field.

inputField - The current selected input field. 0 for the first input field, and 1 for the second input field.

onInputFieldSelected

void onInputFieldSelected(int inputField)

Called when the user interacts with the secure keypad and causes a focus change of the input field

Note:

This method is NOT triggered when input field is changed using the SecureInputUi.selectInputField(int) method.

Parameters:

inputField - The current selected input field. 0 for the first input field, and 1 for the second input field.

onOkButtonPressed

void onOkButtonPressed()

Called when the user interacts with the secure keypad by pressing the "OK" button.

onDeleteButtonPressed

void onDeleteButtonPressed()

Called when the user interacts with the secure keypad by pressing the "Delete" button.

onFinish

void onFinish(PinAuthInput firstPin,
              PinAuthInput secondPin)

This method is used to get the callback from keypad when user finished entering the pin(s) and pressing the OK button in the end. Please be noted that pin is presented as a secure data object, and the clear text password is not able to be extracted from this secure data object. It's important to be aware that the keypad itself will NOT perform any comparison of the two pin objects.

Parameters:

firstPin - PinAuthInput object that created from the first input field data

secondPin - PinAuthInput object that created from the second input field data. The secondPin will be null if isDoubleInputField (as one of the parameters of the method buildPinpad) is set as false.

onError

void onError(String errorMessage)

Called when errors happened inside secure input.

Parameters:

errorMessage - is the message that describes the error.