English | Русский

Ваши домофоны, камеры и замки Электронного города (Новотелеком) и Дом.ру — прямо в Home Assistant. Гость позвонил в дверь — вы мгновенно видите видео, слышите звук, отвечаете голосом и открываете дверь одним касанием, даже если вы не дома.

Интеграция воспроизводит API официальных приложений «Мой Дом» и «Умный Дом.ру»: смотрите камеры со звуком, принимайте и завершайте вызовы, просматривайте историю принятых и пропущенных звонков и стройте на этом любые автоматизации Home Assistant.

🛠️ 4.0.1 — рекомендуемое обновление для пользователей 4.0.0: звонки снова доходят через FCM, ошибочное соединение больше не может подвесить Home Assistant или бесконечно раздувать журнал. Установите 4.0.1 через HACS, когда обновление будет предложено, и перезапустите Home Assistant; повторная авторизация не нужна. Подробности — в release notes.

• Установка
• Конфигурация
• Удаление
• Что нового в 4.1.0
• Что было в 4.0.1
• Главное в ветке 4.0
• Возможности
• Подключение камер через go2rtc
• 🔔 Событие звонка в домофон (FCM push)
• 📞 Двусторонний звук
• 🕘 История событий
• 🎞 Архив камер в медиабраузере
• Пример автоматизации: баланс
• Проблемы и вклад
• Лицензия

• Архив камер в медиабраузере: в разделе «Мультимедиа» появился источник «Электронный город» — аккаунт → адрес → камера → день → события движения.
• Просмотр записи прямо в браузере: клип открывается по клику, перемотка работает.
• Глубина по сроку хранения оператора: 14 дней для домофонов, 7 дней для остальных камер. Запрос за пределами окна даёт понятное сообщение, а не ошибку камеры.
• Скрытые камеры остаются скрытыми: камеры, выключенные переключателем «Показывать на панели», не попадают в архив ни в списке, ни при воспроизведении.
• Ссылка оператора не покидает сервер: Home Assistant забирает файл сам и отдаёт его по собственной короткоживущей ссылке; подписанный URL оператора не попадает ни в браузер, ни в журнал.
• Обновление без перенастройки: установите 4.1.0 через HACS и перезапустите Home Assistant. Переавторизация не нужна.

Обновление не содержит breaking changes. Подробности, ограничения среза и порядок обновления — в docs/releases/4.1.0.md. Изменения предыдущего выпуска описаны в docs/releases/4.0.1.md.

• Звонки снова доходят: интеграция разбирает новый VAPID-формат служебных FCM-заголовков, из-за которого событие вызова терялось до отправки в Home Assistant.
• Home Assistant не зависает: возвращён конечный предохранитель для повреждённого FCM-соединения; горячий цикл с постоянно растущим traceback больше не блокирует event loop.
• Журнал не разрастается бесконечно: после одной контрольной попытки circuit breaker ограничивает переподключения проблемного аккаунта и показывает понятное предупреждение в Repairs.
• Остальные функции продолжают работать: камеры, замки, баланс, история и другие аккаунты не останавливаются из-за сбоя FCM одной config entry.
• Обновление без перенастройки: установите 4.0.1 через HACS и перезапустите Home Assistant. Удалять интеграцию или проходить авторизацию заново не нужно.

Обновление не содержит breaking changes. Причина, проверка на реальном звонке и пошаговое обновление описаны в docs/releases/4.0.1.md.

• Вызов без polling: входящий звонок приходит через FCM и сразу доступен автоматизациям Home Assistant.
• Ответ и разговор: SIP-приём, завершение вызова, видео и звук гостя, микрофон браузера и сервисы elektronny_gorod.answer / hangup.
• Готовый экран вызова: custom:eg-intercom-call-card объединяет видео, ответ, микрофон, звук и безопасное открытие двери; поддерживает телефон, desktop и настенную панель.
• История событий: custom:eg-event-history-card показывает принятые и пропущенные вызовы, группирует их по датам и устройствам и объединяет несколько мест или аккаунтов.
• События для автоматизаций: новые принятые и пропущенные вызовы появляются как HA event entities. История движения камеры доступна отдельной сущностью, отключённой по умолчанию; её включение запускает polling выбранной камеры.
• Стабильный внешний RTSP: включённые камеры можно отдельно опубликовать через go2rtc для NVR, медиаплеера или другой локальной системы. Публикация выключена по умолчанию; скрытые камеры подключаются отдельной настройкой.
• Обновление без перенастройки: повторно добавлять интеграцию в Home Assistant не требуется.
• Надёжность: исправлены FCM reconnect/watchdog, смена звонящего, конкурентное открытие call-video и lifecycle SIP/go2rtc.

