Regras de atribuição de análises

Este artigo aborda as regras padrão de aplicação de análises.

As análises no sistema Oz podem ser aplicadas de duas maneiras:

• manualmente, por exemplo, quando se escolhe o cenário Liveness em nossa aplicação de demonstração;

• automaticamente, quando não se escolhe nada e apenas se atribuem todas as análises possíveis (via API ou SDK).

A atribuição automática significa que o sistema Oz decide por si mesmo quais análises aplicar aos arquivos de mídia com base em seu tags e tipo. Se arquivos forem enviados pela console da web, selecione as tags necessárias; se a foto ou o vídeo forem capturados via Web SDK, o SDK escolhe as tags automaticamente. Quanto ao tipo de mídia, ele pode ser IMAGE (uma foto)/VIDEO/SHOTS_SET, onde SHOTS_SET é um arquivo .zip equivalente a vídeo.

A seguir, encontram-se as tags e os requisitos de tipo para todas as análises. Se uma mídia não corresponder aos requisitos da análise específica, essa mídia será ignorada pelos algoritmos.

As regras listadas abaixo atuam por padrão. Para alterar a configuração de mapeamento, consulte entre em contato conosco.

QUALITY (Liveness)

Esta análise é aplicada a todas as mídias, independentemente do gesto gravado (as tags de gesto começam em video_selfie).

Importante: para processar uma foto na API 4.0.8 e anteriores, compacte-a em um arquivo .zip, aplique a SHOTS_SET tipo e marque-a com video_*. Caso contrário, ela será ignorada.

Biometria

Esta análise é aplicada a todas as mídias.

Se a pasta contiver menos de dois arquivos de mídia correspondentes, o sistema retornará um erro. Se houver mais de dois arquivos, todos os pares serão comparados, e o sistema retornará um resultado para o par com faces menos semelhantes.

COLLECTION

Esta análise funciona somente quando se tem um banco de dados de imagens pré-criado, chamado COLLECTION. A análise é aplicada a todas as mídias na pasta (ou às marcadas como mídia de origem).

Best Shot

Best Shot é um complemento da análise QUALITY (Liveness). Requer a opção apropriada ativada. A análise é aplicada a todos os arquivos de mídia que podem ser processados pela análise QUALITY.

DOCUMENTS

Este tipo de análise está obsoleto.

A análise DOCUMENTS é aplicada a imagens com tags photo_id_front e photo_id_back (documents), e photo_selfie (selfie). O resultado será positivo se o sistema encontrar a foto de selfie e a corresponder a uma foto em um dos documentos válidos da lista a seguir:

• carteira de identidade

• carteira de motorista

• passaporte estrangeiro

Erros relacionados a tags

Código	Mensagem	Descrição
202	Não foi possível localizar o rosto na mídia de origem [media_id]	Nenhum rosto foi encontrado na mídia que está sendo processada, ou a mídia de origem possui tag incorreta (photo_id_back) ou tag ausente usada para a mídia.
202	BIOMETRY. A análise requer pelo menos 2 objetos de mídia para processamento	Os algoritmos não encontraram as duas mídias adequadas para análise. Isso pode ocorrer quando apenas uma única mídia é enviada para a análise, ou quando uma mídia está sem uma tag.
202	Erro de processamento - não foram encontrados candidatos a documento na imagem	A análise DOCUMENTS não pode ser concluída porque a foto enviada parece não ser um documento, ou possui tag incorreta (não photo_id_*) ou tags ausentes.
5	Valores de tag inválidos/ausentes para processar a verificação de QUALITY	As tags aplicadas não podem ser processadas pelo algoritmo QUALITY (muito provavelmente, as tags começam com photo_*; para QUALITY, elas devem ser marcadas como video_*)
5	Valores de tag inválidos/ausentes para processar a verificação de COLLECTION	As tags aplicadas não podem ser processadas pelo algoritmo COLLECTION. Isso pode acontecer quando uma mídia está sem uma tag.