Pular para o conteúdo principal

Jornadas do Usuário

Markdown

As Jornadas do Usuário são sessões de captura em múltiplas etapas orquestradas pelo SDK em conjunto com o fluxo configurado. Por exemplo, um fluxo com Prova de Vida + Score de Risco + Captura de Documentos + Assinatura Eletrônica executa selfie, captura de documento e assinatura em uma única sessão.

Produtos

As jornadas disponíveis dependem do fluxo configurado para a sua integração. Consulte Produtos para o mapeamento completo de produto → fluxo → capacidade.

Como funciona

O SDK:

  1. Lê a configuração de fluxo fornecida durante a inicialização.
  2. Orquestra a sequência de capturas necessárias para o fluxo (selfie, documento, assinatura).
  3. Retorna um processId via onSuccess quando o journey é concluído.

A orquestração é tratada inteiramente pelo SDK — você não precisa implementar a sequência de etapas no seu app.

Iniciando uma Jornada do Usuário
Passo 1 — Implementar AcessoBioManagerDelegate

AcessoBioManagerDelegate trata os callbacks de ciclo de vida do SDK. Implemente os quatro métodos obrigatórios:

MétodoQuando é chamado
onErrorAcessoBioManager(error)Ocorreu um erro durante a operação do SDK
onUserClosedCameraManually()O usuário fechou a câmera manualmente
onSystemClosedCameraTimeoutSession()O limite de 40 segundos da sessão foi atingido
onSystemChangedTypeCameraTimeoutFaceInference()Nenhum rosto detectado por 13 segundos — muda para captura manual
class ViewController: UIViewController, AcessoBioManagerDelegate {
var unicoCheck: AcessoBioManager!

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

func onErrorAcessoBioManager(_ error: ErrorBio!) { }
func onUserClosedCameraManually() { }
func onSystemClosedCameraTimeoutSession() { }
func onSystemChangedTypeCameraTimeoutFaceInference() { }
}
Métodos de delegate obrigatórios

Todos os quatro métodos de delegate acima devem ser criados no seu projeto (mesmo sem lógica alguma). Caso contrário, o projeto não compilará com sucesso.

Passo 2 — Implemente AcessoBioSelfieDelegate

Sobrescreva os métodos para tratar os callbacks de resultado da captura da jornada:

MétodoDescrição
onSuccessSelfie(result)Exigido pela interface de delegate; não utilizado em uma integração com a Unico API
onSuccess(result)Exigido em uma integração com a Unico API. Journey concluído com sucesso — retorna um processId utilizado para consultar os resultados de validação
onErrorSelfie(errorBio)Captura falhou — retorna um ErrorBio com detalhes do erro
class ViewController: UIViewController, AcessoBioManagerDelegate,
SelfieCameraDelegate, AcessoBioSelfieDelegate {

func onSuccessSelfie(_ result: SelfieResult!) { }
func onSuccess(_ result: SuccessResult!) { }
func onErrorSelfie(_ errorBio: ErrorBio!) { }
}
onSuccess é obrigatório

A câmera abre com um webAppToken, então o SDK exige onSuccess: sem ele, falha com o erro 74001. AcessoBioSelfieDelegate declara onSuccess como opcional, então o compilador não verifica isso, e uma assinatura que não corresponda ao exemplo acima compila e falha da mesma forma. Copie a assinatura exatamente como mostrado.

Passo 3 — Chame prepareSelfieCamera e open

Chame prepareSelfieCamera passando a configuração do SDK. Quando a câmera estiver pronta, o evento onCameraReady é disparado — abra a câmera pelo método open(), passando o webAppToken:

webAppToken

O webAppToken é o campo process.webAppToken retornado por POST /client/v1/process ao criar o processo no seu backend. Consulte Criar Processo.

  • onCameraReady(cameraOpener) — câmera pronta; chame open(self, webAppToken:).
  • onCameraFailed(message) — falha na preparação da câmera (ErrorPrepare é uma extensão de ErrorBio).
@IBAction func openCamera(_ sender: Any) {
unicoCheck.build().prepareSelfieCamera(self, config: YourUnicoConfigClass())
}

func onCameraReady(_ cameraOpener: AcessoBioCameraOpenerDelegate!) {
cameraOpener.open(self, webAppToken: "your_web_app_token")
}

func onCameraFailed(_ message: ErrorPrepare!) { }

Para o tratamento completo do resultado, consulte Recebendo o resultado.