Verificando Liveness e Biometria facial

Se você usar nosso SDK apenas para capturar vídeos, omita esta etapa.

OzCapsula (SDK v8.22 e mais recentes)

Envie o contêiner criptografado para o seu próprio backend como bytes brutos (application/octet-stream). Seu backend o encaminha para a Oz API e retorna a resposta da análise.

Faça não execute a análise diretamente a partir do mobile SDK. No fluxo de integração com embedded-SDK, a chamada de análise deve passar pelo seu próprio backend.

O código abaixo é ilustrativo – YourBackend.uploadOzContainer(...) é não parte do Oz SDK. Você implementa este método por conta própria no cliente do seu próprio backend; o Oz SDK não fornece um auxiliar de upload para este caminho de integração.

private fun handleContainer(container: DataContainer?) {
    if (container == null) return

    YourBackend.uploadOzContainer(
        container = container.getBytes(),
        contentType = "application/octet-stream"
    )
}

Seu backend envia o contêiner para a Oz API em uma única solicitação síncrona POST como mostrado aqui.

Forma legada: o run método (interação direta SDK ↔ API). Aviso: este método é menos seguro do que usar seu backend como intermediário, conforme descrito acima.

Na Captura de vídeos etapa, você criou um contêiner de dados com todas as informações necessárias nele, então agora basta enviá-lo para análise usando as addContainer(container) e run métodos.

Kotlin

private fun runAnalysis(container: DataContainer?) {
    if (container == null) return
    AnalysisRequest.Builder()
        .addContainer(container)
        .build()
        .run(
            { result ->
                val isSuccess = result.analysisResults.all { it.resolution == Resolution.SUCCESS }
            },
            { /* mostrar erro */ },
            { /* atualizar status */ },
        )
}

SDK 8.21 e versões anteriores

Para verificar Liveness e BIOMETRY facial, você precisa enviar a mídia para o nosso sistema e depois analisá-la.

Para interpretar os resultados das análises, consulte Tipos de Análises.

Aqui está um exemplo de execução de uma verificação:

Kotlin

analysisCancelable = AnalysisRequest.Builder()
 // mediaToAnalyze é um array de OzAbstractMedia que foram capturados ou criados de outra forma 
    .addAnalysis(Analysis(Analysis.Type.QUALITY, Analysis.Mode.SERVER_BASED, mediaToAnalyze))// ou ON_DEVICE se você quiser a análise no dispositivo
    .build()
//iniciando as análises e configurando um listener
    .run(object : AnalysisRequest.AnalysisListener {
        override fun onStatusChange(status: AnalysisRequest.AnalysisStatus) { handleStatus(status) // ou seu manipulador de status
        }
        override fun onSuccess(result: RequestResult) {
            handleResults(result) // ou seu manipulador de resultados
        }
        override fun onError(error: OzException) { handleError(error) // ou seu manipulador de erros 
        }
    })

Java

analysisCancelable = new AnalysisRequest.Builder()
// mediaToAnalyze é um array de OzAbstractMedia que foram capturados ou criados de outra forma 
        .addAnalysis(new Analysis(Analysis.Type.QUALITY, Analysis.Mode.SERVER_BASED, mediaToAnalyze)) // ou ON_DEVICE se você quiser a análise no dispositivo
        .build()
//iniciando as análises e configurando um listener
        .run(new AnalysisRequest.AnalysisListener() { 
            @Override
            public void onSuccess(@NonNull RequestResult list) { handleResults(list); } // ou seu manipulador de resultados
            @Override
            public void onError(@NonNull OzException e) { handleError(e); } // ou seu manipulador de erros
            @Override
            public void onStatusChange(@NonNull AnalysisRequest.AnalysisStatus analysisStatus) { handleStatus(analysisStatus); } // ou seu manipulador de status
        })

Para excluir arquivos de mídia após a conclusão das verificações, use o clearActionVideos método.

Adicionando metadados

Para adicionar metadados a uma pasta, use o addFolderMeta método.

Kotlin

    .addFolderMeta(
        mapOf(
            "key1" to "value1",
            "key2" to "value2"
        )
    )

Java

.addFolderMeta(Collections.singletonMap("key", "value")) 

Extraindo a melhor foto

No campo params da Analysis structure, você pode passar quaisquer parâmetros adicionais (key + value), por exemplo, para extrair a melhor foto no lado do servidor.

mapOf("extract_best_shot" to true)

Usando mídia de outro SDK

Para usar um arquivo de mídia capturado com outro SDK (não Oz Android SDK), especifique o caminho para ele em OzAbstractMedia:

       val file = File(context.filesDir, "media.mp4") // use context.getExternalFilesDir(null) instead of context.filesDir for external app storage
       val media = OzAbsractMedia.OzVideo(OzMediaTag.VideoSelfieSmile, file.absolutePath)

Adicionando mídia a uma determinada pasta

Se você quiser adicionar sua mídia à pasta existente, use o setFolderId método:

    .setFolderId(folderId)