BioTrust.Maui 1.2.0

BioTrust.Maui

Validação biométrica facial para .NET MAUI: prova de vida, validação com documento, FaceMatch e controle de acesso, com a mesma API em todas as plataformas.

Requisitos

Instalação

dotnet add package BioTrust.Maui

Registre o pacote no MauiProgram:

builder.UseBioTrust();

O registro é obrigatório para o uso do BioTrustCameraView.

Android

A permissão de câmera vem declarada pelo SDK. A de internet é da aplicação:

<uses-permission android:name="android.permission.INTERNET" />

iOS

<key>NSCameraUsageDescription</key>
<string>A câmera é utilizada para a validação da sua identidade.</string>

Validação

var config = new ValidationConfig
{
    Uuid = "seu-uuid",
    ApiUrl = "https://api.biotrust.io",
    Mode = ValidationMode.LivenessOnly
};

var resultado = await new BioTrustValidator().ValidateAsync(config);

if (resultado.Cancelled)
{
    // validação cancelada pelo usuário
}
else if (resultado.IsSuccess)
{
    // resultado.VivacityConfidence, resultado.FaceImage
}
else
{
    // resultado.Message
}

ValidateAsync sempre devolve um ValidationResult. Reprovação, erro e cancelamento não lançam exceção. Configuração inválida é devolvida como falha, com o motivo em Message, antes de a câmera abrir.

Modos

A lista completa de parâmetros de ValidationConfig e de campos de ValidationResult está na documentação.

FaceMatch

var manager = new BioTrustFaceMatchManager(config);

var resultado = await manager.AddPersonAsync("Maria Silva", "12345678901", DocumentType.Cpf);

if (resultado.IsSuccess)
{
    // resultado.UniqueId
}

A consulta e a exclusão ficam em BioTrustFaceMatchDirectory (ListPersonsAsync, DeletePersonAsync) e exigem ApiKey e ApiSecret na configuração. Em aplicativos distribuídos em loja, faça essas operações pelo seu backend.

Controle de acesso

Modo terminal, para catracas, portões e portas. A sessão fica de pé sobre uma view do layout e entrega uma decisão por pessoa.

var sessao = new BioTrustAccessControl(new AccessControlConfig
{
    Uuid = "seu-uuid",
    ApiUrl = "https://api.biotrust.io",
    TerminalLabel = "Catraca portaria"
});

sessao.Authorized += quem => AbrirCatraca(quem.Name);
sessao.Revoked += () => FecharCatraca();

await sessao.StartAsync(cameraView);   // BioTrustCameraView no XAML
sessao.PersonPassed();                 // quando o equipamento indicar a passagem

Depois de autorizar, a sessão não autoriza de novo até PersonPassed() ou até a janela de liberação vencer. Enquanto a liberação está de pé, um rosto sem correspondência dispara Revoked; esse comportamento é controlado por RevokeOnMismatch.

O acionamento do equipamento é da aplicação. Disponível em Android e iOS.

Erros

Os métodos não lançam exceção. Configuração inválida, falha de rede e erro do SDK voltam com IsSuccess = false e a descrição em Message. Cancelamento volta com Cancelled = true.

Uma operação com tela por vez: uma segunda chamada com a tela do SDK aberta devolve falha.

Licença

Software proprietário, licenciado para uso com os serviços BioTrust mediante contrato comercial. O texto completo está em docs.biotrust.io/licenca.txt e no arquivo LICENSE deste pacote.

Suporte: cloud@biotrust.io