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.