Este guía fue elaborada para ayudarlo a implementar el SDK Android de manera rápida y sencilla. A continuación, vea el paso a paso de todo el proceso de integración. Después de eso, si desea personalizar la experiencia, no deje de ver la sección Personalización Android.

Inicializar el SDK

Cree una instancia del builder (Generado a través de la interfaz IAcessoBioBuilder), proporcionando como parámetro el contexto y el ambiente en cuestión, y la implementación de la clase AcessoBioListener.

La implementación de esta clase es muy simple y se puede hacer con pocas líneas de código. Lo único que necesita hacer es instanciar el builder proporcionando el contexto correspondiente y sobrescribir los métodos de callback con la lógica de negocio de su aplicación:

public class MainActivity extends AppCompatActivity {

    private AcessoBioListener callback = new AcessoBioListener() {
        @Override
        public void onErrorAcessoBio(ErrorBio errorBio) { }

        @Override
        public void onUserClosedCameraManually() { }

        @Override
        public void onSystemClosedCameraTimeoutSession() { }

        @Override
        public void onSystemChangedTypeCameraTimeoutFaceInference() { }
    };

    private IAcessoBioBuilder acessoBioBuilder = new AcessoBio(this, callback);
}

internal class MainActivity : AppCompatActivity() {

    private val callback = object : AcessoBioListener {
        override fun onErrorAcessoBio(errorBio: ErrorBio?) { }
    
        override fun onUserClosedCameraManually() { }
    
        override fun onSystemClosedCameraTimeoutSession() { }
    
        override fun onSystemChangedTypeCameraTimeoutFaceInference() { }
    }

    private val acessoBioBuilder: IAcessoBioBuilder = AcessoBio(this, callback)
}

Configuración de ambientes

Configure el ambiente que se utilizará en la ejecución del SDK. Utilice el enumerado Environment que contiene los siguientes valores enumerados:

• Environment.PROD: para ambiente de Producción;

• Environment.UAT: para ambiente de Homologación.

Vea cómo implementarlo en el siguiente ejemplo:

acessoBioBuilder.setEnvironment(Environment.UAT);

acessoBioBuilder.setEnvironment(Environment.UAT);

Implementar las funciones de callback

Tenga en cuenta que el trabajo de implementación de la clase AcessoBioListener es, en su mayoría, la configuración de los métodos de callback. Cada método se llama en una situación específica de retorno del SDK.

Basta con sobrescribir los métodos ejemplificados en el paso anterior con la lógica de negocio de su aplicación.

Este método se invoca siempre que ocurra cualquier error de implementación al utilizar alguno de nuestros métodos:

Configurar modo de cámara

El SDK tiene configurado y habilitado por defecto el encuadre inteligente y la captura automática. Por lo tanto, debe configurarse el modo de cámara en su builder de la siguiente manera:

UnicoCheckCamera unicoCheckCamera = acessoBioBuilder
    .setAutoCapture(true)
    .setSmartFrame(true)
    .build();

val unicoCheckCamera: UnicoCheckCamera = acessoBioBuilder
    .setAutoCapture(true)
    .setSmartFrame(true)
    .build()

Implementar listeners para eventos de la cámara

El método de apertura de la cámara, que se llama en la siguiente etapa, necesita saber qué hacer al lograr capturar una imagen con éxito o si ocurre algún error en el proceso. Es necesario especificar "qué hacer" al método de apertura de la cámara mediante la implementación de listeners que se llaman en situaciones de éxito o error.

A través de la configuración de los listeners, puede especificar qué sucede en su App en situaciones de error (Método onErrorSelfie) o éxito (Método onSuccessSelfie) durante la captura de imágenes.

Para la configuración de los listeners, es necesario implementar:

iAcessoBioSelfie cameraListener = new iAcessoBioSelfie() {
    @Override
    public void onSuccessSelfie(ResultCamera result) { }

    @Override
    public void onErrorSelfie(ErrorBio errorBio) { }
};

unicoCheckCamera.prepareCamera(unicoConfig, new CameraListener() {
    @Override
    public void onCameraReady(UnicoCheckCameraOpener.Camera cameraOpener) {
        cameraOpener.open(cameraListener);
    }

    @Override
    public void onCameraFailed(String message) {
        Log.e(TAG, message);
    }
});

