El SDK iOS permite realizar 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 frames 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 Espanhol(México);

• LocaleTypes.ES_ES: para Espanhol(Espanha);

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

Vea cómo implementarlo en el siguiente ejemplo:

[unicoCheck setLocale:EN_US];

unicoCheck.setLocale(.EN_US);

Personalizar experiência do processo de captura

Esta é uma etapa opcional, porém muito recomendada para que o processo de captura tenha a identidade visual da sua empresa.

É possível customizar alguns objetos do frame de acordo com o modo de câmera utilizado, através do método setTheme().

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

A continuación, algunos ejemplos de cómo puede utilizar los métodos anteriores en su proyecto:

.h:
#import "AcessoBioThemeDelegate.h"

@interface ViewController : UIViewController  {

@end

.m:
#import "ViewController.h"
#import <AcessoBio/AcessoBio.h>

@interface ViewController ()

@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    unicoCheck = [[AcessoBioManager alloc]initWithViewController:self];
}

- (id)getColorBackground {
    code
}

- (id)getColorBackgroundBottomDocument {
    code
}

- (id)getColorBackgroundButtonPopupError {
    code
}

- (id)getColorBackgroundPopupError {
    code
}

- (id)getColorBackgroundTakePictureButton {
    code
}

- (id)getColorBoxMessage {
    code
}

- (id)getColorIconTakePictureButton {
    code
}

- (id)getColorSilhouetteError {
    code
}

- (id)getColorSilhouetteSuccess {
    code
}

- (id)getColorTextBottomDocument {
    code
}

- (id)getColorTextButtonPopupError {
    code
}

- (id)getColorTextMessage {
    code
}

- (id)getColorTextPopupError {
    code
}

- (id) getProgressBarColor {
    code
}

- (id) getCancelButtonIconColor {
    code
}

@end

import UIKit
import AcessoBio

class ViewController: UIViewController, AcessoBioManagerDelegate, AcessoBioThemeDelegate {

    var unicoCheck: AcessoBioManager!

    override func viewDidLoad() {
        super.viewDidLoad()
        
        unicoCheck = AcessoBioManager(viewController: self)
        unicoCheck.setTheme(self)
    }
 

    func getColorBackground() -> Any! {
        code
    }

    func getColorBoxMessage() -> Any! {
        code
    }

    func getColorTextMessage() -> Any! {
        code
    }

    func getColorBackgroundPopupError() -> Any! {
        code
    }

    func getColorTextPopupError() -> Any! {
        code
    }

    func getColorBackgroundButtonPopupError() -> Any! {
        code
    }

    func getColorTextButtonPopupError() -> Any! {
        code
    }

    func getColorBackgroundTakePictureButton() -> Any! {
        code
    }

    func getColorIconTakePictureButton() -> Any! {
        code
    }

    func getColorBackgroundBottomDocument() -> Any! {
        code
    }

    func getColorTextBottomDocument() -> Any! {
        code
    }

    func getColorSilhouetteSuccess() -> Any! {
        code
    }

    func getColorSilhouetteError() -> Any! {
        code
    } 

    func getProgressBarColor() -> Any! {
        code
    }

    func getCancelButtonIconColor() -> Any! {
        code
    }
} 

¿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 iOS.

Métodos disponíveis

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

¿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:

Instalando el SDK iOS

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

pod ‘unicocheck-ios’

pod install

<uses-dependencies: [
    .package(url: "https://github.com/acesso-io/unico-check-ios.git", .upToNextMajor(from: "2.12.0"))
]

<key>NSCameraUsageDescription</key>
<string>Camera usage description</string>

.h:
#import <AcessoBio/AcessoBioManager.h>
#import <AcessoBio/AcessoBio-Swift.h>

@interface YourUnicoConfigClass: AcessoBioConfigDataSource {}
@end

.m:
@implementation YourUnicoConfigClass

- (NSString * _Nonnull)getBundleIdentifier {
    return @"<YOUR_MOBILE_BUNDLE_IDENTIFIER>";
}

- (NSString * _Nonnull)getHostKey {
    return @"<YOUR_SDK_KEY>";
}

