Este artigo foi originalmente publicado no blog do OpenVoiceOS
O Home Assistant trata da automação. O OVOS trata da voz. Nenhum tenta ser o outro. É essa divisão de responsabilidades que faz a combinação funcionar: as integrações de dispositivos e o motor de automação do HA em conjunto com a stack de voz flexível e totalmente local do OVOS.
Este artigo cobre as três camadas de integração: pontes Wyoming para a pipeline de voz do HA, o ovos-persona-server como agente conversacional e o HiveMind para expor dispositivos OVOS como entidades nativas do HA.
Pontes Wyoming: Plugins de Voz OVOS no Home Assistant
O protocolo Wyoming é a interface padrão do HA para serviços externos de ASR, TTS e palavra de ativação. Construímos pontes Wyoming que expõem qualquer plugin OVOS através desse protocolo, pelo que o HA passa a ter acesso a todos os plugins do ecossistema OVOS, em vez de apenas a uma lista restrita e selecionada.
- Wyoming OVOS ASR: Converte comandos falados em texto para o Home Assistant compreender.
- Wyoming OVOS TTS: Permite ao Home Assistant falar as respostas usando as diversas opções de voz do OVOS.
- Wyoming OVOS Wakeword: Integra palavras de ativação personalizadas, permitindo que o seu Home Assistant responda apenas quando ouve a frase de ativação que escolheu.
O projeto OVOS Wyoming Docker empacota estes serviços de forma a que fiquem a um docker compose up de distância.
TTS multilingue de projetos linguísticos financiados publicamente
A acessibilidade inclui a acessibilidade linguística. Esta integração leva vozes de alta qualidade e financiadas publicamente, de projetos como o ILENIA, a um público mais alargado. Os utilizadores do Home Assistant obtêm vozes com som natural para línguas como o catalão e o galego, diretamente dos projetos que as construíram.
- Matxa TTS para catalão: O
ovos-tts-plugin-matxa-multispeaker-catfornece capacidades de síntese de fala multi-locutor para a língua catalã. - NosTTS para galego: O
ovos-tts-plugin-nosoferece síntese de fala em galego.
Usar o OVOS como Agente Conversacional para o Home Assistant
Quer ir um passo mais além? Pode configurar o OVOS como um agente conversacional completo para o Home Assistant usando a integração Ollama.
Nesta configuração, o Home Assistant passa o texto do utilizador para o ovos-persona-server. O OVOS determina a intenção e devolve a resposta para o Home Assistant falar. E como o ovos-persona-server expõe endpoints compatíveis com o Ollama, o mesmo servidor liga-se a qualquer aplicação que fale as APIs do Ollama ou da OpenAI, e não só ao Home Assistant.
OVOS com o Voice PE
A Home Assistant Voice Preview Edition é um satélite de hardware dedicado à pipeline de voz do HA. Funciona com todos os serviços Wyoming descritos acima: basta apontá-la para qualquer instância em execução de wyoming-ovos-stt, wyoming-ovos-tts ou wyoming-ovos-wakeword.
Expor Dispositivos OVOS como Entidades do Home Assistant com o HiveMind
Se tiver dispositivos OVOS dedicados, a integração HiveMind HomeAssistant faz com que apareçam como entidades nativas no Home Assistant: um painel de controlo unificado para todo o conjunto de dispositivos.
Configurar a Integração HiveMind:
Para integrar os seus dispositivos OVOS através do HiveMind, irá normalmente adicionar a integração HiveMind no Home Assistant. Isto implica fornecer detalhes de ligação como um name para a integração, uma access_key, password, site_id, host (endereço IP ou nome de anfitrião do seu servidor HiveMind) e a port (por predefinição, 5678). Poderá também ter opções para allow_self_signed (permitir certificados autoassinados) ou ativar legacy_audio, consoante a sua configuração.
Controlos Expostos para Dispositivos OVOS:
Uma vez integrado, o HiveMind expõe um conjunto abrangente de controlos para os seus dispositivos OVOS diretamente dentro do Home Assistant. Isto permite-lhe gerir vários aspetos do seu dispositivo OVOS a partir da interface do Home Assistant, incluindo:
- Alterar o
Listening Mode(por exemplo, palavra de ativação, escuta permanente) - Alternar o
Microphone Mute - Estado e controlos do
OCP Player - Ações como
Reboot Device,Restart OVOSeShutdown Device - Alternar o
Sleep Modee oSSH Service - Iniciar manualmente a escuta (
Start Listening) ou pará-la (Stop) - Controlar o nível de volume
Integração de Notificações:
O HiveMind também permite que os seus dispositivos OVOS funcionem como destinatários de notificações dentro do Home Assistant. Isto significa que pode configurar automações do Home Assistant para enviar notificações faladas diretamente para os seus dispositivos OVOS, permitindo que “falem” alertas, lembretes ou qualquer outra informação que configure. Isto é exposto como uma entidade de notificação “Speak” no Home Assistant.
Integração com Media Player e Music Assistant:
Os dispositivos OVOS aparecem também como leitores de multimédia normais no Home Assistant, pelo que pode controlar a reprodução a partir da interface habitual de leitor de multimédia. A mesma integração estende-se ao Music Assistant: transmita música através dos seus dispositivos OVOS e estes passam a fazer parte do seu sistema de áudio para toda a casa.
Controlar Entidades do Home Assistant a partir do OVOS
A skill skill-homeassistant, mantida pela comunidade, dá ao OVOS controlo direto sobre as entidades do Home Assistant através da API REST do HA. Instale-a no seu dispositivo OVOS e poderá dizer “acende as luzes da sala” ou “coloca o termóstato a 21 graus”, totalmente local, sem envolver a cloud.
O Que Ainda Está Pouco Polido
As pontes Wyoming e a integração HiveMind são as peças mais maduras aqui. O percurso do persona-server como agente conversacional é mais recente; vale a pena experimentá-lo primeiro se quiser ver o teto do que o OVOS e o HA conseguem fazer juntos. Relatórios de bugs e PRs são bem-vindos em todos os repositórios ligados acima.
O OpenVoiceOS é um projeto comunitário. Se acredita que os assistentes de voz devem ser abertos, inclusivos e controlados pelo utilizador, apoie o projeto com financiamento, dados abertos ou traduções.