val cameraListener: iAcessoBioSelfie = object : iAcessoBioSelfie {
    override fun onSuccessSelfie(result: ResultCamera?) {}

    override fun onErrorSelfie(errorBio: ErrorBio?) {}
}

unicoCheckCamera.prepareCamera(unicoConfig, object : CameraListener {
    override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Camera?) {
        cameraOpener?.open(cameraListener)
    }

    override fun onCameraFailed(message: String?) {
        Log.e(TAG, message)
    }
})

Preparar y abrir cámara

Para continuar con la apertura de la cámara, primero es necesario prepararla utilizando el método prepareCamera. Este método recibe como parámetro la implementación de la clase CameraListener, la clase o el JSON con las credenciales, generados en esta etapa.

Cuando la cámara esté preparada, se dispara el evento onCameraReady, que recibe como parámetro un objeto del tipo UnicoCheckCameraOpener.Camera.

Es necesario sobrescribir este método, realizando la apertura de la cámara con el objeto recibido a través del método open(). El método open() debe recibir como parámetro los listeners configurados en los pasos anteriores.

Método onSuccessSelfie

Al realizar una captura de imagen con éxito, este método es invocado y retorna un objeto del tipo ResultCamera, que se utiliza posteriormente en la llamada a las APIs REST:

public void onSuccessSelfie(ResultCamera result) { }

El objeto ResultCamera retorna 2 atributos: base64 y encrypted:

• El atributo base64 puede ser utilizado si se desea mostrar una vista previa de la imagen en su app.

• El atributo encrypted debe ser enviado en la llamada a las APIs REST del IDCloud.

Método onErrorSelfie

Cuando ocurre algún error en la captura de imagen, este método es invocado y retorna un objeto del tipo ErrorBio:

public void onErrorSelfie(ErrorBio errorBio) { }

Realizar una solicitud POST en la API REST

La captura de las imágenes es solo la primera parte del proceso. Después de capturar la imagen, es necesario enviar el encrypted generado por el SDK a las APIs REST. Infórmese más en la sección Creación de proceso.

¿Dudas?

¿No encontraste algo o aún necesitas ayuda? Si ya eres cliente o socio, puedes ponerte en contacto a través del Centro de Ayuda.

Objeto ErrorBio​

Este objeto es retornado siempre que ocurre un error en el SDK Android.

Métodos disponibles

A continuación se presenta la lista de posibles códigos de error del SDK Android:

¿Dudas?

¿No encontraste algo o aún necesitas ayuda? Si ya eres cliente o socio, puedes ponerte en contacto a través del Centro de Ayuda.

El SDK Android permite que se realicen algunas personalizaciones. A continuación, vea todas las personalizaciones posibles para este SDK.

Personalizar idioma

Es posible configurar la experiencia de los mensajes informativos de los marcos de captura cambiando su idioma. Utilice el enumerado LocaleTypes, que contiene los siguientes valores:

• LocaleTypes.PT_BR: para Portugués (Brasil);

• LocaleTypes.ES_MX: para Español (México);

• LocaleTypes.ES_ES: para Español (España);

• LocaleTypes.EN_US: para Inglês (EUA).

Vea cómo implementarlo en el siguiente ejemplo:

unicoCheck.setLocale(LocaleTypes.EN_US);

unicoCheck.setLocale(LocaleTypes.EN_US);

Personalizar la experiencia del proceso de captura

Personalizar la experiencia de captura de la Selfie

Esta es una etapa opcional, pero muy recomendada para que el proceso de captura tenga la identidad visual de su empresa.

Es posible personalizar algunos objetos del marco de acuerdo con el modo de cámara utilizado, mediante el método setTheme().

Todos los métodos están disponibles a continuación:

