Registro de alterações

Alterações do Web SDK

2.1.0 – 13 de ago. de 2026

• Atualizado o loader padrão; o código legado foi removido.

• O adapter agora valida o formato de uma solicitação de análise recebida com base no use_wasm_container valor desta solicitação.

• Adicionado um novo evento de telemetria para rastrear inicializações repetidas do plugin: recent_attempt_id no evento de inicialização da sessão.

• A inicialização da sessão não fica mais travada quando a solicitação não recebe resposta: o tempo limite é atingido após 60 segundos e a sessão falha com error_service_unavailable.

• No modo contêiner (use_wasm_container: true), folder.meta_data.http_referer agora contém a URL completa da página em que o SDK é executado.

• Telemetria aprimorada.

• Processos internos refinados.

• Segurança aprimorada.

2.0.0 – 30 de jun. de 2026

Alterações incompatíveis:

• O Correlation-ID cabeçalho agora é enviado por padrão. Permita-o em qualquer proxy/CORS/WAF à frente do adapter, ou as solicitações falharão. allowlist atual: DNT, X-CustomHeader, Keep-Alive, User-Agent, X-Requested-With, If-Modified-Since, Cache-Control, Content-Type, traceparent, tracestate, esid, shield-id, Correlation-ID.

• O modo OzCapsula (use_wasm_container: true) agora requer Oz API 6.6.1 ou mais recente.

• O formato MOV, juntamente com o video_file_format parâmetro, foi removido. Agora oferecemos suporte apenas a zip .

• Adicionado o feature_stateless_adapter modo para implantações com múltiplas instâncias. Nesse modo, não salvamos o estado da sessão no disco; em vez disso, ele é retornado com cada resposta como um objeto blob criptografado.

• A ação de sorriso agora exige a boca fechada antes do início da gravação.

• O adapter não retorna mais erros 500 sob carga.

• O http_referer e ip_address campos agora estão corretos no modo contêiner.

• Corrigidos falsos MASTER_LICENSE_FRAUD_DETECTED erros em plugins carregados em iframe.

• use_wasm_container: true não causa mais uma rejeição falsa durante uma sequência com múltiplas ações.

• O on_result e on_complete callbacks não retornam mais resultados vazios no Safari.

• Erros do adapter agora mostram o pop-up de erro.

• Corrigidas análises que falhavam com "No request data received from plugin" no modo contêiner e com uma faceworker incompatibilidade de hash.

• Análises repetidas de Liveness com máscara 3D não disparam mais um erro de contexto WebGL.

• Segurança aprimorada.

1.9.10 – 15 de jun. de 2026

Aviso: a versão 1.9.9 foi rejeitada devido à redução de desempenho.

• O video_file_format parâmetro foi descontinuado. Ele será removido na 2.0.0, e o MOV formato não será mais aceito.

• Adicionado o antiscamCustomization.verticalPosition parâmetro para controlar a posição vertical da dica antiscam.

• Corrigido um problema de crescimento de memória no adapter sob carga pesada.

• O on_capture_complete callback agora limita frame_list o comprimento a max_jpeg_frames_to_api. Se max_jpeg_frames_to_api não estiver definido, o callback retorna todos os frames (inalterados).

• Reduzida a memória necessária para codificar frames ao usar o contêiner WASM.

• Adicionado o código de erro error_face_detector_no_result . A tela de captura não fica mais travada indefinidamente quando o detector de face falha durante a inicialização; se nenhuma face for encontrada em 5 segundos, o novo erro é retornado.

• Corrigido um TypeError no on_capture_complete callback na build serverless.

• Corrigida a tag inválida orientation_portrait1 no script auxiliar.

• Removido o parâmetro não utilizado photo_source .

• Segurança aprimorada.

1.9.7 – 24 de abr. de 2026

• Adicionado o closeButtonSlot opção. Aceita uma string HTML ou HTMLElement para substituir o conteúdo padrão do botão fechar.

• Adicionado o options.position parâmetro para o logo. Valores suportados: bottom-left (padrão) e bottom-center.

• Corrigidos excessivos error_recorder_face_detector e camera_preparation_error erros.

• Corrigido o problema com o aumento do número de rejeições no modo privado do Safari.

