For the complete documentation index, see llms.txt. This page is also available as Markdown.

Notas de versão

v7.8.0

Distribuído em CafSDKiOS 7.8.0.

Versionamento

  • A partir desta versão, a versão do CafFaceLivenessLite corresponde à versão do CafSDKiOS. A versão Lite anterior era 3.1.0.

Novos recursos

  • getVersion(): novo método estático CafFaceLivenessLiteSDK.getVersion() retorna a versão do SDK como uma String (por exemplo "7.8.0"). Não precisa de instância nem de setup. Veja Iniciando o fluxo de Liveness.

Melhorias

  • Resultado entregue antes de a tela de captura ser fechada: didFinishWithSuccess, didFinishWithFailure, didFinishWithError e cancelled() são entregues enquanto a tela de captura ainda está visível.

  • Roteamento regional: o SDK envia suas solicitações para a região definida no seu token. A região é definida no servidor quando o token é emitido; se o token não tiver nenhuma, é usado o padrão do ambiente. Não são necessárias alterações na integração.

Distribuição

  • CocoaPods: pod 'CafSDKiOS/CafFaceLivenessLite', '7.8.0'

  • Repositório CAF (novo): o xcframework, o podspec, Package.swift e o checksum SHA256 são publicados em https://repo.combateafraude.com/ios/release/CafFaceLivenessLite/7.8.0/, assim como para Android. Veja Instalação.


v3.1.0

Distribuído em CafSDKiOS 7.7.0.

Melhorias

  • Resultado entregue assim que a captura termina: didFinishWithSuccess / didFinishWithFailure agora são disparados no momento em que a captura é concluída, sem ida e volta à rede no meio.

Atualizações

  • Mapeamento de erros: uma sessão rejeitada porque a conta não está habilitada para o fluxo assíncrono agora reporta didFinishWithError(type: .tokenException, description:). Uma sessão que chega sem os dados necessários para concluir o fluxo reporta .tokenException ou .invalidResponseException. Veja Referência de Resultados.

Distribuição

  • CocoaPods: pod 'CafSDKiOS/CafFaceLivenessLite', '7.7.0'


v3.0.0

Distribuído em CafSDKiOS 7.6.0.

Mudanças que quebram compatibilidade

  • startSDK dividida em setup + startSDK: a configuração não acompanha mais a chamada de início. Chame setup(...) uma vez com suas credenciais e opções, depois startSDK(viewController:) para apresentar a tela de captura. A anterior startSDK(viewController:mobileToken:personId:…) sobrecarga foi removida, não descontinuada — chamadas existentes não vão compilar.

  • startSDK antes de setup é um erro: chamar startSDK(viewController:) sem uma setup(...) reporta didFinishWithError(type: .invalidOptionsException, description:) e não abre uma sessão.

Migração

Todo argumento do antigo startSDK exceto viewController: passa para setup(...), com os mesmos rótulos, tipos e padrões.

Adotar setup sozinho já é suficiente para migrar: se você nunca chamar prewarm(), o fluxo se comporta exatamente como em 2.1.0.

Novos recursos

  • Pré-aquecimento da sessão: novo opcional prewarm() método que executa a solicitação da sessão com antecedência — por exemplo, enquanto o usuário lê uma tela de instruções — para que startSDK possa abrir a câmera sem esperar pela rede. A sessão pré-aquecida é válida por 90 segundos e é consumida pela próxima startSDK. Se estiver ausente, desatualizada ou tiver sido criada com credenciais diferentes, startSDK retorna silenciosamente ao fluxo regular, então o pré-aquecimento nunca pode interromper uma captura.

Distribuição

  • CocoaPods: pod 'CafSDKiOS/CafFaceLivenessLite', '7.6.0'


v2.1.0

Distribuído em CafSDKiOS 7.5.0.

Novos recursos

  • Personalização da interface: novo opcional uiCustomization: CerttaUiCustomization? parâmetro em startSDK para personalizar a tela de liveness — barra superior (título, cores, botão de fechar, logotipo), prompt de orientação (cores, cantos arredondados), área ao redor do oval do rosto (cor, desfoque) e fonte. Totalmente opcional e compatível com versões anteriores: omiti-lo, ou deixar campos individuais nil, mantém a aparência atual. Veja Personalização da interface.

