Verify¶
Efetua uma verificação biométrica com um ou mais áudios do mesmo locutor.
rpc Verify(stream VerifyRequest) returns (stream VerifyResponse);
A função permite retornar vários resultados de verificação, o que ocorre quando o modo de operação é MULTI
ou CONTINUOUS
. Se o modo for SINGLE
, o resultado é retornado apenas depois que todo áudio foi transmitido pela aplicação.
Nos modos SINGLE
e MULTI
, a função pode receber até 5 minutos de áudio (300.000 ms) ou 2 minutos de fala (120.000 ms), o que ocorrer primeiro. Se esse limite for ultrapassado, a função retorna um erro. No modo CONTINUOUS
, não existe limite na quantidade máxima de áudio.
A função permite efetuar a verificação com vários usuários, caso em que o áudio de entrada será comparado com o voiceprint de todos os usuários fornecidos, e resultados individuais serão retornados. Erros específicos dos usuários são reportados no campo error do resultado para o usuário correspondente e a função em si continua retornando sucesso. A função retornará erro apenas em caso de falhas gerais, como problemas com o áudio, parâmetros inválidos ou indisponibilidade do sistema.
Não é permitido misturar áudios PCM Linear com áudios contendo cabeçalho.
A requisição desta função é um stream de objetos. Cada requisição é uma mensagem VerifyRequest
e possui os seguintes campos (apenas um deles pode estar presente):
- params
VerificationParams - Parâmetros de entrada da verificação biométrica. Este campo deve estar presente apenas na primeira requisição.
- payload
AudioPayload - Áudio a ser utilizado na verificação biométrica. Este campo pode ser fornecido depois da primeira requisição.
A resposta desta função é um stream de objetos. Cada resposta é uma mensagem VerifyResponse
e possui os seguintes campos:
- events
repeated
VerificationEvent - Lista de objetos representando os eventos retornados pela verificação biométrica.