Эта статья была первоначально опубликована в блоге OpenVoiceOS
Home Assistant отвечает за автоматизацию; OVOS отвечает за голос. Ни один из них не пытается быть другим. Именно это разделение обязанностей и делает связку работоспособной: интеграции устройств и движок автоматизации HA в паре с гибким, полностью локальным голосовым стеком OVOS.
В этой статье рассматриваются три слоя интеграции: мосты Wyoming для голосового конвейера HA, ovos-persona-server в роли разговорного агента и HiveMind для отображения устройств OVOS как нативных сущностей HA.
Мосты Wyoming: голосовые плагины OVOS в Home Assistant
Протокол Wyoming — это стандартный интерфейс HA для внешних сервисов ASR, TTS и распознавания слова активации. Мы построили мосты Wyoming, которые предоставляют любой плагин OVOS по этому протоколу, — а значит, HA получает доступ к каждому плагину в экосистеме OVOS, а не только к отобранному короткому списку.
- Wyoming OVOS ASR: преобразует голосовые команды в текст, понятный Home Assistant.
- Wyoming OVOS TTS: позволяет Home Assistant озвучивать ответы, используя разнообразные голосовые варианты OVOS.
- Wyoming OVOS Wakeword: интегрирует пользовательские слова активации, позволяя вашей установке Home Assistant реагировать только когда она слышит выбранную вами триггерную фразу.
Проект OVOS Wyoming Docker упаковывает эти сервисы так, что до них — один docker compose up.
Многоязычный TTS из публично финансируемых языковых проектов
Доступность включает языковую доступность. Эта интеграция доносит высококачественные, публично финансируемые голоса из таких проектов, как ILENIA, до более широкой аудитории. Пользователи Home Assistant получают естественно звучащие голоса для таких языков, как каталанский и галисийский, прямо от проектов, которые их создали.
- Matxa TTS для каталанского:
ovos-tts-plugin-matxa-multispeaker-catпредоставляет возможности многодикторного синтеза речи для каталанского языка. - NosTTS для галисийского:
ovos-tts-plugin-nosпредлагает надёжный синтез речи на галисийском.
Использование OVOS как разговорного агента для Home Assistant
Хотите пойти ещё дальше? Вы можете настроить OVOS как полноценного разговорного агента для Home Assistant с помощью интеграции Ollama.
В такой конфигурации Home Assistant передаёт текст пользователя в ovos-persona-server; OVOS определяет намерение и возвращает ответ, который Home Assistant озвучивает. А поскольку ovos-persona-server предоставляет совместимые с Ollama конечные точки, тот же сервер подключается к любому приложению, говорящему на API Ollama или OpenAI, — не только к Home Assistant.
OVOS с Voice PE
Home Assistant Voice Preview Edition — это выделенный аппаратный сателлит для голосового конвейера HA. Он работает со всеми описанными выше сервисами Wyoming — направьте его на любой запущенный экземпляр wyoming-ovos-stt, wyoming-ovos-tts или wyoming-ovos-wakeword.
Отображение устройств OVOS как сущностей Home Assistant с помощью HiveMind
Если у вас есть выделенные устройства OVOS, интеграция HiveMind HomeAssistant заставляет их отображаться как нативные сущности в Home Assistant — единая панель управления для всего парка устройств.
Настройка интеграции HiveMind:
Чтобы интегрировать ваши устройства OVOS через HiveMind, вы обычно добавляете интеграцию HiveMind в Home Assistant. Это предполагает указание параметров подключения, таких как name для интеграции, access_key, password, site_id, host (IP-адрес или имя хоста вашего сервера HiveMind) и port (по умолчанию 5678). В зависимости от вашей конфигурации у вас также могут быть опции allow_self_signed (самоподписанные сертификаты) или включение legacy_audio.
Доступные элементы управления устройствами OVOS:
После интеграции HiveMind предоставляет исчерпывающий набор элементов управления вашими устройствами OVOS прямо в Home Assistant. Это позволяет управлять различными аспектами вашего устройства OVOS из интерфейса Home Assistant, включая:
- Изменение
Listening Mode(например, слово активации, постоянное прослушивание) - Переключатель
Microphone Mute(отключение микрофона) - Статус и управление
OCP Player - Действия, такие как
Reboot Device,Restart OVOSиShutdown Device - Переключение
Sleep ModeиSSH Service - Ручной запуск прослушивания
Start Listeningили его остановкаStop - Управление уровнем громкости
Интеграция уведомлений:
HiveMind также позволяет вашим устройствам OVOS выступать в роли адресатов уведомлений в Home Assistant. Это означает, что вы можете настроить автоматизации Home Assistant на отправку голосовых уведомлений напрямую на ваши устройства OVOS, позволяя им «озвучивать» оповещения, напоминания или любую другую настроенную вами информацию. Это предоставляется как сущность-уведомитель «Speak» в Home Assistant.
Интеграция с медиаплеером и Music Assistant:
Устройства OVOS также отображаются как стандартные медиаплееры в Home Assistant, так что вы можете управлять воспроизведением из обычного интерфейса медиаплеера. Та же интеграция распространяется на Music Assistant: транслируйте музыку через ваши устройства OVOS, и они станут частью вашей аудиосистемы всего дома.
Управление сущностями Home Assistant из OVOS
Поддерживаемый сообществом skill-homeassistant даёт OVOS прямое управление сущностями Home Assistant через REST API HA. Установите его на ваше устройство OVOS, и вы сможете сказать «включи свет в гостиной» или «установи термостат на 21 градус» — полностью локально, без облака.
Что пока сыровато
Мосты Wyoming и интеграция HiveMind — самые зрелые части этой связки; путь с persona-server в роли разговорного агента новее, и его стоит опробовать в первую очередь, если хотите увидеть потолок возможностей связки OVOS + HA. Сообщения об ошибках и PR приветствуются во всех репозиториях, указанных выше.
OpenVoiceOS — это проект сообщества. Если вы считаете, что голосовые ассистенты должны быть открытыми, инклюзивными и подконтрольными пользователю, поддержите проект финансированием, открытыми данными или переводами.