IAcessoBioTheme unicoTheme = new IAcessoBioTheme() {
    @Override
    public Object getColorBackground() { 
        return R.color.your_color;
    }

    @Override
    public Object getColorBoxMessage() { 
        return R.color.your_color;
    }

    @Override
    public Object getColorTextMessage() { 
        return R.color.your_color;
    }

    @Override
    public Object getColorBackgroundPopupError() { 
        return R.color.your_color;
    }

    @Override
    public Object getColorTextPopupError() { 
        return R.color.your_color;
    }

    @Override
    public Object getColorBackgroundButtonPopupError() { 
        return R.color.your_color;
    }

    @Override
    public Object getColorTextButtonPopupError() { 
        return R.color.your_color;
    }

    @Override
    public Object getColorBackgroundTakePictureButton() { 
        return R.color.your_color;
    }

    @Override
    public Object getColorIconTakePictureButton() { 
        return R.color.your_color;
    }

    @Override
    public Object getColorBackgroundBottomDocument() { 
        return R.color.your_color;
    }

    @Override
    public Object getColorTextBottomDocument() { 
        return R.color.your_color;
    }

    @Override
    public Object getColorSilhouetteSuccess() { 
        return R.color.your_color;
    }

    @Override
    public Object getColorSilhouetteError() { 
        return R.color.your_color;
    }

    @Override
    public Object getColorProgressBar() { 
        return R.color.your_color;
    }
};
    
acessoBioBuilder.setTheme(unicoTheme); 

val unicoTheme = object: IAcessoBioTheme {

    override fun getColorBackground() = R.color.your_color
    override fun getColorBoxMessage() = R.color.your_color
    override fun getColorTextMessage() = R.color.your_color
    override fun getColorBackgroundPopupError() = R.color.your_color
    override fun getColorTextPopupError() = R.color.your_color
    override fun getColorBackgroundButtonPopupError() = R.color.your_color
    override fun getColorTextButtonPopupError() = R.color.your_color
    override fun getColorBackgroundTakePictureButton() = R.color.your_color
    override fun getColorIconTakePictureButton() = R.color.your_color
    override fun getColorBackgroundBottomDocument() = R.color.your_color
    override fun getColorTextBottomDocument() = R.color.your_color
    override fun getColorSilhouetteSuccess() = R.color.your_color
    override fun getColorSilhouetteError() = R.color.your_color 
    override fun getColorSilhouetteNeutral() = R.color.your_color
    override fun getColorProgressBar() = R.color.your_color
}

acessoBioBuilder.setTheme(unicoTheme)

También es posible realizar personalizaciones de forma estática. En su archivo colors.xml, agregue el siguiente código:

<color name="unico_color_background"> #YourColor </color> 
<color name="unico_color_silhouette_success"> #YourColor </color> 
<color name="unico_color_silhouette_error"> #YourColor </color> 
<color name="unico_color_silhouette_neutral"> #YourColor </color> 
<color name="unico_color_box_message"> #YourColor </color> 
<color name="unico_color_text_message"> #YourColor </color> 
<color name="unico_color_background_popup_error"> #YourColor </color> 
<color name="unico_color_text_popup_error"> #YourColor </color> 
<color name="unico_color_background_button_popup_error"> #YourColor </color> 
<color name="unico_color_text_button_popup_error"> #YourColor </color> 
<color name="unico_color_background_take_picture_button"> #YourColor </color> 
<color name="unico_color_icon_take_picture_button"> #YourColor </color> 
<color name="unico_color_background_bottom_document"> #YourColor </color> 
<color name="unico_color_text_bottom_document"> #YourColor </color> 
<color name="unico_color_button_cancel"> #YourColor </color> 
<color name="unico_color_progress_bar_capture"> #YourColor </color> 

A continuación, consulte la especificación de campos de personalización:

Personalizar la experiencia de captura del documento

Esta es una etapa opcional, pero muy recomendada para que el proceso de captura tenga la identidad visual de su empresa.

Es posible personalizar algunos objetos del marco de acuerdo con el modo de cámara utilizado, mediante el método setTheme().

Todos los métodos están disponibles a continuación:

