Reactivar Som

Autor: Oleksandr Gryshchenko
Versão: 1.5
Compatibilidade com o NVDA: 2019.3 e seguintes
Descarregar versão estável

Este extra verifica o estado do sistema áudio do Windows quando o NVDA arranca. E, se se verificar que o som está desactivado, o extra liga-o à força.

Ao mesmo tempo, o nível de volume é verificado separadamente para o processo do NVDA.

O extra também verifica o estado do sintetizador de voz. Se houver problemas com a sua inicialização, são feitas tentativas para iniciar o sintetizador, que são especificadas nas configurações do NVDA.

Há uma oportunidade adicional de verificar em que dispositivo de áudio o som do NVDA é emitido. E, se este dispositivo for diferente do dispositivo padrão, a saída muda automaticamente para o dispositivo de áudio instalado no sistema como o principal.

Nota: Se o som de arranque do extra tocar sempre, mesmo que o volume do NVDA esteja online. Ou seja, o suplemento muda a saída para o dispositivo de áudio principal cada vez que se inicia o NVDA.

Isto ocorre quando o dispositivo de saída de áudio que está nas definições do NVDA é diferente do dispositivo de saída padrão ou "Microsoft Sound Mapper".

Isto pode ser facilmente resolvido de uma das seguintes formas:

Após reiniciar o NVDA, basta guardar a configuração actual usando NVDA+Ctrl+C. O dispositivo de áudio padrão será guardado nas definições do NVDA e a comutação não ocorrerá de cada vez que o NVDA seja iniciado.
Se não quiser alterar a configuração do NVDA, basta desactivar a função de mudar os dispositivos de áudio no painel de configurações do extra.

Configurações:

Para abrir o painel de configurações do add-on, siga estes passos:

Pressione NVDA+N para abrir o menu do NVDA.
Depois vá para "Preferências" -> "configurações..." e na lista de categorias encontre e abra "Reactivar som".

Pode agora usar a tecla Tab para se mover entre as configurações do extra.

As seguintes opções estão disponíveis, nas configurações do extra:

O primeiro selector das configurações permite-lhe especificar o nível de volume do Windows, que será definido quando iniciar o NVDA se o som tiver sido previamente desactivado ou se o volume estiver demasiado baixo.
O nível mínimo de volume do Windows em que o procedimento de aumento de volume será aplicado. Este selector permite ajustar o nível de sensibilidade do add-on.

Se o nível de volume cair para um valor inferior ao aqui especificado, o volume será aumentado na próxima vez que iniciar o NVDA.

Caso contrário, se o nível de volume permanecer superior ao valor aqui especificado, então quando reiniciar o NVDA, o seu nível não mudará.

E, claro, se o som tiver sido previamente desligado, quando reiniciar, o extra irá ligá-lo de qualquer forma.
A caixa de verificação seguinte permite a reinicialização do driver do sintetizador de voz.

Este procedimento só será iniciado se for detectado, no arranque do NVDA, que o driver do sintetizador de voz não foi iniciado.
Neste campo pode especificar o número de tentativas para reiniciar o sintetizador de voz. As tentativas são executadas de forma cíclica com um intervalo de 1 segundo. Um valor de 0 significa que as tentativas serão executadas indefinidamente até que o procedimento seja concluído com sucesso.
A opção "mudar para o dispositivo de áudio padrão" permite verificar no arranque o dispositivo de áudio em que o som NVDA é emitido. E, se este dispositivo for diferente do dispositivo padrão, a saída muda automaticamente para o dispositivo de áudio instalado no sistema como o principal.
A caixa de verificação seguinte liga ou desliga o som de arranque quando a operação é bem sucedida.

Componentes de terceiros

O extra utiliza os seguintes componentes de terceiros:

Para interacção com o Windows Core Audio API - módulo PyCaw que é distribuído sob a licença do MIT.
Para obter a informação sobre processos em execução e utilização do componente PyCaw - módulo psutil que é distribuído sob licença BSD-3.

Modificações:

Versão 1.5.5

o extra foi testado para compatibilidade com o NVDA 2021.1;
módulo de terceiros actualizado psutil*;
o extra foi adaptado para suportar as versões Python 3.7 e 3.8;
Anotações do tipo MyPy adicionadas ao código fonte do extra;
adicionada a funcionalidade "Mudar para o dispositivo áudio de saída padrão";
os parâmetros do extra são sempre armazenados no perfil de configuração base.

Versão 1.4

adicionado um método para aumentar o volume de arranque separadamente para o processo do NVDA;
alterada a notificação sonora de uma operação bem sucedida (graças ao Manolo);
todas as funções de controlo manual do volume foram transferidas para o extra de definição de volume do NVDA.

Versão 1.3

adicionada a capacidade de controlar o volume do dispositivo de áudio principal e separadamente para cada programa em execução;
tradução actualizada em vietnamita (graças a Dang Manh Cuong);
adicionada tradução turca (graças a Cagri Dogan);
Acrescentada a tradução italiana (graças a Christianlm);
Adicionada a tradução em chinês simplificado (graças a Cary Rowen);
Acrescentada a tradução polaca (graças a Stefan Banita);
tradução ucraniana actualizada;
readMe actualizado.

Versão 1.2

passou a utilizar o Core Audio Windows API em vez de Windows Sound Manager;
adicionada a reprodução de som de arranque quando o áudio é ligado com sucesso através de um extra.

Versão 1.1

Adicionado o diálogo de configurações do add-on
tradução ucraniana actualizada.

Versão 1.0.1

Realiza repetidas tentativas para activar o sintetizador em caso da sua inicialização falhada;
Tradução vietnamita acrescentada por Dang Manh Cuong;
Acrescentada a tradução ucraniana.

Versão 1.0: funcionalidades de implementação

O extra utiliza um módulo de gestão de som de terceiros.

Alteração do código fonte

Pode clonar este repositório para fazer alterações ao extra "reactivar som".

Dependências de terceiros

Podem ser instaladas com pip:

markdown
scons
python-gettext

Para preparar o extra para distribuição

Abrir uma linha de comando, mudar para a raiz deste repositório
Executar o comando scons*. O extra criado, se não houver erros, é colocado no directório actual.