Большой обзор возможностей, появившихся в 4.0.0, ограничения и первоначальная настройка собраны в docs/releases/4.0.0.md.

Скопируйте директорию custom_components/elektronny_gorod в директорию config/custom_components вашего Home Assistant.

git clone https://github.com/gentslava/elektronny-gorod.git
cp -r elektronny-gorod/custom_components/elektronny_gorod YOUR_HASS_CONFIG_DIR/custom_components/

Перезапустите Home Assistant.

Номер телефона или договора, привязанный к вашей учётной записи у оператора, и доступ к SMS на этот номер. Если у оператора для вашей учётной записи задан пароль, SMS не потребуется — пароль спросят вместо кода.

go2rtc не обязателен. Без него камеры работают, но без звука; подробнее — в разделе Подключение камер через go2rtc.

или вручную:

1. Перейдите в интерфейс Home Assistant.
2. Перейдите в Конфигурация -> Интеграции.
3. Нажмите кнопку "+" для добавления новой интеграции.
4. Найдите "Электронный город" и выберите его.
5. Следуйте инструкциям на экране для завершения настройки интеграции.

Одну и ту же учётную запись можно добавить несколько раз — по одной записи на договор.

Задаются при настройке и потом меняются в «Настроить» у записи интеграции.

Публикация наружу включается вручную и по умолчанию выключена: постоянно поднятые потоки нагружают и оператора, и go2rtc.

1. Конфигурация → Устройства и службы → «Электронный город».
2. У нужной записи — меню «⋮» → «Удалить».

Что происходит при удалении:

• сущности, устройства и история их состояний удаляются вместе с записью;
• push-токен отвязывается у оператора, звонки в домофон перестают приходить на этот Home Assistant;
• потоки вида eg_<идентификатор камеры> остаются в конфигурации go2rtc — интеграция их не удаляет. Если go2rtc используется только для неё, эти строки можно убрать вручную из go2rtc.yaml.

Чтобы убрать саму интеграцию, а не только учётную запись: в HACS откройте «Электронный город» и выберите «Удалить», либо, при ручной установке, удалите директорию custom_components/elektronny_gorod. После этого перезапустите Home Assistant.

• Интеграция с сервисами Электронный Город и Дом.ру (работает с приложениями Мой Дом и Умный Дом.ру).
• Просмотр доступных договоров и добавление нужных в любом количестве.
• Запрос и ввод SMS-кода или пароля для аутентификации.
• Добавление доступных домофонов, камер и замков.
• Получение превью и потоков с домофонов и камер.
• Управление открытием замков в реальном времени.
• Событие звонка в домофон в реальном времени (FCM push) — event-сущность для уведомлений и автоматизаций (показать камеру, открыть дверь).
• Двусторонний звук с домофоном ⚠️ продвинутая фича — принять вызов (answer/hangup), видео+звук гостя одной карточкой и разговор через микрофон браузера (см. раздел ниже).
• История принятых и пропущенных вызовов — отдельные сущности по местам и общая Lovelace-карточка с фильтрами и постраничной загрузкой.
• Архив записей камер в медиабраузере — просмотр событий движения по дням и воспроизведение клипов с перемоткой (см. раздел ниже).
• Состояние аккаунта: баланс, дни до блокировки и признак блокировки.
• Управление режимом «Не беспокоить» для домофонных и управляющих звонков.

Создаваемые типы сущностей: camera (обычное и активное call-video), lock (открытие двери), event (вызовы и история), sensor (баланс, дни до блокировки, состояние вызова), binary_sensor и switch.

