Verificando Liveness e Biometria facial

Se o SDK for usado 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 o Oz API e retorna a resposta da análise.

Não execute a análise diretamente do SDK móvel. No fluxo de integração com SDK incorporado, a chamada de análise deve passar pelo seu próprio backend.

O código abaixo é ilustrativo – YourBackend.uploadOzContainer é execute parte do Oz SDK. Implemente esse método você mesmo no cliente do seu próprio backend; o Oz SDK não fornece um auxiliar de upload para este caminho de integração.

func handleContainer(_ container: DataContainer) {
    YourBackend.uploadOzContainer(
        container,
        contentType: "application/octet-stream"
    ) { result in
        DispatchQueue.main.async {
            self.handleAnalysisResult(result)
        }
    }
}

Seu backend envia o contêiner para o Oz API em uma única POST solicitação síncrona, 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 Capturando 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 os addContainer(container) e run métodos.

func onResult(container: DataContainer) {
  let analysisRequest = AnalysisRequestBuilder()
  analysisRequest.addContainer(container)
  analysisRequest.run(
            statusHandler: { status in
            },
            errorHandler: { error in
            }
        ) { result in
        }
}

SDK 8.21 e anteriores

Para verificar liveness e biometria facial, é necessário enviar mídia para o nosso sistema e depois analisá-la.

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

Abaixo, você verá o exemplo de execução de uma verificação e sua descrição.

let analysisRequest = AnalysisRequestBuilder()
// crie uma ou mais análises
let analysis = Analysis.init(
	media: mediaToAnalyze, // mediaToAnalyze é um array de OzMedia que foram capturados ou criados de outra forma
	type: .quality, // verifique os tipos de análise nos métodos iOS
	mode: .serverBased) // ou .onDevice se você quiser a análise no dispositivo
analysisRequest.uploadMedia(mediaToAnalyze)
analysisRequest.addAnalysis(analysis)
// inicie as análises
analysisRequest.run(
	statusHandler: { state in }, // manipulador de progresso das etapas do cenário
	errorHandler: { _ in }  
) { result in
    // receba e trate os resultados das análises aqui 
}

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

Adicionando metadados

Para adicionar metadados a uma pasta, use AnalysisRequest.addFolderMeta.

let analysis = Analysis.init(media: mediaToAnalyze, type: .quality, mode: .serverBased)
var folderMeta: [String: Any] = ["key1": "value1"]
analysisRequest.addFolderMeta(folderMeta)
...

Extraindo a melhor imagem

No campo params da estrutura Analysis, você pode passar quaisquer parâmetros adicionais (chave + valor), por exemplo, para extrair a melhor imagem no lado do servidor.

let analysis = Analysis.init(media: mediaToAnalyze, type: .quality, mode: .serverBased, params: [“extract_best_shot” : true])

Usando mídia de outro SDK

Para usar um arquivo de mídia capturado com outro SDK (não Oz iOS SDK), especifique o caminho para ele na estrutura OzMedia (a bestShotURL propriedade):

let referenceMedia = OZMedia.init(movement: .selfie,
                  mediaType: .movement,
                  metaData: ["meta":"data"],
                  videoURL: nil,
                  bestShotURL: imageUrl,
                  preferredMediaURL: nil,
                  timestamp: Date())

Adicionando mídia a uma pasta específica

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

let analysis = Analysis.init(media: mediaToAnalyze, type: .quality, mode: .serverBased)
analysisRequest.addFolderId(IdRequired)