> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/sdks/backend-sdk/voice/changelog.md).

# Changelog

## \[3.4.0]

* É adicionado FacephiActivationLoad para gerenciar e ativar a licença.

## \[3.3.0]

* São adicionadas funções para melhorar o carregamento da licença a partir dos metadados do cryptlex.
* É melhorado o processo de registro da licença durante a inicialização do Docker.

## \[3.2.1]

* Pequenas melhorias na licença.

## \[3.2.0]

* Novo endpoint GET `/api/v1/config` para obter a configuração atual do serviço.
* Novo endpoint POST `/api/v1/config` para atualizar a configuração do serviço sem reiniciá-lo.

## \[3.0.1]

* É corrigido um problema de licença para garantir a conformidade regulatória e o funcionamento correto do Voice Service.

## \[3.0.0]

* É introduzido o novo algoritmo de verificação, que oferece um desempenho melhor em relação às versões anteriores. O algoritmo anterior continua disponível por motivos de compatibilidade.
* É melhorada a precisão do algoritmo de detecção de vida contra clonagem de voz (voice clone liveness).
* É melhorada a precisão do algoritmo de detecção de vida contra ataques de repetição (presentation/replay attack).
* É corrigido o erro `TOO_NOISY` que era reportado pelo SNR Computer em arquivos com silêncios prolongados.
* O backend do OpenVINO é atualizado da versão 2023.0 para a 2024.4.

## \[2.9.0]

* A versão da imagem Docker é atualizada para Ubuntu 24.04.
* O número de threads na configuração do serviço é 1 por padrão.
* É adicionado um novo algoritmo de verificação com maior precisão.
* É melhorada a precisão dos algoritmos de verificação e detecção de vida em cenários com ruído. A pontuação de verificação pode diferir ligeiramente em relação à versão anterior, mas os templates de voz continuam compatíveis.
* O limiar recomendado para a verificação da qualidade do comprimento relativo da fala, nos casos de uso de verificação e detecção de vida, agora é 0 (é permitido qualquer comprimento relativo da fala).
* É atualizado o algoritmo de estimativa de SNR. Os valores estimados podem diferir dos da versão anterior do produto, mas a precisão geral do algoritmo permanece a mesma.

## \[2.8.0]

* Nova propriedade `check_quality` nos endpoints de `enrollment` e `authentication` para habilitar ou desabilitar a verificação de qualidade.
* Nova propriedade `check_liveness` no endpoint de `authentication` para habilitar ou desabilitar a verificação de vida (liveness).

## \[2.7.2]

* Melhorias na verificação de saúde (health check) do serviço.
* Melhorias na gestão de licenças.

## \[2.7.1]

* Melhorias de concorrência na decodificação base64.
* Algumas melhorias menores no código.

## \[2.7.0]

* Algumas refatorações e melhorias de desempenho.
* Melhorias de concorrência.
* Melhorias na verificação de saúde (health check) do serviço.
* Novas verificações sobre a disponibilidade da licença.

## \[2.6.0]

* Novos parâmetros de Quality Check:
  * `minimum_speech_relative_length`: comprimento mínimo exigido da fala em relação à duração total do áudio.
  * `maximum_multiple_speakers_detector_score`: número máximo de falantes simultâneos.
* Novos campos de resposta com os valores detectados pelo Quality Check:
  * `snr_db_detected`: relação sinal-ruído (Signal-to-Noise Ratio) detectada.
  * `speech_length_ms_detected`: comprimento da fala detectado.
  * `speech_relative_length_detected`: comprimento relativo da fala detectado.
  * `multiple_speakers_score_detected`: pontuação de múltiplos falantes detectada.

## \[2.5.0]

* Suporte para novos formatos de áudio: AAC, PCM ulaw e mulaw, WMA, MP4, FLAC, ALAC e AIFF.
* Suporte para áudios com uma frequência de amostragem inferior a 16 kHz.
* São integrados eventos de tracking para a autenticação.

## \[2.4.0]

* É atualizado `voice-sdk` para a v2.4.0.
* Multithreading no processo de enrollment.
* As exceções de baixo nível são expostas ao usuário.

## \[2.3.1]

* É atualizado `voice-sdk` para a v2.3.1.
* As mensagens de exceção e erro são melhoradas.

## \[2.3.0]

* É atualizado `voice-sdk` para a v2.3.0.
* É atualizado `facephi-rest-manager` para a v2.4.2.
* É adicionado suporte para o formato de áudio AAC.
* Novo parâmetro de configuração `client_max_body_size` para limitar o tamanho máximo do corpo da requisição.

## \[2.2.3]

* É atualizado `voice-sdk` para a v2.2.3.
* É adicionado o campo `operation_result` ao resultado de Authentication e Enrollment.
* É adicionado o campo `liveness_score` ao resultado de Authentication e Enrollment.
* É adicionado o campo `matching_score` ao resultado de Enrollment.
* É adicionado o campo `template_type` ao resultado de Enrollment.
* É renomeado o campo `probability` do resultado de Authentication para `matching_score`.
* É corrigido o campo `template` no resultado de Enrollment. O campo `template` estará vazio se a resposta não for válida.
* É corrigido o campo `template` quando vários áudios eram enviados a Enrollment, mas não era atingido o número mínimo de áudios necessário para gerar um padrão text-independent.

## \[2.2.2]

* É atualizado `voice-sdk` para a v2.2.2.
* É atualizado `facephi-rest-manager` para a v2.4.0.

## \[2.2.0]

* É adicionado suporte para `voice-sdk` v2.2.0.
* Os endpoints aceitam áudios criptografados e não criptografados.
* A verificação de qualidade pode ser modulada na requisição, com os novos parâmetros `minimum_snr_db` e `minimum_speech_duration_ms`.

## \[2.1.0]

* facephi-rest-manager é atualizado para a versão 2.1.3.

## \[2.0.0]

* É adicionado suporte para `voice-sdk` v2.0.0, com áudios e templates criptografados.
* Refatoração da implementação da API Rest.
* Novo formato de mensagem para os erros de Bad Request e Internal Server Error.

## \[1.3.1]

* O código de status HTTP é incluído na resposta JSON de erro.
* Todos os endpoints passam a estar em minúsculas.
* É melhorada a gestão e as mensagens de exceções.
* São adicionadas exceções para os erros de voice-sdk.
* Novo endpoint api/v1/version.
* Novo endpoint api/v1/health.

## \[1.3.0]

* Novo sistema de licenças.