@end

import AcessoBio

class YourUnicoConfigClass: AcessoBioConfigDataSource {
          
    func getBundleIdentifier() -> String {
        return "<YOUR_MOBILE_BUNDLE_IDENTIFIER>"
    }
        
    func getHostKey() -> String {
        return "<YOUR_SDK_KEY>"
    }
}

.h:
#import <AcessoBio/AcessoBioManager.h>
#import <AcessoBio/AcessoBio-Swift.h>

@interface YourUnicoConfigClass: AcessoBioConfigDataSource {}
@end

.m:
@implementation YourUnicoConfigClass

- (NSString * _Nonnull)getBundleIdentifier {
    return @"<YOUR_MOBILE_BUNDLE_IDENTIFIER>";
}

- (NSString * _Nonnull)getHostInfo {
    return @"<YOUR_HOST_INFO>";
}

- (NSString * _Nonnull)getHostKey {
    return @"<YOUR_HOST_KEY>";
}

- (NSString * _Nonnull)getMobileSdkAppId {
    return @"<YOUR_MOBILE_SDK_APP_ID>";
}

- (NSString * _Nonnull)getProjectId {
    return @"<YOUR_PROJECT_ID>";
}

- (NSString * _Nonnull)getProjectNumber {
    return @"<YOUR_PROJECT_NUMBER>";
}

@end

import AcessoBio

class YourUnicoConfigClass: AcessoBioConfigDataSource {
        
    func getProjectNumber() -> String {
        return "<YOUR_PROJECT_NUMBER>"
    }
    
    func getProjectId() -> String {
        return "<YOUR_PROJECT_ID>"
    }
    
    func getMobileSdkAppId() -> String {
        return "<YOUR_MOBILE_SDK_APP_ID>"
    }
    
    func getBundleIdentifier() -> String {
        eturn "<YOUR_MOBILE_BUNDLE_IDENTIFIER>"
    }
    
    func getHostInfo() -> String {
        return "<YOUR_HOST_INFO>"
    }
    
