Interacción
Después de configurar los parámetros correctos e inicializar XpressPlug, puedes ejecutarlo. Para ello, invoca el método Sdk.start().
Inserta el bloque del código a continuación en la pestaña Activity desde donde deseas que se ejecute XpressPlug.
XpressPlug.start(this, new StartAction.Callback() {
En el ejemplo anterior, el método start() necesita dos parámetros: el parámetro Activity, que indica desde dónde se está ejecutando XpressPlug y la interfaz StartAction.Callback(). Esta interfaz se encarga de devolver el estado del proceso. Cuando se implementa, el proyecto te solicita que completes una serie de métodos de callbacks.
@Override
public void onProgressMessageUpdate(String status) {
}
@Override
public void onProgressPercentageUpdate(int percentage) {
}
@Override
public void onFinish() {
}
@Override
public void onXpressPlugNeedsUpdate() {
}
@Override
public void onError(int errorCode, String description) {
}
});Métodos de callback
Los métodos de callback devuelven información diferente sobre XpressPlug y su estado del proceso. Consulta la tabla a continuación para obtener más información:
onProgressMessageUpdate | Se encarga de devolver el estado de XpressPlug a la app principal. |
onProgressPercentageUpdate | XpressPlug necesita conexión de datos para actualizar ciertas funcionalidades. Esta función se encarga de mostrar el progreso de descarga de estas actualizaciones. |
XpressPlugNeedsUpdate | Se encarga de mostrar si la app necesita una versión más reciente de XpressPlug. |
onFinish | Notifica que el método start () se ejecutó correctamente. |
onError | Notifica que se produjo un error al ejecutar XpressPlug. Muestra los códigos de error de UA y, en algunos casos, la descripción del error. Para obtener más información sobre estos errores, dirígete a Códigos de error en dispositivos móviles. |
Interactuar con XpressPlug
Puedes interactuar con XpressPlug y llamar a los puntos de entrada. Estos se usan para conectarse con las funcionalidades de Veritran, como los procesos o las transacciones.
Los puntos de entrada pueden ser visuales, como invocar una pantalla que abre la cámara del dispositivo para tomar una fotografía, o no visuales, como la validación de un inicio de sesión. Para interactuar con estos puntos de entrada, ingresa la siguiente sintaxis:
com.veritran.xpressplug.EntryPoint action = XpressPlug.buildEntryPoint(“NAME_EP”,activity);
action.setCallback(new com.veritran.xpressplug.EntryPoint.Callback() {En el campo de nombre situado junto al método buildEntryPoint, ingresa el nombre de la funcionalidad configurado en Studio. Ambos campos deben coincidir para que funcionen correctamente.
La interacción con el punto de entrada devuelve una serie de métodos de callback que debes completar. Consulta el código y la tabla a continuación para obtener más información sobre cómo completarlos.
@Override
public void onCompleted(Response response) {
}
@Override
public void onException(String action, Exception e) {
}
@Override
public void onUpdateRequired(String s) {
}
@Override
public void onClose(String s, Activity activity) {
}
});onCompleted | Aquí es donde aparecen los parámetros de salida. |
onException | Se ejecuta cuando se produce una excepción. |
onUpdateRequired | Aparece cuando el SDK o la configuración deben actualizarse. |
onClose | Aparece cuando la funcionalidad está cerrada. |
Por último, ejecuta la llamada enviando los parámetros de entrada con la siguiente sintaxis:
action.addInput("PARAMETER_NAME_1","VALUE_1");
action.addInput("PARAMETER_NAME_2","VALUE_2");
action.execute();Importante
Tanto el nombre del punto de entrada como el nombre del parámetro deben coincidir con lo que se ha configurado en Studio en la página SDK Configuration de la app.