Skip to main content
Esta sessão documenta a integração de liveness usando o motor IDENTY Face AI diretamente, distribuído pela Valid através do LivenessIdentySDK — um SDK que embute o IDENTY Face AI SDK e orquestra a sessão biométrica fim-a-fim contra o backend da Plataforma ID.

Quando usar essa rota

A Plataforma ID oferece duas formas de integrar liveness: Se você não tem um requisito específico que demande o motor IDENTY, prefira o Liveness Hub (também disponível para iOS).

Plataformas suportadas

O LivenessIdentySDK está disponível para Android, iOS e Web.

Como funciona

O LivenessIdentySDK expõe uma fachada minimalista que, internamente:
  1. Inicializa o IDENTY Face AI SDK com os parâmetros fornecidos pelo consumer.
  2. Coleta a assinatura de dispositivo da Shield (Cashshield), usada pelo seu backend na criação da sessão.
  3. Abre a UI nativa do IDENTY Face AI e captura o face scan.
  4. Submete o resultado ao backend de forma segura.
  5. Emite o resultado consolidado para a aplicação.
Você não precisa lidar manualmente com a submissão do resultado — essa orquestração está dentro do SDK. A criação da sessão (obter o sessionToken junto ao seu backend) continua sendo responsabilidade do seu app — veja Serviço. No Web, o SDK pede a sessão chamando o callback onInit que você implementa, já repassando o ssid da Shield — veja Implementação Web.

Próximos passos

Android

Instalação

Adicione o binário e configure o seu projeto

Implementação

Inicialize o SDK e dispare uma verificação de vivacidade

Customização

Personalize a aparência da UI do IDENTY Face AI

Solução de problemas

Erros comuns, mapeamento de exceções e dicas de ProGuard

iOS

Instalação

Adicione o XCFramework e configure o Xcode

Implementação

Inicialize o SDK e dispare uma verificação de vivacidade

Customização

Veja o estado atual das opções de personalização de UI

Solução de problemas

Erros comuns, re-assinatura de frameworks e limitação do simulador

Web

Instalação

Carregue o SDK via CDN e autorize as suas origens

Implementação

Crie a sessão e dispare uma verificação com run()

Customização

Idioma, segurança, captura e visual da tela

Solução de problemas

Erros, motivos de reprovação e CSP