• Corrigida uma condição de corrida em add_lang() em que o idioma escolhido podia ser redefinido aleatoriamente para inglês durante a inicialização do SDK.

• O SDK agora distingue corretamente entre perda de conexão com a internet (error_connection_lost) e indisponibilidade do servidor (error_service_unavailable).

• O Web SDK não inicializa mais a tela do plugin duas vezes em uma única sessão quando o botão de seleção de gesto é clicado repetidamente durante o carregamento de recursos.

• Corrigido o plugin_already_running erro em chamadas subsequentes de open() após a conclusão da sessão (SPA, páginas de longo ciclo de vida) ou término anormal (erros de rede, descarregamento da página, erros de inicialização).

• Corrigidos erros de carregamento de recursos no Safari em que a tela do plugin falhava ao iniciar enquanto a câmera permanecia ativa.

• O Web SDK não quebra mais quando seu script de carregamento é carregado na página uma segunda vez.

• Corrigido o problema com travamentos que apareciam se o Web SDK fosse iniciado uma segunda vez pouco depois da primeira.

• Estabilidade e segurança aprimoradas.

1.9.2-15 – 30 de dez. de 2025

Implementado um novo formato de dados proprietário: OzCapsula Data Container.

• Agora é possível personalizar o oval do rosto usando a nova .ozliveness_face_stroke classe CSS (cor do traço, efeitos de brilho etc.). Todas as propriedades CSS padrão são suportadas.

• Agora oferecemos suporte ao kk código de idioma como alias para kz (cazaque). OzLiveness.set_lang('kk') e OzLiveness.set_lang('kz') funcionam igualmente.

• O OzLiveness.hide() e show() métodos agora oferecem suporte ao estado global de visibilidade da interface. Não é necessário chamá-los sempre; o estado é salvo entre sessões.

• Adicionados novos callbacks:

  • on_media_stream_start é chamado quando getUserMedia é concluído com sucesso,

  • on_media_stream_stop é chamado assim que o vídeo é capturado.

• O ready() promise agora é exposta como o evento de inicialização do plugin. Adicionados novos métodos:

  • OzLiveness.ready(): Promise<void> para retornar a Promise que é resolvida após o carregamento de todos os recursos do plugin,

  • OzLiveness.isReady(): Boolean para verificar o estado de inicialização.

• Corrigido o bug com um loader vazio exibido na tela entre o processamento e o envio.

• Se for inserido o código de idioma incorreto, o SDK agora exibe o erro apropriado.

• Os locales não em inglês agora são aplicados corretamente na primeira open() chamada.

• Segurança aprimorada.

1.8.1 – 9 de out. de 2025

• O Web SDK não retorna mais um erro quando você chama OzLiveness.hide() imediatamente após iniciar o plugin.

• Desempenho aprimorado.

• Segurança aprimorada.

1.8.0 – 26 de set. de 2025

• Agora é possível iniciar o Web Plugin no modo em janela. Defina parent_container em OpenOptions: parent_container: string | HTMLElement.

• As transições do loader agora podem ser personalizadas. Consulte as configurações de personalização. configurações.

• Melhoria no tratamento dos gestos de movimento da cabeça (para cima/para baixo).

• Corrigido um problema com mensagens de erro excessivas no console.

• Telemetria atualizada.

• Segurança aprimorada.

1.7.15 – 12 de ago. de 2025

• Agora é possível substituir o loader padrão pelo seu loader personalizado. Consulte as configurações de personalização. configurações.

• O comportamento do SDK quando a obtenção de acesso à câmera demora demais agora é configurável. Consulte os get_user_media_promise_timeout_* parâmetros listados aqui.

• Atualizações de segurança e telemetria.

1.7.14-89-1 – 9 de jul. de 2025

Alterações incompatíveis: não transmitimos mais pontuações nos callbacks. Substitua confidence_spoofing por 0 para SUCCESS e por 1 para outros status.

• Corrigido o bug em que o Web SDK não conseguia ler as image_data_tensor propriedades.

• Corrigido o problema em que o OzLiveness às vezes era chamado mais tarde do que o esperado.

• Atualização de segurança.

1.7.14 – 13 de jun. de 2025

• Adicionado suporte à API 6.0.

• Cabeçalhos CORS na configuração do servidor agora devem ser especificados sem aspas.

