Inicio rápido
Requisitos
- Android 7.0 o posterior (mínimo nivel de API 24)
- Android Gradle Plugin 8.7.3 o posterior
- Kotlin Gradle plugin 1.9.24 o posterior
- Un proyecto Android existente
- Credenciales de Autentikar y acceso privado al repositorio Maven
- Su
applicationIdde la aplicación está registrado con Autentikar - Un código obtenido desde el endpoint de
startde Autentikar
Si su applicationId no está registrado, póngase en contacto con [email protected].
Permisos
Añada los permisos requeridos a AndroidManifest.xml:
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CAMERA" />
Configurar el repositorio privado Maven
Agregue el repositorio Autentikar a su configuración del repositorio del proyecto. Los valores ACCESS_KEY y SECRET_KEY son proporcionados por separado por Autentikar.
allprojects {
repositories {
google()
mavenCentral()
maven {
url "s3://maven.autentikar.s3.amazonaws.com"
credentials(AwsCredentials) {
accessKey ACCESS_KEY
secretKey SECRET_KEY
}
}
}
}
Añadir los módulos
El núcleo es obligatorio. Añadir PhotoIDScan y UnifiedID sólo cuando el flujo registrado utiliza sus pasos. Utilice las versiones actuales enumeradas en cada página de dependencia.
implementation "com.autentikar:core-v2:x.x.x"
implementation "com.autentikar:photoidscan:x.x.x"
implementation "com.autentikar:unifiedid:x.x.x"
Registrar los pasos de flujo
Registrar sólo los contratos requeridos por su flujo, normalmente durante la puesta en marcha de la aplicación:
AutentikarManager.register(
AutentikarPhotoIDScanManager.setContract(AutentikarStepType.CARD_CAPTURE)
)
AutentikarManager.register(
AutentikarUnifiedIDManager.setContract(AutentikarStepType.FACETEC_LIVENESS)
)
AutentikarManager.register(
AutentikarUnifiedIDManager.setContract(AutentikarStepType.FACE_FACETEC)
)
Configurar el SDK
Establecer el alias asignado por Autentikar. El stage por defecto es producción; establecerlo explícitamente cuando desea que la configuración sea sandbox.
AutentikarConfiguration.alias = "test"
AutentikarConfiguration.stage = AutentikarStageType.PRODUCTION
El stage selecciona la URL de servicio utilizada por el SDK.
Iniciar el flujo
Pase el lanzador, la Actividad actual y el código devuelto cuando se inició el flujo:
AutentikarManager.start(
autentikarResultLauncher,
context = this,
code = "j-C5eB0dkVk"
) { error ->
// El SDK no pudo iniciarse. Muestra o registra el error.
}
El handler result informa si el ciclo de vida SDK terminó con éxito o falló. El callback de error de inicio está reservado para fallos que impiden el flujo desde el principio.
Handler result
Crear un handler result de actividad para que el resultado permanezca vinculado al ciclo de vida de la actividad:
RegisterForActivityResult solo indica que la instancia ha finalizado su ciclo de vida, para obtener el resultado de la instancia hacer uso del endpoint statusprivate val autentikarResultLauncher =
registerForActivityResult(AutentikarResultContract()) { result ->
when (result) {
AutentikarResultType.SUCCESS -> {
println("Success")
}
AutentikarResultType.FAILED -> {
// Handle failure
}
}
}
Personalizar la experiencia
Todos los módulos de carga UI se pueden adaptar a la marca de su aplicación. Continúe con Personalización de la UI.