IAcessoBioTheme unicoTheme = new IAcessoBioTheme() {
    @Override
    public Object getColorBackground() { 
        return R.color.your_color;
    }
    @Override
    public Object getColorBoxMessage() { 
        return R.color.your_color;
    }
    @Override
    public Object getColorTextMessage() { 
        return R.color.your_color;
    }
    @Override
    public Object getColorBackgroundPopupError() { 
        return R.color.your_color;
    }
    @Override
    public Object getColorTextPopupError() { 
        return R.color.your_color;
    }
    @Override
    public Object getColorBackgroundButtonPopupError() { 
        return R.color.your_color;
    }
    @Override
    public Object getColorTextButtonPopupError() { 
        return R.color.your_color;
    }
    @Override
    public Object getColorBackgroundTakePictureButton() { 
        return R.color.your_color;
    }
    @Override
    public Object getColorIconTakePictureButton() { 
        return R.color.your_color;
    }
    @Override
    public Object getColorBackgroundBottomDocument() { 
        return R.color.your_color;
    }
    @Override
    public Object getColorTextBottomDocument() { 
        return R.color.your_color;
    }
    @Override
    public Object getColorSilhouetteSuccess() { 
        return R.color.your_color;
    }
    @Override
    public Object getColorSilhouetteError() { 
        return R.color.your_color;
    }

    @Override
    public Object getColorProgressBar() { 
        return R.color.your_color;
    }
};
    
acessoBioBuilder.setTheme(unicoTheme); 

val unicoTheme = object: IAcessoBioTheme {
    override fun getColorBackground() = R.color.your_color
    override fun getColorBoxMessage() = R.color.your_color
    override fun getColorTextMessage() = R.color.your_color
    override fun getColorBackgroundPopupError() = R.color.your_color
    override fun getColorTextPopupError() = R.color.your_color
    override fun getColorBackgroundButtonPopupError() = R.color.your_color
    override fun getColorTextButtonPopupError() = R.color.your_color
    override fun getColorBackgroundTakePictureButton() = R.color.your_color
    override fun getColorIconTakePictureButton() = R.color.your_color
    override fun getColorBackgroundBottomDocument() = R.color.your_color
    override fun getColorTextBottomDocument() = R.color.your_color
    override fun getColorSilhouetteSuccess() = R.color.your_color
    override fun getColorSilhouetteError() = R.color.your_color
    override fun getColorSilhouetteNeutral() = R.color.your_color
    override fun getColorProgressBar() = R.color.your_color
}
acessoBioBuilder.setTheme(unicoTheme)

También es posible realizar personalizaciones de forma estática. En su archivo colors.xml, agregue el siguiente código:

<color name="unico_color_background"> #YourColor </color> 
<color name="unico_color_silhouette_success"> #YourColor </color> 
<color name="unico_color_silhouette_error"> #YourColor </color> 
<color name="unico_color_silhouette_neutral"> #YourColor </color> 
<color name="unico_color_box_message"> #YourColor </color> 
<color name="unico_color_text_message"> #YourColor </color> 
<color name="unico_color_background_popup_error"> #YourColor 
<color name="unico_color_text_popup_error"> #YourColor </color> 
<color name="unico_color_background_button_popup_error"> #YourColor 
<color name="unico_color_text_button_popup_error"> #YourColor </color> 
<color name="unico_color_background_take_picture_button"> #YourColor </color> 
<color name="unico_color_icon_take_picture_button"> #YourColor </color> 
<color name="unico_color_background_bottom_document"> #YourColor </color> 
<color name="unico_color_text_bottom_document"> #YourColor </color> 
<color name="unico_color_button_cancel"> #YourColor </color> 
<color name="unico_color_progress_bar_capture"> #YourColor </color> 

A continuación, consulte la especificación de campos de personalización:

¿Dudas?

¿No encontraste algo o aún necesitas ayuda? Si ya eres cliente o socio, puedes ponerte en contacto a través del Centro de Ayuda.

Este guía ha sido elaborada para ayudarlo a implementar el SDK Android de manera rápida y sencilla. A continuación, vea el paso a paso de todo el proceso de integración. Después de eso, si desea personalizar la experiencia, no deje de consultar la sección Personalización Android.

Marcos de documentos disponibles

En este modo de cámara, existe un marco de captura para ayudar al usuario a posicionar correctamente el documento. Después de posicionar el documento de manera correcta, el usuario debe hacer clic en el botón para realizar la captura de la foto del documento.

En este modo de cámara es posible capturar los documentos:

• CPF: Captura del frente del CPF;

• CNH: Captura de la CNH abierta;

• CNH frente: Captura del frente de la CNH;

• CNH verso: Captura del reverso de la CNH;

• RG frente: Captura del frente del RG;

• RG verso: Captura del reverso del RG;

• Otros: Captura de cualquier otro documento.

Inicializar el SDK