• Adicionado um novo parâmetro para gerenciar a autorização. auth define se e qual autorização é usada:

  • true (valor padrão) – a autorização é obrigatória e é baseada na chave gerada;

  • user:pass – a autorização é obrigatória e é baseada no login e na senha do usuário;

  • false – nenhuma autorização é necessária.

• Agora é possível ocultar o Switch Camera botão. Use style.switchCameraButtonCustomization.

• Corrigido o bug com cores sendo aplicadas incorretamente durante a personalização da máscara 3D.

• Corrigido o problema de espelhamento incorreto quando o use_for_liveness parâmetro não está definido.

• A digitalização de documentos no plugin agora funciona corretamente.

• Melhorada a acessibilidade: as dicas ao longo da jornada do cliente (acesso à câmera, processamento dos dados, envio dos dados, solicitação de resultados) agora são lidas corretamente e por completo pelos leitores de tela no modo assertive (as alterações nas dicas são anunciadas imediatamente).

• Criado um endpoint para verificação de licença: [GET] /check_license.php.

• Reduzido o tamanho do bundle.

• Corrigido o problema com a ausência de detalhes da análise no on_complete callback ao usar result_mode: full.

• Corrigido o problema em que o botão de troca de câmera podia estar ausente.

• A câmera frontal não exibe mais as ações do usuário como em um espelho.

• Tratamento de erros aprimorado.

• Suporte aprimorado para dispositivos de baixo desempenho.

• Adicionada a verificação de olhos fechados ao Scan gesto.

• Melhorias internas, correções de bugs, grandes atualizações de telemetria e segurança.

1.6.15 – 27 de dez. de 2024

• Simplificadas as verificações que exigem que o usuário mova a cabeça: virar para a esquerda ou direita, inclinar ou olhar para baixo.

• Reduzido o limite de distância para as ações de movimentação da cabeça: virar para a esquerda ou direita, inclinar ou olhar para baixo.

• O comportamento do aplicativo quando as ferramentas de desenvolvedor abertas são detectadas agora pode ser gerenciado.

• Agora é possível configurar assinaturas de métodos para torná-las confiáveis por meio do checksum da função modificada.

• Alterada a nomenclatura para o head_down gesto: a nova expressão é “tilt down”.

• Para possíveis exigências regulatórias, atualizado o arquivo de configuração do Web Adapter com um novo parâmetro: extract_action_shot. Se True, para cada gesto, o sistema salva a imagem correspondente para exibi-la no relatório, por exemplo, olhos fechados para piscar, em vez de um frame aleatório para a miniatura.

• Corrigido um problema em que uma seta aparecia incorretamente após a captura de gestos de movimento da cabeça.

• Corrigido um problema em que o oval desaparecia quando a frase "Great!" era exibida.

• Aprimorada a seleção de a melhor captura.

• Atualizações de segurança.

1.6.12 – 18 de out. de 2024

• Atualizações de segurança.

• Corrigido o problema em que um vídeo não podia ser gerado a partir de uma sequência de frames.

1.6.0 – 24 de jun. de 2024

• O on_complete O callback agora é chamado quando o status da pasta muda.

• Instruções de acesso à câmera atualizadas nos navegadores Android Chrome e Facebook. Novas chaves:

  • error_no_camera_access,

  • oz_tutorial_camera_android_chrome_with_screens_title,

  • oz_tutorial_camera_android_chrome_instruction_screen_click_settings,

  • oz_tutorial_camera_android_chrome_instruction_screen_permissions,

  • oz_tutorial_camera_android_chrome_instruction_screen_allow_access,

  • try_again,

  • oz_tutorial_camera_external_browser_button,

  • oz_tutorial_camera_external_browser_manual_open_link,

  • oz_tutorial_camera_external_browser_title.

• Adicionado o get_langs() método que retorna uma lista de locales disponíveis no Web SDK instalado.

• Adicionado um erro para o caso de definir um locale indisponível.

• Adicionado um erro para o caso de falta de um recurso necessário. Nova chave: unable_load_resource.

• Textos alterados para o error_connection_lost e error_service_unavailable erros.

• Novos arquivos de strings do Web SDK enviados.

