Aqara G4 в Home Assistant через go2rtc и WebRTC Camera

Умный дверной звонок Aqara Video Doorbell G4 удобно подключать к Home Assistant через HomeKit, а нормальный видеопоток с низкой задержкой получать через дополнение go2rtc и карточку WebRTC Camera.

В этой инструкции: добавление G4 через HomeKit, установка go2rtc из репозитория AlexxIT, конфиг потока и карточка на дашборде.

Из всего, что пробовал, это единственный способ, которым удалось получить в Home Assistant стабильную и качественную картинку с Aqara G4. Встроенный просмотр через HomeKit без go2rtc обычно тормозит и для дашборда малопригоден; другие варианты стрима либо не заводились, либо давали хуже качество и стабильность. Минус схемы — звук так и не заработал (об этом ниже).

1. Добавьте Aqara G4 в Home Assistant через HomeKit

Сначала звонок нужно добавить в HA как устройство HomeKit (интеграция HomeKit Device / HomeKit Controller). Код сопряжения обычно на корпусе или в приложении Aqara.

После добавления устройство появится в Home Assistant. В нашем случае оно получило имя:

Doorbell Repeater-6B47

Именно это имя дальше используется в конфиге go2rtc в источнике hass:…. Сущность камеры при этом будет вроде camera.doorbell_repeater_6b47 (пробелы и дефисы превращаются в подчёркивания, буквы — в нижний регистр).

Встроенный просмотр камеры HomeKit в HA часто тормозит и неудобен для дашборда — поэтому подключаем go2rtc.

2. Добавьте репозиторий и установите go2rtc

1. Откройте Настройки → Дополнения → Магазин дополнений.
2. Меню (три точки) → Репозитории.
3. Добавьте:
   https://github.com/AlexxIT/hassio-addons
4. Обновите список и установите дополнение go2rtc.
5. Запустите его и включите автозапуск (по желанию — «Показывать в боковой панели»).

Репозиторий: AlexxIT/hassio-addons.

3. Конфигурация потока Aqara G4 в go2rtc

В настройках дополнения go2rtc (или в его YAML-конфиге) добавьте поток. Источник hass: берёт уже спаренную через HomeKit камеру из Home Assistant по имени устройства:

streams:
  aqara_g4:
    - hass:Doorbell Repeater-6B47
    - ffmpeg:aqara_g4#audio=aac#audio=opus

Что здесь происходит:

• hass:Doorbell Repeater-6B47 — видео (и исходное HomeKit-аудио) с устройства, которое уже есть в HA;
• ffmpeg:aqara_g4#audio=aac#audio=opus — попытка перекодировать звук HomeKit (AAC-ELD) в AAC/Opus для WebRTC. На практике звук через эту схему у нас так и не заработал — остаётся только видео.

Если у вас другое имя устройства в HA — подставьте его вместо Doorbell Repeater-6B47 один в один, как в карточке устройства.

Сохраните конфиг и перезапустите go2rtc. В веб-интерфейсе дополнения в списке streams должен появиться aqara_g4.

Важно про звук: конфиг с #audio=aac#audio=opus оставляем как рекомендуют для HomeKit-камер, но в нашем случае аудиопоток с Aqara G4 через go2rtc так и не заработал. Видео на карточке WebRTC есть, звука нет.

4. Карточка WebRTC Camera на дашборде

Для просмотра с низкой задержкой нужна кастомная карточка WebRTC Camera из интеграции AlexxIT/WebRTC. Обычная карточка «Камера» в HA для HomeKit-потока подходит хуже — выше задержка и меньше контроля над стримом.

Установка интеграции WebRTC

1. Установите HACS, если его ещё нет.
2. В HACS откройте Интеграции → поиск WebRTC Camera (автор AlexxIT) → Скачать.
3. Перезапустите Home Assistant.
4. Перейдите в Настройки → Устройства и службы → Добавить интеграцию → найдите WebRTC Camera и добавьте её.

После этого тип карточки custom:webrtc-camera станет доступен в редакторе дашборда.

Как добавить карточку

1. Откройте нужную панель (Overview / дашборд) и нажмите карандаш «Изменить панель» в правом верхнем углу.
2. Нажмите «Добавить карточку» (или «+»).
3. Внизу списка выберите «Вручную» / Manual — откроется YAML-редактор. Либо найдите карточку WebRTC, если она уже появилась в каталоге, и переключитесь в режим кода.
4. Вставьте конфигурацию:

type: custom:webrtc-camera
entity: camera.doorbell_repeater_6b47

5. Нажмите «Сохранить» у карточки, затем «Готово» у панели.

entity — ID камеры HomeKit в HA. В примере это camera.doorbell_repeater_6b47, потому что устройство называется Doorbell Repeater-6B47. Свой ID посмотрите так:

• Настройки → Устройства и службы → Устройства → откройте Doorbell Repeater-6B47 → сущность типа Camera;
• или в режиме разработчика: Инструменты разработчика → Состояния, фильтр camera..

Если имя устройства у вас другое — подставьте свой entity_id, иначе карточка будет пустой или с ошибкой.

Если карточка не появляется или пишет ошибку

• «Custom element doesn’t exist: webrtc-camera» — интеграция WebRTC не установлена или HA не перезапускали после установки через HACS. Обновите страницу с очисткой кэша (Ctrl+F5).
• Чёрный экран / нет картинки — проверьте, что go2rtc запущен, в его streams есть aqara_g4, а entity в карточке совпадает с реальной камерой.
• Есть видео, но нет звука — для Aqara G4 через HomeKit + go2rtc это частая ситуация: строка ffmpeg:…#audio=aac#audio=opus в конфиге есть, но звук так и не удалось добавить. Карточка WebRTC при этом нормально показывает картинку.

Краткий чеклист

1. Aqara G4 добавлен в HA через HomeKit → имя вроде Doorbell Repeater-6B47.
2. Репозиторий https://github.com/AlexxIT/hassio-addons → установлено дополнение go2rtc.
3. В go2rtc прописан stream aqara_g4 с hass:… и ffmpeg:…#audio=aac#audio=opus.
4. На дашборде карточка custom:webrtc-camera с entity вашей камеры.

После этого звонок с камерой Aqara G4 можно смотреть в Home Assistant через go2rtc с низкой задержкой и нормальным качеством картинки — для меня это пока единственный рабочий вариант стабильного видео с G4 в HA. Со звуком в связке HomeKit → go2rtc → WebRTC так и не вышло: рассчитывайте на картинку без аудио или ищите отдельный способ вывода звука.