biovida_face_liveness

AWS Rekognition Face Liveness para apps Flutter criados no FlutterFlow.

Os plugins Flutter existentes para Face Liveness exigem duas modificações nativas que o build em nuvem do FlutterFlow não permite:

1. amplifyconfiguration.json dentro de android/app/src/main/res/raw/;
2. MainActivity estendendo FlutterFragmentActivity.

Este pacote elimina as duas exigências:

• o componente oficial Amplify UI Face Liveness roda numa Activity própria do plugin (ComponentActivity), declarada no manifest do plugin e mesclada automaticamente no app — o MainActivity gerado pelo FlutterFlow fica intocado;
• as credenciais AWS temporárias são obtidas em runtime como identidade de convidado do Cognito Identity Pool informado na chamada (GetId + GetCredentialsForIdentity via REST, chamadas não assinadas) — nenhum arquivo de configuração nativo é necessário.

Uso

import 'package:biovida_face_liveness/biovida_face_liveness.dart';

final resultado = await BiovidaFaceLiveness.start(
  sessionId: providerSessionId, // CreateFaceLivenessSession (via seu backend)
  region: 'sa-east-1',
  identityPoolId: 'sa-east-1:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
);

if (resultado == 'OK') {
  // Desafio concluído — consulte o veredito no seu backend.
}

Códigos de retorno

Requisitos (Android)

• minSdkVersion 24 e compileSdkVersion 35 — no FlutterFlow, ajuste via Custom Code → Configuration Files → build.gradle.
• Permissão de câmera (o plugin declara CAMERA no próprio manifest; a Activity pede a permissão em runtime se necessário).
• Orientação retrato (o componente da AWS recusa paisagem; a Activity do plugin já é travada em retrato).

O Identity Pool precisa permitir identidades não autenticadas (guest) e a role associada precisa da permissão rekognition:StartFaceLivenessSession.

Requisitos (iOS)

• iOS 14.0+ (fallback web: 14.3+, primeiro iOS com getUserMedia em WKWebView) e NSCameraUsageDescription no Info.plist (no FlutterFlow, a mensagem de permissão de câmera das Permissions do projeto).
• Builds CocoaPods (caso do FlutterFlow): o Amplify Swift v2 e o componente de liveness nativo são distribuídos somente via Swift Package Manager e não podem ser resolvidos por CocoaPods. Nesse modo o desafio roda como fallback web: passe iosWebFallbackUrl apontando para uma página com o componente React oficial FaceLivenessDetector (hospedada pelo seu backend) e o plugin a abre num WKWebView full-screen com botão de fechar. Sem a URL, start responde NAO_SUPORTADO — o build nunca quebra.
• Builds com SPM do Flutter habilitado (flutter config --enable-swift-package-manager): a implementação nativa em ios/biovida_face_liveness/Package.swift é resolvida automaticamente (sem passo manual no Xcode) e iosWebFallbackUrl é ignorada.

Contrato da página de fallback web

1. O plugin abre iosWebFallbackUrl anexando ?sessionId=...&region=... (o sessionId é o provider_session_id da AWS).

2. A página monta o FaceLivenessDetector do @aws-amplify/ui-react-liveness com esses parâmetros (o Identity Pool fica na configuração Amplify do bundle da própria página).

3. Ao terminar, a página reporta o resultado ao app:

   window.webkit.messageHandlers.biovidaFaceLiveness.postMessage('OK');
   // ou um código de erro: 'CANCELADO', 'SESSAO_EXPIRADA',
   // 'SESSAO_NAO_ENCONTRADA', 'PERMISSAO_CAMERA_NEGADA', 'ACESSO_NEGADO',
   // 'ERRO_CONEXAO', 'ERRO'
   

   (onAnalysisComplete → 'OK'; onError/cancelamento → código correspondente. Códigos fora da lista são normalizados para 'ERRO'.)

Plataformas

Créditos

Interface e mapeamento de erros inspirados no plugin comunitário face_liveness_detector; implementação reescrita para funcionar em builds FlutterFlow.