• A função crop não adiciona mais bordas para imagens menores que 512×512.

1.5.3 – 28 de mai. de 2024

• Em caso de timeout no acesso à câmera, agora exibimos uma página com instruções para que os usuários habilitem o acesso à câmera: padrão para todos os navegadores e específico para Facebook.

• Adicionados vários registros de localização ao arquivo de strings do Web SDK. Novas chaves:

  • accessing_camera_switch_to_another_browser,

  • error_camera_timeout_instruction,

  • error_camera_timeout_title,

  • error_camera_timeout_android_facebook_instruction.

1.5.0 – 5 de mai. de 2024

• Melhorada a experiência do usuário em máquinas de impressão de cartões. Os usuários não precisam mais chegar tão perto da tela com o quadro facial.

• Adicionado o disable_adaptive_aspect_ratio parâmetro para o Web Plugin. Esse parâmetro desativa o ajuste padrão da proporção do vídeo para a janela.

• Implementado o get_user_media_timeout parâmetro para o Web Plugin: quando o SDK não consegue obter acesso à câmera do usuário, após esse tempo limite ele exibe uma dica sobre como resolver o problema.

• Adicionados vários registros de localização no arquivo de strings do Web SDK. Novas chaves:

  • oz_tutorial_camera_android_edge_browser

  • oz_tutorial_camera_android_edge_instruction

  • oz_tutorial_camera_android_edge_title

  • error_camera_timeout_instruction

  • error_camera_timeout_title

• Aprimorada a localização: quando o SDK não encontra uma tradução para uma chave, ele exibe uma mensagem em inglês.

• Agora é possível distribuir o Web SDK serverless via Node Package Manager.

• É possível desativar a exibição de erros da API em janelas modais. Defina o disable_adapter_errors_on_screen parâmetro no arquivo de configuração como True.

• Os navegadores móveis agora usam a câmera traseira para tirar as fotos dos documentos.

• Atualizados os exemplos.

• Corrigido o bug com reação anormal da máscara 3D quando o usuário precisa repetir um gesto.

• Atualizações de logs e segurança.

1.4.3 – 15 de abr. de 2024

• Corrigido o bug em que o aviso sobre a orientação incorreta do dispositivo não era exibido quando um usuário móvel tentava gravar um vídeo com o rosto na orientação paisagem.

• Alguns usuários podem ter experimentado travamentos ao usar o WebView. Agora, os usuários podem tocar em um botão para continuar trabalhando com o aplicativo. A string correspondente foi adicionada ao arquivo de strings na seção de localização. Chave: tap_to_continue.

1.4.2 – 14 de mar. de 2024

• Melhorias na depuração.

1.4.1 – 27 de fev. de 2024

• Principais atualizações de segurança: proteção aprimorada contra câmeras virtuais e adulteração de JavaScript.

• Suporte aprimorado ao WebView:

  • Foram adicionadas instruções de acesso à câmera para aplicativos nos navegadores genéricos WebView no Android e no iOS. Os eventos correspondentes são adicionados à telemetria.

  • Melhorada a integração do aplicativo React Native ao adicionar o webkit-playsinline atributo, corrigindo assim o problema de abertura da câmera em tela cheia no iOS WebView.

• O erro de uso do iFrame quando iframe_allowed = False agora é exibido corretamente.

• Novas chaves de localização:

  • oz_tutorial_camera_android_webview_browser

  • oz_tutorial_camera_android_webview_instruction

  • oz_tutorial_camera_android_webview_title

1.4.0 – 07 de fev. de 2024

• Agora é possível usar o Web SDK para a Black List análise: para comparar o rosto do seu vídeo de Liveness com rostos do seu banco de dados. Crie uma coleção (ou coleções) com essas fotos via API ou Web UI, e adicione o ID correspondente (ou IDs correspondentes) ao analyses.collection_ids array no arquivo de configuração do Web Adapter.

• O suporte a iframe está de volta: defina o iframe_allowed parâmetro no arquivo de configuração do Web Adapter para True.

• O intervalo de consulta pelos resultados das análises agora é configurável. Altere-o no results_polling_interval parâmetro do arquivo de configuração do Web Adapter, se necessário.

