Cómo utilizar XpressPlug en aplicaciones nativas de Android
Después de configurar los parámetros correctos e inicializar XpressPlug, todas las funciones disponibles están listas para usarse e interactuar con el SDK.
Aviso
Solo inicializa XpressPlug una vez por sesión, preferentemente durante el inicio de la aplicación o en la etapa más temprana posible. No podrás ejecutar ningún punto de entrada hasta que se inicialice XpressPlug.
Puedes interactuar con XpressPlug y llamar a los puntos de entrada. Estos puntos de entrada se utilizan para conectarse con las funcionalidades de Veritran, como procesos o 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:
En el siguiente ejemplo, el punto de entrada se llama I_DOCU_SDK y sus parámetros de entrada incluyen un mapa con un nombre de usuario de tipo string. Las claves definidas como claves de salida son "errorCode" y "age". Como resultado, la función devuelve un mapa con el formato <llave, Valor> que contiene valores previamente establecidos en el array outputKeys. Ve el ejemplo a continuación para aprender cómo llamar a un punto de entrada:
class EntryPointCallerExample: EntryPoint.Callback { fun testEntryPointCall() { val entryPointName = "I_DOCU_SDK" val parameters = hashMapOf("userName" to "Veritran") val action = XpressPlug.buildEntryPoint( entryPointName, MainApplication.mainActivity ) parameters.forEach { action.addInput(it.key, it.value) } action.setCallback(this) action.execute() } }
Nota
El equipo de Veritran proporcionará los nombres de los puntos de entrada y sus parámetros.
Para ver los resultados de la ejecución de los puntos de entrada, debes implementar la interfaz EntryPoint.Callback. Ve el código y la tabla a continuación para ver un ejemplo de cómo se implementa la interfaz después de invocar la clase anterior.
override fun onCompleted(results: Response?) { val outputKeys = listOf("errorCode", "age") var params = hashMapOf<String, String>() outputKeys.forEach { param -> params[param.name] = results?.getOutputValue(param.name) ?: "" } } override fun onException(code: String?, message: Exception?) { } override fun onUpdateRequired(message: String?) { } override fun onClose(message: String?, context: 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. |
Se puede acceder a los resultados a través del objeto Response, en el método onCompleted.