Cree una instancia del builder (Generado a través de la interfaz IAcessoBioBuilder), proporcionando como parámetro el contexto en cuestión y la implementación de la clase AcessoBioListener.

La implementación de esta clase es bastante simple y se puede hacer con pocas líneas de código. Todo lo que necesita hacer es instanciar el builder proporcionando el contexto correspondiente y sobrescribir los métodos de callback con las lógicas de negocio de su aplicación:

public class MainActivity extends AppCompatActivity {

    private AcessoBioListener callback = new AcessoBioListener() {
        @Override
        public void onErrorAcessoBio(ErrorBio errorBio) { }

        @Override
        public void onUserClosedCameraManually() { }

        @Override
        public void onSystemClosedCameraTimeoutSession() { }

        @Override
        public void onSystemChangedTypeCameraTimeoutFaceInference() { }
    };

    private IAcessoBioBuilder acessoBioBuilder = new AcessoBio(this, callback);
}

internal class MainActivity : AppCompatActivity() {

    private val callback = object : AcessoBioListener {
        override fun onErrorAcessoBio(errorBio: ErrorBio?) { }
    
        override fun onUserClosedCameraManually() { }
    
        override fun onSystemClosedCameraTimeoutSession() { }
    
        override fun onSystemChangedTypeCameraTimeoutFaceInference() { }
    }

    private val acessoBioBuilder: IAcessoBioBuilder = AcessoBio(this, callback)
}

Implementar las funciones de callback

Tenga en cuenta que el trabajo de implementación de la clase AcessoBioListener consiste en gran parte en la configuración de los métodos de callback. Cada método se llama en una situación específica de retorno del SDK.

Basta con sobrescribir los métodos ejemplificados en el paso anterior con las lógicas de negocio de su aplicación:

Implementar listeners para eventos de la cámara

El método de apertura de la cámara, que se llama en la siguiente etapa, necesita saber qué hacer cuando logre capturar una imagen con éxito o si ocurre algún error en el proceso. Es necesario especificar "qué hacer" al método de apertura de la cámara mediante la implementación de listeners que se llaman en situaciones de éxito o error.

A través de la configuración de los listeners, puede especificar qué ocurre en su App en situaciones de error (Método onErrorDocument) o éxito (Método onSuccessDocument) durante la captura de imágenes.

El siguiente ejemplo ilustra la configuración de los listeners, el build y la apertura de la cámara:

iAcessoBioDocument cameraListener = new iAcessoBioDocument() {
    @Override
    public void onSuccessDocument(ResultCamera result) { }

    @Override
    public void onErrorDocument(ErrorBio errorBio) { }
};

unicoCheckCamera.prepareDocumentCamera(unicoConfig, new DocumentCameraListener() {
    @Override
    public void onCameraReady(UnicoCheckCameraOpener.Document cameraOpener) {
        cameraOpener.open(DocumentType.CNH, cameraListener);
    }

    @Override
    public void onCameraFailed(String message) {
        Log.e(TAG, message);
    }
});

val cameraListener: iAcessoBioDocument = object : iAcessoBioDocument {
    override fun onSuccessDocument(result: ResultCamera?) {}

    override fun onErrorDocument(errorBio: ErrorBio?) {}
}

unicoCheckCamera.prepareDocumentCamera(unicoConfig, object : DocumentCameraListener {
    override fun onCameraReady(cameraOpener: UnicoCheckCameraOpener.Document?) {
        cameraOpener?.open(DocumentType.CNH, cameraListener)
    }

    override fun onCameraFailed(message: String?) {
        Log.e(TAG, message)
    }
})

Preparar y abrir la cámara

Es necesario crear una instancia del builder a través del método build(). Este método está disponible a través del objeto generado con la interfaz IAcessoBioBuilder y la clase AcessoBio:

UnicoCheckCamera unicoCheckCamera = acessoBioBuilder.build();  

val unicoCheckCamera = acessoBioBuilder.build()

El siguiente paso es preparar la cámara utilizando el método prepareDocumentCamera() con el objeto retornado por el builder (nombrado como UnicoCheckCamera en el ejemplo anterior).

El método prepareDocumentCamera() genera un objeto del tipo UnicoCheckCameraOpener.Document, que se utiliza para abrir la cámara con su método open(), recibiendo los parámetros del tipo de documento a capturar, siendo estos:

Método onSuccessDocument

Al realizar una captura de imagen con éxito, este método es invocado y retorna un objeto del tipo ResultCamera, que se utiliza posteriormente en la llamada a las APIs REST:

public void onSuccessDocument(ResultCamera result) { }

El objeto ResultCamera retorna 2 atributos: base64 y encrypted:

• El atributo base64 puede ser utilizado si desea mostrar una vista previa de la imagen en su app.

• Tanto el atributo encrypted como el atributo base64 pueden enviarse en la llamada a las APIs REST.

Método onErrorDocument

Cuando ocurre un error en la captura de imagen, este método es invocado y retorna un objeto del tipo ErrorBio:

public void onErrorDocument(ErrorBio errorBio) { }

Realizar una solicitud POST en la API REST

La captura de las imágenes es solo la primera parte del proceso. Después de capturar la imagen, es necesario enviar el base64 generado por el SDK a las APIs REST. Infórmese más en la sección Creación de proceso.

¿Dudas?

¿No encontraste algo o aún necesitas ayuda? Si ya eres cliente o socio, puedes ponerte en contacto a través del Centro de Ayuda.

Ofuscación de código

La ofuscación es un proceso que transforma el bytecode en una forma menos legible por humanos, dificultando así la ingeniería inversa.

Este proceso consiste en eliminar información relacionada con la depuración, como tablas de variables, números de líneas, y renombrar paquetes, clases y métodos.

Al integrar el SDK Android en la aplicación, pueden ocurrir fallos.

Ofuscación a través de DexGuard

Cuando la ofuscación se realiza mediante DexGuard, en caso de fallo, utilice las siguientes reglas:

-keep class kotlin.coroutines.**
-keep class kotlinx.coroutines.**

-keep class com.facetec.sdk.** { *; }
-keep class com.acesso.acessobio_android.** { *; }
-keep class io.unico.** { *; }

-keep class br.com.makrosystems.haven.** { *; }
-keep class HavenSDK.**{ *; }
-keep class HavenSDK** { *; }

Ofuscación a través de ProGuard

Cuando la ofuscación se realiza mediante ProGuard, en caso de fallo, utilice las siguientes reglas:

-keep class kotlin.coroutines.**
-keep class kotlinx.coroutines.**

-keep class com.facetec.sdk.** { *; }
-keep class com.acesso.acessobio_android.** { *; }
-keep class io.unico.** { *; }

-keep class br.com.makrosystems.haven.** { *; }
-keep class HavenSDK.**{ *; }
-keep class HavenSDK** { *; }

Actualización del SDK - versión 4.3.x

A partir de la versión 4.4.x del SDK, Unico comenzó a usar su propio repositorio Maven para distribuir el SDK de Android y cambió el nombre de la dependencia del SDK, además de realizar ajustes en las reglas de ProGuard y DexGuard para los clientes que utilizan la biblioteca de GuardSquare, como se describe en la sección de Ofuscación de código arriba.

Cambia el repositorio Maven:

Cambia el repositorio Maven al nuevo repositorio en el archivo build.gradle del proyecto.

La implementación se hacía de la siguiente manera:

// Top-level build file where you can add configuration options common to all sub-projects/modules.
allprojects {
    repositories {
        google()
        jcenter()
        maven { url 'https://jitpack.io'}
    }
}

Ahora debe actualizarse al nuevo repositorio:

// Top-level build file where you can add configuration options common to all sub-projects/modules.
allprojects {
    repositories {
        google()
        jcenter()
        maven { 
            url "https://maven-sdk.unico.run/sdk-mobile" 
        }
    }
}

Cambiar la dependencia del SDK

Cambia la dependencia del SDK a la nueva dependencia en el archivo app/build.gradle del proyecto.

La implementación se hacía de la siguiente manera:

/* unico */
dependencies {
    implementation 'com.github.acesso-io:acessobio-android:$version'
}

Ahora debe actualizarse a la nueva dependencia:

/* unico */
dependencies {
    implementation "io.unico:capture:$version"
}

¿Dudas?

¿No encontraste algo o aún necesitas ayuda? Si ya eres cliente o socio, puedes ponerte en contacto a través del Centro de Ayuda.

Versión 5.30.1​ - 27/02/2025