• Agora é possível selecionar a câmera frontal ou traseira via Web Plugin. No OzLiveness.open() método, defina cameraFacingMode como user para a câmera frontal e environment para a traseira. Esse parâmetro só funciona quando a use_for_liveness opção no arquivo de configuração do Web Adapter não estiver definida.

• Os estilos do plugin agora são adicionados automaticamente. Remova <link rel="stylesheet" href="/plugin/ozliveness.css" /> da sua página para evitar conflitos de estilo.

• Foram corrigidos alguns bugs e a telemetria foi atualizada.

1.3.1 – 12 de jan. de 2024

• Proteção aprimorada contra ataques de injeção.

• Substituído o código do português do Brasil de pt como pt-br para corresponder ao padrão ISO.

• Removido o lang_default parâmetro do adaptador.

• A transparência da máscara 3D tornou-se personalizável.

• Implementada a possibilidade de usar uma licença mestre que funciona com qualquer domínio.

• Adicionado o master_license_signature opção nos parâmetros de configuração do Web Adapter.

• Corrigidos alguns bugs.

1.2.2 – 15 de dez. de 2023

• Melhorias internas no SDK.

1.2.1 – 04 de nov. de 2023

• Para aprimorar a experiência dos seus clientes com o Web SDK, implementamos a máscara 3D que substitui o oval durante a captura facial. Para fazê-la funcionar, defina o load_3d_mask em Configurações do arquivo de configuração como true.

• Telemetria atualizada (logging).

1.1.5 – 27 de out. de 2023

• Atualizações de logging.

1.1.4 – out. de 2023

• Atualizações de segurança.

1.1.3 – 29 de set. de 2023

• Melhorias internas no SDK.

1.1.2 – 21 de set. de 2023

• Melhorias internas no SDK.

1.1.1 – 29 de ago. de 2023

• Corrigidos alguns bugs.

1.1.0 – 24 de ago. de 2023

• Alterada a assinatura do on_error() callback: agora ele retorna um objeto com o código do erro, a mensagem de erro e o ID de telemetria para logging.

• Adicionado o parâmetro de configuração para o modo de depuração. Se True, o Web SDK habilita acesso à página /debug.php, que contém informações sobre a configuração atual e a licença atual.

• Corrigidos alguns bugs e aprimorado o logging.

1.0.2 – 06 de jul. de 2023

• Se o seu dispositivo tiver várias câmeras, agora é possível escolher uma ao iniciar o Web Plugin.

1.0.1 – 01 de jul. de 2023

• Implementado o novo design para o SDK e a demo, incluindo a opção de proteção contra fraude: a mensagem antiscam avisa o usuário de que suas ações estão sendo gravadas. Verifique as novas opções de personalização aqui.

• Adicionadas as localidades de português, espanhol e cazaque.

• Adicionado o gesto combinado.

• Adicionada a barra de progresso para upload de mídia.

• Removidos os gestos de Zoom in / Zoom out.

• Em tablets, agora é possível capturar vídeo na orientação paisagem.

• Removido o lang_allow opção do arquivo de configuração do Web Adapter.

0.9.1 – 01 de mar. de 2023

• Na captura arquitetura, quando uma câmera virtual é detectada, o additional_info parâmetro está dentro da from_virtual_camera seção.

• Agora é possível recortar o frame sem perdas sem perder qualidade.

• Corrigidos os landmarks faciais para a captura arquitetura.

0.9.0 – 20 de fev. de 2023

• Qualidade da gravação aprimorada;

• Reforjado licenciamento:

  • adicionadas descrições detalhadas de erro;

  • agora é possível definir a licença em JS durante a execução;

  • quando você define uma licença em OzLiveness.open(), ela substitui a licença anterior;

  • a licença não requer mais porta e protocolo;

  • agora é possível especificar subdomínios na licença;

  • ao iniciar o plugin em um servidor, o payload da licença é exibido no log do Docker;

  • localhost e 127.0.0.1 não solicitam mais uma licença;

• O callback on_capture_complete agora está disponível em qualquer arquitetura: ele é chamado assim que um vídeo é capturado e retorna informações sobre as ações do vídeo;

• As versões do Oz Web Liveness e do Oz Web Adapter são exibidas no log do Docker ao iniciar;

• Excluído o campo obsoleto adapter_version dos metadados do pedido;