    func getHostKey() -> String {
        return "<YOUR_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.

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

Marcos de documentos disponibles

En este modo de cámara, existe un marco de captura para ayudar al usuario a colocar el documento correctamente. Después de colocar el documento en la posición 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 siguientes documentos:

• RG: Captura del RG (separado en frente y reverso);

• CNH: Captura de la CNH abierta;

• CNH frente: Captura del frente de la CNH;

• CNH reverso: Captura del reverso de la CNH;

• CPF: Captura del documento de CPF;

• Sin silueta: Captura de documento genérico.

Inicializar el SDK

Para comenzar con el SDK iOS de la plataforma Unico IDCloud, importa el SDK e implementa la interfaz AcessoBioManagerDelegate dentro del ViewController que deseas utilizar.

La implementación de esta clase es bastante simple y puede realizarse con pocas líneas de código. Todo lo que necesitas hacer es instanciar el builder, indicando el contexto en cuestión, y sobrescribir los métodos de callback con las lógicas de negocio de tu aplicación:

.m:
#import "ViewController.h"
#import <AcessoBio/AcessoBio.h>

@interface ViewController ()
@end

@implementation ViewController
- (void)viewDidLoad {
    [super viewDidLoad];   
    unicoCheck = [[AcessoBioManager alloc]initWithViewController:self];
}
   
- (void)onErrorAcessoBioManager:(ErrorBio *)error {
  // Your code
}

- (void)onSystemChangedTypeCameraTimeoutFaceInference {
  // Your code
}

- (void)onSystemClosedCameraTimeoutSession {
  // Your code
}

- (void)onUserClosedCameraManually {
  // Your code
}

@end

import UIKit
import AcessoBio

class ViewController: UIViewController, AcessoBioManagerDelegate {
  var unicoCheck: AcessoBioManager!

  override func viewDidLoad() {
    super.viewDidLoad()
    
    unicoCheck = AcessoBioManager(viewController: self)
  }

  func onErrorAcessoBioManager(_ error: ErrorBio!) {
    // Your code
  }

  func onUserClosedCameraManually() {
    // Your code
  }

  func onSystemClosedCameraTimeoutSession() {
    // Your code
  }

  func onSystemChangedTypeCameraTimeoutFaceInference() {
    // Your code
  }
}   

Implementar las funciones de callback

Ten en cuenta que, como en el ejemplo anterior, el trabajo de implementación de la interfaz AcessoBioManagerDelegate 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 sobrescribir los métodos ejemplificados en el paso anterior con las lógicas de negocio de tu aplicación:

Implementar delegados para eventos de la cámara

El método de apertura de la cámara (que se llama en el siguiente paso) necesita saber qué hacer cuando se capture una imagen con éxito o cuando ocurra un error en el proceso. Se informa "qué hacer" al método de apertura de la cámara a través de la configuración de delegados que se llaman en situaciones de éxito o error.

A través de la configuración de los delegados, puedes especificar lo que ocurre en tu aplicación en situaciones de error (método onErrorDocument) o éxito (método onSuccessDocument) al capturar imágenes.

Para la configuración de los delegados, debes implementar las interfaces DocumentCameraDelegate y AcessoBioDocumentDelegate:

.h:
#import <UIKit/UIKit.h>
#import <AcessoBio/AcessoBio.h>
#import "SelfieCameraDelegate.h"

@interface ViewController: UIViewController <AcessoBioManagerDelegate, DocumentCameraDelegate, 
  AcessoBioDocumentDelegate> {
  AcessoBioManager *unicoCheck;
  // Your code from previous and next steps here
}

import UIKit
import AcessoBio

class ViewController: UIViewController, AcessoBioManagerDelegate, DocumentCameraDelegate, 
  AcessoBioDocumentDelegate {    
  // Your code from previous and next steps here
}

Método onSucessDocument

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

- (void)onSuccessDocument:(DocumentResult *)result {
    NSLog(@"%@", result.base64);
} 

func onSuccessDocument(_ result: DocumentResult!) {
    // Your code
 }

El objeto ResultCamera retorna 2 atributos: base64 y encrypted:

• El atributo base64 puede ser utilizado si deseas mostrar una vista previa de la imagen en tu app;

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

Método onErrorDocument

Cuando ocurre un error en la captura de la imagen, este método se invoca y retorna un objeto del tipo ErrorBio.

- (void)onErrorDocument:(ErrorBio *)errorBio {
    // Your code
}

func onErrorDocument(_ errorBio: ErrorBio!) {
    // Your code
 }

Preparar y abrir la cámara

Para abrir la cámara, es necesario prepararla utilizando el método prepareDocumentCamera. Este método recibe como parámetro la implementación de la clase DocumentCameraDelegate y el JSON con las credenciales, generado en la etapa anterior.

.h:
#import <UIKit/UIKit.h>
#import <AcessoBio/AcessoBio.h>
#import "SelfieCameraDelegate.h"

@interface ViewController: UIViewController < AcessoBioManagerDelegate,
DocumentCameraDelegate, AcessoBioDocumentDelegate> {
    AcessoBioManager *unicoCheck;
}

.m:
- (IBAction)openCamera:(UIButton *)sender {
    [[unicoCheck build] prepareDocumentCamera:self config:[YourUnicoConfigClass new]];
}

import UIKit
import AcessoBio

class ViewController: UIViewController, AcessoBioManagerDelegate, 
DocumentCameraDelegate, AcessoBioDocumentDelegate {
    @IBAction func openCamera(_ sender: Any) {
        unicoCheck.build().prepareDocumentCamera(self, config: YourUnicoConfigClass())
    }
}

Quando a câmera estiver preparada, o evento onCameraReadyDocument é disparado, que recebe como parâmetro um objeto do tipo AcessoBioCameraOpenerDelegate.

Você deve sobrescrever este método, efetuando a abertura da câmera com o objeto recebido através do método openDocument(), recebendo os parâmetros tipo de documento a ser capturado, sendo eles:

Los delegados implementados anteriormente (aquí descritos como Self):

- (void)onCameraReadyDocument:(id)cameraOpener {
    [cameraOpener openDocument:DocumentCNH delegate:self];
}

- (void)onCameraFailedDocument:(ErrorPrepare *)message {
  // Your code
}

func onCameraReadyDocument(_ cameraOpener: AcessoBioCameraOpenerDelegate!) {
    cameraOpener.openDocument(DocumentEnums.CNH, delegate: self)
}
 
func onCameraFailedDocument(_ message: ErrorPrepare!) {
  // Your code
}

Caso ocorra algum erro ao preparar a câmera, o evento onCameraFailedDocument é disparado. Você deve implementar este método aplicando as regras de negócio de seu App.

Em caso de sucesso, o evento onSuccessDocument é disparado, conforme explicado na seção acima.

Realize um requisição POST na API REST do by Client

A captura das imagens é apenas a primeira parte da jornada. Após capturar a imagem, é necessário enviar o base64 gerado pelo SDK para as APIs REST do by Client. Saiba mais na seção 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.

Inicializar el SDK

Para comenzar con el SDK iOS de Unico Check, importe el SDK e implemente la interfaz AcessoBioManagerDelegate dentro del ViewController en el que desea utilizarlo.

La implementación de esta clase es bastante simple y puede realizarse con pocas líneas de código. Solo necesita instanciar el builder proporcionando el contexto y el entorno en cuestión, y sobrescribir los métodos de callback con las lógicas de negocio de su aplicación:

Configuración de entornos

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

• PROD: para entorno de Producción;

• UAT: para entorno de Homologación.

Vea cómo implementarlo en el siguiente ejemplo:

Implementar las funciones de callback

Tenga en cuenta que, conforme al ejemplo anterior, el trabajo de implementación de la interfaz AcessoBioManagerDelegate consiste en gran parte en configurar los métodos de callback. Cada método es llamado en una situación específica del retorno del SDK.

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

Configurar el modo de cámara

El SDK tiene configurado y habilitado por defecto el encuadre inteligente y la captura automática. Debido a esto, se debe configurar el modo de cámara en su builder de la siguiente manera:

Implementar delegados para eventos de la cámara

El método de apertura de la cámara necesita saber qué hacer al conseguir capturar una imagen con éxito o al tener algún error en el proceso. Se informa "qué hacer" al método de apertura de la cámara a través de la configuración de delegados que son llamados en situaciones de éxito o error.

A través de la configuración de los delegados, puedes especificar qué sucede en tu aplicación en situaciones de error (método onErrorSelfie) o éxito (método onSuccessSelfie) en la captura de imágenes.

Para la configuración de los delegados, debes implementar las interfaces SelfieCameraDelegate y AcessoBioSelfieDelegate:

Método onSuccessSelfie

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

El objeto ResultCamera retorna 2 atributos: base64 y encrypted:

• El atributo base64 puede ser utilizado si deseas mostrar una vista previa de la imagen en tu app;

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

Método onErrorSelfie

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

Configurar entornos

Es posible configurar el entorno que se utilizará en la ejecución del SDK. Utiliza el enumerado EnvironmentEnum, que contiene los siguientes valores:

• EnvironmentEnum.PROD: para el entorno de Producción

• EnvironmentEnum.UAT: para el entorno de Homologación

Mira cómo implementarlo en el siguiente ejemplo:

Preparar y abrir la cámara

Para continuar con la apertura de la cámara, primero debes prepararla utilizando el método prepareSelfieCamera. Este método recibe como parámetro la implementación de la clase SelfieCameraDelegate y el JSON con las credenciales, generado en la etapa anterior.

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

Debes sobrescribir este método, realizando la apertura de la cámara con el objeto recibido a través del método open():

Si ocurre algún error al preparar la cámara, el evento onCameraFailed se dispara. Debes implementar este método aplicando las reglas de negocio de tu aplicación.

Realizar una solicitud POST en la API REST del by Client

¿Dudas?

Versión 2.16.10 - 06/03/2025

pod 'unicocheck-ios', '2.16.9'

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

Versão 2.16.9 - 05/02/2025

pod 'unicocheck-ios', '2.16.9'

• Actualización del SDK y servidor de Liveness con interacció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.

Ofuscación de código

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

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

Al integrar el SDK iOS en la aplicación, pueden ocurrir fallas.

Ofuscación mediante iXGuard

Cuando la ofuscación se realice con la herramienta iXGuard, se sugiere utilizar la versión 4.12.6 o superior.

Sombra al final del flujo después de la actualización a la versión 2.4.0

La responsabilidad del control del flujo se delega a quien llama al SDK. Por lo tanto, si aparece alguna forma de sombra o la pantalla no se cierra después de la finalización exitosa de la captura, se sugiere implementar una forma de liberar esta pantalla. Esta liberación puede variar según el apilamiento de navegación implementado. Para esta implementación, agregue el método adecuado para la liberación preferiblemente dentro del método delegado onSuccessSelfie. A continuación, algunos ejemplos de liberación que pueden ser utilizados:

- (void)onSuccessSelfie:(SelfieResult *)result {
    [self dismissViewControllerAnimated:YES completion:nil];
    // your code
} 

func onSuccessSelfie(_ result: AcessoBio.SelfieResult!) {
    navigationController?.popViewController(animated: true)
    // your code
 }

Error de bitcode en la distribución de aplicaciones usando Xcode 16

Después del lanzamiento oficial de Xcode 16 el 17 de septiembre de 2024 y su uso para la distribución de aplicaciones en la App Store, se detectó un bloqueo al utilizar el SDK iOS, señalando el uso de bitcode en dos dependencias internas al usar Cocoapods como gestor de dependencias internas: DeviceProfiling y UnicoSdkLogger.

Para evitar bloquear nuevos lanzamientos, es posible aplicar el siguiente paso a paso hasta que se realice la corrección definitiva en una futura versión del SDK iOS:

1. Abrir archivo Podfile;

2. Insertar las siguientes líneas después del comando post_install do |installer| y antes del último end:

   Copiar

   bitcode_strip_path = `xcrun --find bitcode_strip`.chop!
     def strip_bitcode_from_framework(bitcode_strip_path, framework_relative_path)
       framework_path = File.join(Dir.pwd, framework_relative_path)
       command = "#{bitcode_strip_path} #{framework_path} -r -o #{framework_path}"
       puts "Stripping bitcode: #{command}"
       system(command)
     end
   
     framework_paths = [
       "Pods/unicocheck-ios/DeviceProfiling.xcframework/ios-arm64/DeviceProfiling.framework/DeviceProfiling",
       "Pods/unicocheck-ios/UnicoSdkLogger.xcframework/ios-arm64/UnicoSdkLogger.framework/UnicoSdkLogger"
     ]
   
     framework_paths.each do |framework_relative_path|
       strip_bitcode_from_framework(bitcode_strip_path, framework_relative_path)
     end

   2.1. En caso de que ya exista algún código, insertarlo antes del fragmento existente;

   2.2. En caso de que ya se elimine el bitcode manualmente, agregar las rutas explícitamente mencionadas en framework_paths;

3. Si no existe el comando post_install do |installer| en el archivo Podfile, insertarlo de la siguiente manera antes del último end:

   Copiar

   post_install do |installer|
   bitcode_strip_path = `xcrun --find bitcode_strip`.chop!
     def strip_bitcode_from_framework(bitcode_strip_path, framework_relative_path)
       framework_path = File.join(Dir.pwd, framework_relative_path)
       command = "#{bitcode_strip_path} #{framework_path} -r -o #{framework_path}"
       puts "Stripping bitcode: #{command}"
       system(command)
     end
   
     framework_paths = [
       "Pods/unicocheck-ios/DeviceProfiling.xcframework/ios-arm64/DeviceProfiling.framework/DeviceProfiling",
       "Pods/unicocheck-ios/UnicoSdkLogger.xcframework/ios-arm64/UnicoSdkLogger.framework/UnicoSdkLogger"
     ]
   
     framework_paths.each do |framework_relative_path|
       strip_bitcode_from_framework(bitcode_strip_path, framework_relative_path)
     end

Fuente: Bitrise, Xcode 16 release notes, Stackoverflow.

¿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.