go2rtc: Интеграция может использовать уже работающий экземпляр go2rtc. Если его ещё нет, самый простой вариант — установить WebRTC Camera через HACS: компонент сам загрузит и запустит go2rtc внутри Home Assistant.

Поддерживается интеграция с go2rtc для камер Электронного города и Дом.ру. Этот способ позволяет:

• Получать аудиопоток с камер (звук).
• Получать более быстрый и стабильный видеопоток (низкая задержка, меньше обрывов).
• Опционально публиковать готовые потоки по стабильным RTSP-адресам для NVR, медиаплееров и других локальных клиентов.

Интеграции нужен доступный экземпляр go2rtc с HTTP API и RTSP-портом. Добавлять камеры из интеграции в go2rtc.yaml вручную не требуется: потоки создаются и обновляются автоматически.

Можно использовать существующий go2rtc — например, отдельный add-on, контейнер или сервер в локальной сети:

1. Убедитесь, что Home Assistant видит HTTP API go2rtc (обычно http://HOST:1984) и RTSP-порт 8554.
2. При добавлении интеграции выберите «Настроить go2rtc» и укажите URL API.
3. Если на go2rtc настроена Basic Auth, укажите имя пользователя и пароль в той же форме.

Для отдельного контейнера или сервера используйте его имя хоста либо локальный IP-адрес, доступный из Home Assistant. Адрес 127.0.0.1 подходит только тогда, когда go2rtc запущен в том же окружении, что и Home Assistant Core.

WebRTC Camera автоматически загружает и запускает собственный go2rtc, поэтому отдельный add-on или ручная установка бинарного файла не нужны:

1. Откройте HACS → Интеграции, найдите WebRTC и установите компонент.
2. Перезапустите Home Assistant.
3. Откройте Настройки → Устройства и службы → Добавить интеграцию → WebRTC.
4. В настройках интеграции включите go2rtc и оставьте стандартный адрес http://127.0.0.1:1984.

Вместе с компонентом станет доступна Lovelace-карточка с низкой задержкой и звуком:

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

Замените camera.YOUR_INTERCOM на идентификатор нужной камеры из Home Assistant. При управлении ресурсами Lovelace через YAML выполните дополнительный шаг из документации WebRTC Camera.

Откройте её параметры и включите go2rtc — повторно добавлять учётную запись и устройства не требуется.

Примечание: Для работы аудио и низкой задержки используйте актуальные версии go2rtc, WebRTC Camera и Home Assistant.

В настройках интеграции go2rtc появились две отдельные опции:

• «Публиковать включённые камеры для внешнего RTSP» — создаёт стабильные потоки только для включённых в Home Assistant сущностей камер.
• «Также публиковать скрытые камеры» — дополнительно включает скрытые сущности и работает только вместе с основной опцией. Отключённые сущности камер не публикуются никогда.

Обе опции по умолчанию выключены. Для опубликованных камер интеграция сразу запускает фоновый go2rtc consumer: он не даёт одноразовой операторской ссылке истечь до первого просмотра. Источник обновляется каждые 28 минут 30 секунд без сброса уже подключённого зрителя. Готовые адреса и фактическое состояние потоков отображаются диагностической сущностью «Опубликованные RTSP-потоки»; учётные данные go2rtc в её атрибуты не попадают.

Настройка публикации влияет только на фоновый keep-warm. Явное открытие включённой скрытой камеры в Home Assistant продолжает работать без постоянного preload. Интеграция не открывает RTSP-порт в Интернет — сетевой доступ, firewall, VPN и безопасность go2rtc остаются ответственностью пользователя.

Интеграция получает звонок в домофон в реальном времени через FCM-push — так же, как мобильное приложение, без облачного опроса. На каждый домофон создаётся сущность event с классом устройства doorbell:

• event.<домофон>_doorbell_call — стреляет ring при входящем вызове и ended при завершении (приняли на другом устройстве или истёк таймаут ожидания).
• Атрибуты события: event_type (ring/ended), gate_name (домофон), apartment (квартира), call_id, allow_open, reason.

На этом строятся автоматизации: пуш с кадром камеры и кнопкой «Открыть дверь», показ видео, открытие замка.

Канал — приватный FCM-приём (зависимость firebase-messaging ставится автоматически). Весь FCM-флоу под graceful degradation: при сбое остальная интеграция (камеры, замки, баланс) продолжает работать.

В примерах замените YOUR_INTERCOM / YOUR_PHONE на свои сущности (Инструменты разработчика → Состояния, фильтры event. / notify.mobile_app). Кадр в пуше и кнопки действий работают через приложение Home Assistant Companion (Android/iOS).

automation:
  - alias: "Домофон: уведомление о звонке"
    mode: parallel
    triggers:
      - trigger: state
        entity_id: event.YOUR_INTERCOM_doorbell_call
    conditions:
      - "{{ trigger.to_state.attributes.event_type == 'ring' }}"
    actions:
      - action: notify.mobile_app_YOUR_PHONE
        data:
          title: "🔔 Звонок в домофон"
          message: "{{ trigger.to_state.attributes.gate_name }} · кв. {{ trigger.to_state.attributes.apartment }}"

automation:
  # 1) Уведомление с превью камеры и кнопкой действия
  - alias: "Домофон: пуш с камерой и открытием"
    mode: parallel
    triggers:
      - trigger: state
        entity_id: event.YOUR_INTERCOM_doorbell_call
    conditions:
      - "{{ trigger.to_state.attributes.event_type == 'ring' }}"
    actions:
      - action: notify.mobile_app_YOUR_PHONE
        data:
          title: "🔔 Звонок в домофон"
          message: "{{ trigger.to_state.attributes.gate_name }}"
          data:
            image: "/api/camera_proxy/camera.YOUR_INTERCOM"
            tag: "doorbell"
            actions:
              - action: "OPEN_DOOR"
                title: "🔓 Открыть дверь"

  # 2) Обработчик кнопки: открыть замок домофона
  - alias: "Домофон: открыть дверь по кнопке пуша"
    triggers:
      - trigger: event
        event_type: mobile_app_notification_action
        event_data:
          action: "OPEN_DOOR"
    actions:
      - action: lock.unlock
        target:
          entity_id: lock.YOUR_INTERCOM

⚠️ Продвинутая фича. Приём вызова домофона по SIP — поверх события звонка выше. Работает удалённо (4G) через авторизованный канал Home Assistant, без экспозиции go2rtc наружу.

Поверх FCM-события интеграция умеет принять вызов и говорить с гостем у двери — как в мобильном приложении:

• Ответить / сбросить — сервисы elektronny_gorod.answer и elektronny_gorod.hangup (из автоматизации или кнопкой в пуше).
• Видео + звук гостя одной карточкой — на время активного вызова появляется сущность camera.<домофон>_intercom_call (HA-native WebRTC: видео домофона + звук гостя, работает на 4G без экспозиции go2rtc). Вне вызова сущность недоступна — карточку прячьте conditional-карточкой.
• Говорить (микрофон браузера → домофон) — Lovelace-карта custom:eg-intercom-mic-card с кнопкой «🎤 Говорить». Микрофон едет в домофон по тому же авторизованному WebSocket Home Assistant — без go2rtc/TURN.

Готовая Lovelace-карта custom:eg-intercom-call-card — весь вызов одним экраном: видео гостя, «Открыть дверь» защищённым жестом, принять/завершить, микрофон. Ведётся по sensor.<домофон>_call_state, облик — на theme-токенах Home Assistant (тёмная/светлая), адаптив от телефона до настенной панели.

Входящий вызов видео до принятия, окно ответа, slide-to-open	Разговор LIVE, таймер, микрофон / звук / завершить	Светлая тема из коробки, на токенах HA

Нет доступа к микрофону баннер + «Разрешить»	Связь прервана плейсхолдер + «Повторить»	Нет активного вызова заглушка + точки доступа

Настенная панель / десктоп — 2 колонки: видео-герой + контролы (слайдер по центру, кнопки по нижней кромке)

Компактная карточка (layout: compact) — одна строка: мини-превью + статус + быстрые кнопки

Установка карты — см. call-card-install.md. UX-контракт и раскладки — call-card-ux-production.md.

Карта раздаётся интеграцией статикой. Добавьте её как Lovelace-ресурс (Настройки → Панели → ⋮ → Управление ресурсами → Добавить, тип JavaScript-модуль):

/elektronny_gorod_static/eg-intercom-mic-card.js

Затем на дашборд вызова (под видео, при активном разговоре):

type: custom:eg-intercom-mic-card

Браузер отдаёт микрофон только на HTTPS-origin (или localhost). После добавления ресурса обновите страницу с очисткой кэша.

Готовые blueprint-ы собирают экран вызова /doorbell-call/call: пуш будит телефон и одним тапом открывает в Home Assistant экран с видео, звуком гостя и кнопками «Ответить» / «Говорить» / «Открыть» / «Сбросить».

• doorbell_call_notify — пуш со снимком камеры + активная дверь (по разу на дверь);
• doorbell_screen_controller — SIP-состояние, «Открыть дверь» из пуша, сброс при старте (один на систему).

Пошаговая сборка (хелперы → blueprint-ы → дашборд → микрофон → pro-tip авто-звука) — в docs/features/intercom-two-way-audio/call-screen-setup.md. Установка карты микрофона и ограничения — в docs/features/intercom-two-way-audio/uplink-card-install.md.

Просматривайте принятые и пропущенные вызовы в отдельной карточке Home Assistant и используйте новые вызовы в автоматизациях.

Карточка истории входит в тот же файл, что и экран вызова. Добавьте ресурс один раз:

/elektronny_gorod_static/eg-intercom-call-card.js

Затем укажите сущность истории нужного места:

type: custom:eg-event-history-card
entity: event.account_123456_place_7890_event_history
title: События

Для нескольких мест или настроенных аккаунтов используйте entities: — карточка объединит ленты по времени и сохранит раздельные фильтры устройств. Тексты оператора и персональные данные в карточке не показываются.

Подробная настройка и ограничения: history-card.md.

Записи событий движения доступны в Мультимедиа → Электронный город. Дерево повторяет логику приложения: аккаунт → адрес → камера → день → события. Каждое событие подписано временем и длительностью записи; недоступные для просмотра помечены и не открываются.

Глубина списка соответствует сроку хранения у оператора: 14 дней для домофонов и 7 дней для остальных камер. Запрос за пределами этого окна даёт понятное сообщение, а не общую ошибку камеры.

Клип открывается по клику прямо в браузере, перемотка работает. Оператор готовит mp4 по требованию, поэтому первый клик по свежему событию занимает несколько секунд — интеграция дожидается готовности сама.

Что важно знать про доступ. Ссылка на запись, которую получает браузер, ведёт на сам Home Assistant и действует ограниченное время. Открывается она без повторного входа — так же устроены штатные прокси камер и TTS в Home Assistant, иначе тег <video> не смог бы забрать файл. Пересылать такую ссылку посторонним не стоит. Подписанная ссылка оператора при этом не покидает сервер и не попадает в журнал.

Камеры, скрытые переключателем «Показывать на панели», в архив не попадают — ни в списке, ни при попытке воспроизведения.

Ограничения текущего среза: доступны только клипы по событиям движения (перемотки по непрерывному таймлайну нет), эскизы событий не передаются, личные камеры не поддерживаются.

Вот пример автоматизации для уведомления о низком балансе:

automation:
  - alias: "Уведомление о низком балансе"
    trigger:
      - platform: numeric_state
        entity_id: sensor.elektronny_gorod_balance
        below: 100
    action:
      - service: notify.notify
        data:
          message: "Баланс вашего счета в Электронном городе ниже 100 рублей."

Если вы столкнулись с проблемами или у вас есть предложения по улучшению, пожалуйста, откройте issue на GitHub.

Не стесняйтесь вносить вклад в проект, форкнув репозиторий и создавая pull-запросы.

❤️ Спасибо всем донатерам, поддержавшим интеграцию рублём — ваша поддержка мотивирует развивать проект дальше.

Поддержать разработку:

Типы устройств Apple https://gist.github.com/adamawolf/3048717

go2rtc — проект для работы с потоковым видео и аудио

Эта интеграция лицензирована под лицензией MIT. См. файл LICENSE для подробностей.