• Adicionados os parâmetros para transmitir as informações sobre a bounding box – landmarks que definem onde está o rosto no frame;

• Corrigido o Alternar câmera botão no Google Chrome;

• Ao iniciar o Web SDK, os parâmetros de configuração reais são exibidos no log do Docker.

0.7.6 – 27 de set. de 2022

• Alterada a extensão de alguns arquivos de sistema da Oz de .bin para .dat.

0.7.5

• Os scripts adicionais agora são chamados usando o endereço do script principal.

0.7.4

• Agora o Web SDK pode ser instalado somente por meio de arquivos estáticos (funciona para a captura tipo de arquitetura).

• O Web SDK agora pode funcionar com CDN.

• Agora, é possível iniciar vários plugins do Oz Liveness em páginas diferentes. Nesse caso, é necessário especificar o caminho para os scripts no head dessas páginas.

Se você atualizar a versão do Web SDK de 0.4.0, a licença também deve ser atualizada.

0.4.1

• Corrigido um bug com a tela de captura.

0.4.0

• Adicionado licenciamento (requer origin).

• Agora é possível personalizar a aparência e o comportamento do Web SDK.

0.3.2044

• Corrigida a integração com Angular.

0.3.2043

• Corrigido o bug em que a seção IMAGE_FOLDER estava ausente na resposta JSON com o frame sem perdas habilitado.

0.3.2042

• Corrigidos problemas com a biblioteca ravenjs.

0.3.2041

• Agora é possível personalizar um frame para capturar a foto de documentos.

0.3.2012

• Implementadas atualizações de segurança.

0.3.2009 (0.4.8)

• Os metadados agora contêm os nomes de todas as câmeras que podem ser usadas.

0.3.2005 (0.4.8)

• Os formatos video e zip agora permitem carregar uma imagem sem perdas.

• Corrigido o Best Shot.

0.3.2004 (0.4.8)

• Separado o código de erro e a descrição do erro nas respostas do servidor.

0.3.2001 (0.4.6)

• Se o modo do SDK estiver definido nas variáveis de ambiente architecture, api_url, ele é passado automaticamente para as configurações.

• No modo Lite, é possível selecionar o melhor frame para qualquer ação.

• No modo Lite, uma imagem enviada via API recebe o on_complete status somente após um liveness bem-sucedido.

• É possível gerenciar CORS usando as variáveis de ambiente (os cabeçalhos CORS não são adicionados por padrão).

0.3.1999

• Adicionado o valor de pasta para result_mode: ele retorna o mesmo valor que status, mas com folder_id.

0.3.1997 (0.4.5)

• Criptografia atualizada: agora apenas os metadados necessários para descriptografar um objeto são criptografados.

• Transferência de dados atualizada: as imagens estão sendo enviadas em campos de formulário separados.

• Adicionada a verificação dos parâmetros da câmera.

0.3.1992 (0.4.4)

• Habilitado um novo método para criptografia de imagens.

• Formato de transferência de imagens otimizado.

0.3.1991

• Adicionado o use_for_liveness opção: dispositivos móveis usam a câmera traseira por padrão; no desktop, flip e o contorno oval estão desativados. Por padrão, a opção está desativada.

0.3.1990 (0.4.3)

• Reduzida a duração do vídeo para video_selfie_best (o Selfie gesto) de 1 para 0,2 s.

• O carregamento de scripts agora é personalizável.

• UX aprimorada.

0.3.1988 (0.4.2)

• Adicionada a localidade de cazaque.

• Adicionado um guia para acessar a câmera em um desktop.

• Logging aprimorado: solicitações a plugin_liveness.php e registro do user-agent no log do servidor.

• Adicionado o modo Lite.

0.3.1987 (0.4.1)

• Adicionada criptografia.

• Bibliotecas atualizadas.

0.3.1986 (0.3.91)

• Agora é possível ocultar o logotipo da Oz Forensics.

0.3.1984

• Atualizado um guia para Facebook, Instagram, Samsung e Opera.

• Adicionados manipuladores para variáveis desconhecidas e um guia para navegadores “desconhecidos”.

0.3.1983

• Uso de memória otimizado para um frame.

• Adicionado um guia sobre como ativar a troca de câmeras em navegadores Android.