Distribuição

  • CocoaPods: pod 'CafSDKiOS/CafFaceLivenessLite', '7.5.0'


v2.0.2

Distribuído em CafSDKiOS 7.4.1.

Melhorias

  • Análises: Melhorando a observabilidade e a resolução de problemas.

Atualizações

  • Dependência do iProov atualizada para 13.2.0.

  • Mudança do iProov SP: O SDK agora segue o iProov SP fornecido pelo backend. Alteração no servidor — não são necessárias mudanças na integração.

Distribuição

  • CocoaPods: pod 'CafSDKiOS/CafFaceLivenessLite', '7.4.1'


v2.0.1

Distribuído em CafSDKiOS 7.3.2.

Correções de bugs

  • cancelled() tempo de entrega: CafFaceLivenessLiteDelegate.cancelled() agora é entregue somente depois que o view controller da câmera do iProov termina de ser dispensado.

Distribuição

  • CocoaPods: pod 'CafSDKiOS/CafFaceLivenessLite', '7.3.2'


v2.0.0

Distribuído em CafSDKiOS 7.3.1.

Mudanças que quebram compatibilidade

  • Início de transação somente assíncrona: Após a captura, o SDK agora chama a rota assíncrona. A resposta contém apenas um opaco signedResponse JWT. O resultado final de liveness (isAlive, imagens) deve ser recuperado pelo seu backend fora de banda — o SDK não faz polling.

  • executeFaceAuth removido: Face Auth não é mais suportado por CafFaceLivenessLite. Chamadas que passam executeFaceAuth não compilarão. Use os produtos completos Face Liveness / Face Auth se precisar desse fluxo.

Migração

Novos recursos

  • customLocalizationBundle: Opcional Bundle? parâmetro em startSDK que mapeia para o iProov options.stringsBundle. Use-o junto com customLocalization (nome da tabela de strings) quando seu Localizable.strings estiverem em um framework ou bundle hospedeiro diferente do bundle principal do app — por exemplo Bundle(for: CafFaceLivenessLiteSDK.self).

Distribuição

  • CocoaPods: pod 'CafSDKiOS/CafFaceLivenessLite', '7.3.1'


v1.2.1

Novos recursos

  • Monitoramento de segurança: Adicionado enableSecurity: Bool = true parâmetro do construtor para CafFaceLivenessLiteSDK. Quando habilitado, o SDK realiza detecção de jailbreak, monitoramento de dylib e detecção de instrumentação. Desative apenas em ambientes de teste automatizado.

  • Novos tipos de erro: Adicionados quatro novos casos a CafErrorType:

    • cameraException: Erro de hardware da câmera

    • certificateException: Falha na validação do certificado

    • invalidOptionsException: Opções de configuração do SDK inválidas fornecidas

    • securityException: Violação de segurança detectada (gerada quando enableSecurity: true e instrumentação ou hooking é detectado)

Distribuição

  • CocoaPods: pod 'CafSDKiOS/CafFaceLivenessLite', '6.4.2'


v1.2.0

Atualizações

  • Versão mínima de iOS suportada atualizada para 15.0+.

  • Dependência do iProov atualizada para 13.1.0.

  • Novas opções de falha: Adicionados novos casos de falha a CafFailureType: eyewear, faceNotFound, framesBlurry, lightingIssues, motionIssue, backgroundIssue, deviceIssue, deviceRestart, systemError, rejected, timeout, userNotFound, processingFault.

Aviso importante


v1.1.0

Novos recursos

  • Tratamento de erros da autenticação facial: Adicionado um novo faceAuthentication caso a CafErrorType para tratar especificamente erros do backend quando executeFaceAuth está habilitado.


v1.0.0

Lançamento inicial do SDK leve de face liveness.

Destaques

  • Menor tamanho com integração simplificada

  • Ciclo de vida baseado em delegate com callbacks de sucesso, falha e erro

  • Execução opcional do FaceAuth após o liveness

  • Substituição básica de localização via customLocalization

Atualizado