Conheça a nossa nova rota MEDICAL RECEIPT para validação automatizada de recibos do Receita Saúde!
Liveness Streaming
Como funciona?
Principais características:
Por que escolher o Liveness Streaming?
Requisitos mínimos para o dispositivo cliente (User-Side Liveness)
Especificações do dispositivo e tela
| Categoria | Requisito Mínimo |
|---|---|
| Câmera | Câmera frontal obrigatória (deve ser colorida). |
| Taxa de atualização (display) | Mínimo de 60 Hz. |
| Tamanho da tela | Mínimo de 4 polegadas. |
| Segurança do SO | O dispositivo não deve estar jail-broken (iOS) ou rooted (Android). |
Especificações da câmera e captura de vídeo
| Categoria | Requisito Mínimo |
|---|---|
| Resolução de gravação | Mínimo de 480x640px. |
| Taxa de quadros (frame rate) | Mínimo de 15 quadros por segundo (fps). |
| Tipo de câmera | Não são suportadas câmeras virtuais ou softwares de câmera simulados. |
| Uso em desktop | Para uso de webcam em desktops, a câmera deve ser montada na parte superior do mesmo monitor onde a checagem é iniciada. |
Especificações de conectividade e software
| Categoria | Requisito Mínimo |
|---|---|
| Largura de banda (bandwidth) | Mínimo de 100 kbps. |
| Navegadores suportados | As três últimas versões dos principais navegadores (Google Chrome, Mozilla Firefox, Apple Safari e Microsoft Edge). |
Sincronização de Relógio (System Clock Offset)
setSystemClockOffset foi introduzido para aumentar a resiliência do processo de prova de vida em dispositivos nos quais o relógio do sistema do usuário final esteja incorreto ou dessincronizado em relação aos servidores de verificação.settings, conforme o exemplo abaixo:"settings": {
"setSystemClockOffset": false
}Descrição do Funcionamento
{
"result": {
"processId": "2de80502-f4fe-4e6b-93ee-53d9474f26ca",
"status": "ERROR",
"statusDescription": "Server and device clocks are out of sync",
"livenessScore": null,
"frontalImage": null
},
"requestId": "Y8XfDzvy5k2KoGLv67C79",
"elapsedMilliseconds": 677,
"status": {
"message": "Ok",
"code": "200",
"errors": null
}
}setSystemClockOffset, o sistema calcula automaticamente a diferença entre o relógio local e o relógio do servidor no início da sessão, ajustando as requisições para que a variação de horário não cause a falha da prova de vida.Parâmetros de Configuração
| Parâmetro | Tipo | Descrição |
|---|---|---|
setSystemClockOffset | Boolean | Define se o sistema deve ignorar variações de horário do dispositivo. |
false (ou parâmetro não enviado): O sistema segue o comportamento tradicional. O horário do dispositivo do usuário é comparado. Se houver divergência considerável, a prova de vida falhará.true: O sistema ignora as variações de horário locais e aplica um "offset" (compensação) baseado no horário do servidor, permitindo que a análise ocorra normalmente mesmo em dispositivos com data/hora configurados incorretamente.Quando utilizar?
true apenas em cenários onde se identifica uma taxa alta de erros técnicos relacionados a "Server and device clocks are out of sync", garantindo uma melhor experiência de usuário (UX) e evitando que o cliente seja barrado por uma configuração errada no próprio dispositivo.Status e mensagens de erro
| Status | statusDescription | Detalhe |
|---|---|---|
| TODO | "Waiting for user interaction" | A prova de vida ainda não foi iniciada ou está em andamento. |
| DOING | "User interaction in progress" | A sessão de prova de vida foi iniciada, ou seja, o usuário clicou em "Iniciar captura" e o processo está em andamento. |
| DONE | "User interaction completed successfully" | A prova de vida foi concluída. Nesse caso, o resultado incluirá valores para os atributos frontalImage e livenessScore, se disponíveis, que devem ser avaliados para a definição do resultado final da prova de vida. |
| EXPIRED | "User did not interact within the time limit" | A sessão de prova de vida expirou. Isso ocorre quando o usuário não conclui a prova de vida dentro do prazo de 3 minutos após clicar em "Iniciar captura". |
| CANCELED | "Canceled after 1 hour of inactivity" | A sessão de prova de vida foi cancelada por não ser concluída dentro do tempo máximo de 1 hora. |
| ERROR | "Camera access error" | Não foi possível acessar a câmera do dispositivo. Verifique se a permissão de uso da câmera está habilitada no navegador ou nas configurações do aparelho. |
| ERROR | "Camera framerate error" | A câmera não está conseguindo capturar imagens com a taxa mínima necessária. |
| ERROR | "Default camera not found" | Nenhuma câmera foi encontrada no dispositivo. Verifique se o equipamento possui câmera disponível e se ela está funcionando corretamente. |
| ERROR | "Liveness session has expired. Please create a new session." | A sessão de verificação expirou. Por favor, inicie uma nova sessão para continuar o processo. |
| ERROR | "Face distance error" | O rosto está muito próximo ou muito distante da câmera. Ajuste a posição do dispositivo até que seu rosto fique bem enquadrado na tela. |
| ERROR | "The security token included in the request is invalid." | O token de segurança da requisição é inválido ou expirou. |
| ERROR | "Server and device clocks are out of sync" | O horário do dispositivo está diferente do horário do servidor. Verifique se a data e hora do aparelho estão configuradas corretamente. |
| ERROR | "Device orientation error" | A orientação do dispositivo está incorreta. Posicione o celular na orientação indicada na tela para continuar. |
| ERROR | "Multiple faces error" | Foram detectados vários rostos na câmera. Certifique-se de que apenas uma pessoa esteja visível no enquadramento. |
| ERROR | "Liveness session has results available. Please get results for the session." | Esta sessão de verificação já possui resultados disponíveis. Utilize a consulta de resultados para obter as informações da sess ão. |
| ERROR | "Unexpected runtime error" | Ocorreu um erro inesperado durante a execução do processo. Tente novamente em alguns instantes. |
| ERROR | "Unexpected server error" | Ocorreu um erro inesperado no servidor. Tente novamente mais tarde. |
| ERROR | "Connection timed out" | O tempo de conexão foi excedido. Verifique sua conexão com a internet e tente novamente. |
Contabilização do consumo
Casos de usos
1.
2.
3.
Cenários de uso:
Onboarding digital em instituições financeiras
Autenticação em transações de alto valor
Autenticação em aplicativos de mobilidade urbana
Acesso a plataformas educacionais
Check-in em eventos ou viagens
Controle de acesso em empresas
Validação de identidade em jogos online e eSports
Verificação de identidade em plataformas de saúde digital
Modified at 2026-03-12 14:02:39