Como adicionar correspondência facial do vídeo de Liveness com uma foto de referência do seu banco de dados

Observe: este guia se aplica somente ao fluxo sem container.

Este guia descreve como associar um vídeo de Liveness a uma foto de referência de uma pessoa que já está armazenada em seu banco de dados.

No entanto, se você preferir incluir uma etapa de captura de foto de documento de identidade em seu processo de Liveness em vez de usar uma foto armazenada, então você pode consultar outro guia nesta seção.

Até este ponto, você já deve ter implementado a gravação de vídeo de Liveness e a verificação de Liveness. Se não, consulte estes guias:

• Integração do Oz Liveness Web SDK

• Integração do Oz Liveness Mobile SDK

Neste cenário, carregue sua imagem de referência para a mesma pasta onde você tem um vídeo de Liveness, inicie a análise BIOMETRY e consulte os resultados.

1. Obtenha folder_id

Como você já tem o vídeo de Liveness gravado e enviado, você trabalhará com a mesma pasta do Oz API onde está o seu vídeo de Liveness. Obtenha o ID da pasta conforme descrito abaixo e passe-o ao seu back-end.

• Para um vídeo gravado pelo Web SDK, obtenha o folder_id conforme descrito aqui.

• Para um vídeo gravado pelo Android ou iOS SDK, recupere o folder_id dos resultados da análise, conforme mostrado abaixo:

Android:

Kotlin

AnalysisRequest.Builder()
        ...
        .run(object : AnalysisRequest.AnalysisListener {
            override fun onSuccess(result: List<OzAnalysisResult>) {
                // salve o folder_id necessário para a próxima etapa
                val folderId = result.firstOrNull()?.folderId
            }
            ...
        })

Java

private void analyzeMedia(List<OzAbstractMedia> mediaList) {
    new AnalysisRequest.Builder()
            ...
            .run(new AnalysisRequest.AnalysisListener() {
                @Override public void onStatusChange(@NonNull AnalysisRequest.AnalysisStatus analysisStatus) {}
                @Override
                public void onSuccess(@NonNull List<OzAnalysisResult> list) {
                    String folderId = list.get(0).getFolderId();
                    }
                }
                ...
    });
}

iOS:

analysisRequest.run(
scenarioStateHandler: { state in }, 
uploadProgressHandler: { (progress) in }  
)   { (analysisResults : [OzAnalysisResult], error) in 
        // salve o folder_id necessário para a próxima etapa
        let folderID = analysisResults.first?.folderID
    }
}

2. Faça o upload da sua foto de referência

Chame POST /api/folders/{{folder_id}}/media/ método, substituindo o folder_id pelo ID que você obteve na etapa anterior. Isso fará o upload da sua nova mídia para a pasta onde está localizado o seu vídeo de Liveness pronto.

Defina as tags apropriadas no campo payload da solicitação, dependendo da natureza da foto de referência que você tiver.

{
  "media:tags": { 
    "photo1": [
        "photo_id", "photo_id_front" // para o lado frontal de um documento de identidade
        // OU
        "photo_selfie" // para uma foto sem documento de identidade
    ]
  }
}

3. Inicie a análise

Para iniciar a análise, chame POST /api/folders/{{folder_id}}/analyses/ com o folder_id da etapa anterior. No corpo da solicitação, especifique a verificação de biometria a ser iniciada.

{
    "analyses": [
        {
            "type": "biometry"
        }
    ]
}

4. Consulte os resultados

Repita chamando GET /api/analyses/{{analysis_id}} com o analysis_id da etapa anterior uma vez por segundo até que o estado mude de PROCESSING para algo diferente. Para uma análise concluída:

• obtenha o resultado qualitativo da resolução (SUCCESS ou DECLINED).

• obtenha os resultados quantitativos de analyses.results_data.min_confidence

Aqui está a COLLECTION do Postman para este guia.

Face Matching with a Reference Photo.postman_collection.json

6KB

Abrir

Com essas etapas concluídas, você terminou de adicionar a correspondência facial via Oz API. Você poderá acessar sua mídia e os resultados da análise na Web UI pelo navegador ou de forma programática via API.

Os métodos do Oz API podem ser combinados com grande flexibilidade. Explore o Oz API usando o Guia do Desenvolvedor da API.