Skip to content

ЧАВО ​

Эта страница собирает вопросы, которые появляются снова и снова на Трекер проблем на GitHub. Проверка здесь перед открытием новой проблемы экономит время, так как большинство из них не являются ошибками, а ожидаемым поведением с документированной причиной.

Поиск существующих проблем

Ничего из этого? Убедитесь, что вы ищете на закрытые проблемы на GitHub перед открытием новой. Если проблема сохраняется, страница Сообщение о проблеме объясняет, как собрать журналы отладки и открыть правильный отчет об ошибке или запрос на функцию.

Можно ли отправлять уведомления на телефон? ​

Показать ответ

Непосредственно нет. По умолчанию интеграция создает только постоянные уведомления внутри панели управления Home Assistant; они не пересылаются автоматически в приложение Home Assistant Companion на мобильном устройстве, так как для этого требуется конкретная цель уведомления для каждого устройства, которой интеграция не обладает.

Чтобы получать их на телефоне, необходимо создать пользовательская автоматизация, который будет слушать события интеграции (или сгенерированные постоянные уведомления) и пересылать их на notify для мобильного устройства.

Подробнее о настройке того, какие уведомления генерируются

Фотографии препятствий / обнаружения ИИ не отображаются Поддержка карт ​

Показать ответ

Если изображения препятствий остаются пустыми даже при включенной функции Загрузка изображений препятствий ИИ в приложении, и учетная запись, подключенная к Home Assistant, является совместной/семейной учетной записью, а не учетной записью, которая изначально добавила и владеет устройством, облачное API производителя может тихо блокировать доступ к изображениям препятствий для этой совместной учетной записи. Использование фактической учетной записи владельца или проверка того, что доступ к камере явно предоставлен совместной учетной записи в приложении, в большинстве случаев решает эту проблему.

Можно ли транслировать камеру карты в HomeKit / Apple Home? Поддержка карт ​

Показать ответ

Ненадежно в качестве прямого просмотра. Камера карты транслирует в настоящем MJPEG, тем же методом, который использует собственная платформа камер Home Assistant, поэтому статическое изображение предварительного просмотра в Apple Home отображается корректно. Новый кадр генерируется только тогда, когда карта действительно изменяется, и поток не создает ничего, пока пылесос стоит без дела. Прямой просмотр HomeKit требует постоянно обновляющегося источника, чтобы оставаться подключенным, а Home Assistant должен конвертировать поток MJPEG через дополнительный слой, прежде чем HomeKit сможет его показать, так как HomeKit напрямую не принимает MJPEG. Когда поток карты замолкает, этот слой конверсии воспринимает соединение как потерянное, и Home Assistant сообщает, что у камеры нет источника потока, или отображает пустой видеопоток вместо живого изображения.

Это было сообщено несколько раз. Попытки использования платформы камеры ffmpeg, go2rtc и интеграции Generic Camera дают одинаковый результат: статический предварительный просмотр работает, но постоянно обновляемый живой поток в HomeKit не работает. Ни одна полностью работоспособная настройка для этой интеграции или для аналогичных потоков карт пылесоса где-либо еще не подтверждена.

Home Assistant зависает, перезапускается или использует много памяти Поддержка карт ​

Показать ответ

Интеграция отображает масштабируемые изображения карт в полном разрешении, аналогично официальному приложению, что может использовать значительное количество памяти. На системах с ограниченным объемом оперативной памяти, таких как Raspberry Pi, небольшая виртуальная машина или контейнер с лимитом около 2-3 ГБ, это может исчерпать доступную память и вызвать зависание Home Assistant, перезапуск или полную невозможность запуска, обычно сразу после добавления устройства с поддержкой карты или при открытии страницы устройства или камеры карты.

Исправление

Включите Изображение карты низкого разрешения в параметрах конфигурации устройства. Это решает подавляющее большинство таких случаев.

Если программа все еще аварийно завершает работу после включения этой опции, данные карты сами могли быть повреждены или со временем стали необычно большими, что также может увеличить использование памяти при рендеринге. Восстановление старой, исправной карты из Резервное копирование и восстановление может решить эту проблему. Если это не помогает, сбор логов отладки и откройте отчет об ошибке, так как это указывает на другую основную причину.

Интеграция не загружается после обновления Home Assistant, упоминая py_mini_racer Поддержка карт ​

Показать ответ

Интеграция зависит от py-mini-racer, движка JavaScript, который используется для оптимизации и рендеринга карт так, чтобы они соответствовали официальному приложению. Эта зависимость устанавливается самим Home Assistant, а не интеграцией, и иногда не удается установить ее или загрузить ее нативный бинарный файл после обновления Home Assistant Core, особенно на системах с musl (например, HAOS на некоторых платформах) или сразу после обновления.

Проблема с окружением

Это проблема с установкой окружения/зависимостей, а не что-то, что код интеграции может обнаружить или обойти. Она появляется снова и снова в разных версиях Home Assistant и типах установки.

Перезапуск Home Assistant (чтобы он попытался снова установить зависимости) в некоторых случаях решает проблему. Если она сохраняется, проверьте журнал Home Assistant при запуске на наличие фактической ошибки установки pip/зависимости; именно эту ошибку нужно исправить (в том числе как проблему Home Assistant Core, если это выглядит как сбой установки на уровне платформы).

Можно ли использовать устройство с Valetudo с этой интеграцией? ​

Показать ответ

Да и нет. Технически нет ограничений, препятствующих работе интеграции вместе с Valetudo. Valetudo не отключает локальный miIO API, поэтому устройство можно управлять через Локальное подключение, пока можно получить токен. Однако данные карты нельзя получить через локальный API, и Valetudo не предоставляет необработанные данные карты через сервис. Поэтому интеграция может работать только без поддержки карты.

Без поддержки карты функциональность, предоставляемая этой интеграцией, становится в значительной степени избыточной, так как все оставшиеся функции уже можно использовать через нативный Интеграция Valetudo Home Assistant MQTT.