• Ajustes de dependencias internas garantizando la compatibilidad con la versión de Kotlin 1.6.0.

Versión 5.30.0​ - 25/02/2025

• Soporte para la cámara trasera en flujos de tiendas físicas;

• Actualización del SDK y servidor de Liveness con interacción;

• Mejoras internas del producto. Estas mejoras no afectan directamente la experiencia del usuario final, manteniendo la interfaz y funcionalidades externas sin cambios.

¿Dudas?

¿No encontraste algo o aún necesitas ayuda? Si ya eres cliente o socio, puedes ponerte en contacto a través del Centro de Ayuda.

Requisitos previos del entorno de desarrollo

Es necesario que su entorno de desarrollo cumpla con los siguientes requisitos previos:

Dispositivos compatibles

El SDK Android es compatible con la gran mayoría de dispositivos que tengan Android 5.0 (API de nivel 21) o versiones superiores.

La siguiente tabla lista los dispositivos probados en laboratorio, además de la disponibilidad de las extensiones del proveedor/fabricante. Algunas extensiones listadas pueden estar sujetas a APIs o SKUs específicos del fabricante. Haga clic a continuación para ver los dispositivos probados:

Instalando el SDK Android

Para implementar el SDK Android de la plataforma Unico IDCloud en su aplicación Android, siga los pasos listados a continuación:

// Top-level build file where you can add configuration options common to all sub-projects/modules.
allprojects 
{
    repositories {
        google()
        maven { 
            url "https://maven-sdk.unico.run/sdk-mobile" 
        }
    }
}

# Project-wide Gradle settings.
# https://developer.android.com/topic/libraries/support-library/androidx-rn
android.useAndroidX=true
# Automatically convert third-party libraries to use AndroidX
android.enableJetifier=true

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.INTERNET" />

/* unico */
implementation 'io.unico:capture:$version'

android { 
    compileOptions { 
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8 
      } 
}

package <package_name>

import com.acesso.acessobio_android.onboarding.AcessoBioConfigDataSource;

public class UnicoConfig implements AcessoBioConfigDataSource {
    @Override
    public String getBundleIdentifier() {
        return BUNDLE_IDENTIFIER;
    }
        
    @Override
    public String getHostKey() {
        return SDK_KEY;
    }
}

import com.acesso.acessobio_android.onboarding.AcessoBioConfigDataSource

class UnicoConfig : AcessoBioConfigDataSource {
    override fun getBundleIdentifier(): String {
        return BUNDLE_IDENTIFIER
    }

    override fun getHostKey(): String {
        return SDK_KEY
    }
}

package <package_name>

import com.acesso.acessobio_android.onboarding.AcessoBioConfigDataSource;

public class UnicoConfig implements AcessoBioConfigDataSource {
    @Override
    public String getProjectNumber() {
        return PROJECT_NUMBER;
    }
    
    @Override
    public String getProjectId() {
        return PROJECT_ID;
    }
    
    @Override
    public String getMobileSdkAppId() {
        return MOBILE_SDK_APP_ID;
    }
    
    @Override
    public String getBundleIdentifier() {
        return BUNDLE_IDENTIFIER;
    }
    
    @Override
    public String getHostInfo() {
        return HOST_INFO;
    }
    
    @Override
    public String getHostKey() {
        return HOST_KEY;
    }
}

package <package_name>

import com.acesso.acessobio_android.onboarding.AcessoBioConfigDataSource

class UnicoConfig : AcessoBioConfigDataSource {
    override fun getProjectNumber(): String {
        return PROJECT_NUMBER
    }

    override fun getProjectId(): String {
        return PROJECT_ID
    }

    override fun getMobileSdkAppId(): String {
        return MOBILE_SDK_APP_ID
    }

    override fun getBundleIdentifier(): String {
        return BUNDLE_IDENTIFIER
    }

    override fun getHostInfo(): String {
        return HOST_INFO
    }

    override fun getHostKey(): String {
        return HOST_KEY
    }
}

Listo. Una vez finalizada la instalación del SDK, continúe con la implementación leyendo el material Guía de uso e integración a continuación:

¿Dudas?

¿No encontraste algo o aún necesitas ayuda? Si ya eres cliente o socio, puedes ponerte en contacto a través del Centro de Ayuda.