Настройка с учетной записью Xiaomi Home

Этот метод следует использовать, если робот-пылесос в настоящее время управляется через приложение Xiaomi Home. Для обеспечения совместимости его можно проверить через официальное приложение Xiaomi Home, доступное для iOS и Android.

Требования

• Учетные данные: Должны быть точным именем пользователя и паролем, используемыми для входа в мобильное приложение (не на официальном сайте).
• Регион сервера: Выбранная страна должна соответствовать региону, в котором устройство зарегистрировано в приложении. Несоответствие регионов приведет к ошибкам «не удалось войти» или «устройство не найдено».

Вход через сторонние сервисы

Если учетная запись была создана с использованием стороннего сервиса (например, Google или Apple), сначала необходимо сгенерировать специальный пароль в настройках пользователя приложения. Пароли сторонних учетных записей нельзя использовать для аутентификации.

Рекомендации по выбору приложения

Некоторые устройства можно настроить с помощью приложения Dreamehome или Xiaomi Home. Если локальное подключение строго не требуется, настоятельно рекомендуется использовать приложение Dreamehome вместо Xiaomi Home для поддерживаемых устройств:

• Поток камеры: Функция потоковой передачи с камеры недоступна для устройств, настроенных через Xiaomi Home.
• Push-обновления: Подключение Dreamehome использует Cloud Push для обновлений в режиме реального времени, что исключает необходимость периодических запросов.

Предпочтительный облачный вариант

На шаге конфигурации доступна дополнительная опция Предпочитать облако, которая отмечена по умолчанию.

• Когда выбрано (По умолчанию): Принудительно направляет все взаимодействие через облако (если устройство поддерживает это). Это поведение является стандартным, потому что на новых устройствах Xiaomi отключила возможность локального доступа. Более того, если устройство и Home Assistant находятся в разных подсетях, локальное взаимодействие не будет работать.
• Когда не выбрано (Рекомендуется для поддерживаемых конфигураций): Интеграция получает необходимый токен из облака, но устанавливает прямое локальное соединение с устройством (аналогично методу Локальное подключение). Это обеспечивает автоматическое обновление токена и IP, при этом все взаимодействие (кроме данных карты) осуществляется локально. Если этот метод вызывает ошибку "не удается подключиться к устройству" на последнем этапе настройки, конфигурацию следует повторить с отмеченной опцией Предпочтение облака.

  Требование к подсети

  По соображениям безопасности устройство отвечает только на запросы, исходящие из его собственной подсети. Поэтому робот-пылесос и Home Assistant должны находиться в одной и той же подсети для работы локальной связи. См. эту статью python-miio для устранения проблем при подключении через разные подсети.

Проверка Captcha

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

Двухфакторная аутентификация (2FA)

Помимо Captcha, ненадежная попытка входа может также вызвать двухфакторную аутентификацию (2FA). Интеграция автоматически запросит 2FA код с серверов Xiaomi Home, который отправляется на зарегистрированный номер телефона (в приоритете) или адрес электронной почты.

Этот код необходимо получить и ввести на этапе настройки, чтобы завершить вход.

Ограничения 2FA

• Действительность кода: Если окно конфигурации закрыто и выполняется новая попытка входа, будет сгенерирован новый код 2FA. Всегда необходимо использовать самый недавно полученный код.
• Ограничение частоты: Xiaomi строго ограничивает количество кодов 2FA, которые можно запросить в течение дня. Повторные попытки входа могут привести к временной блокировке.

Периодические обновления состояния

В отличие от других методов подключения к облаку, которые поддерживают push-уведомления, подключение Xiaomi Home полностью зависит от фонового опроса для получения последнего состояния. Чтобы оптимизировать использование сети, интервал опроса динамически рассчитывается на основе времени, прошедшего с момента последнего изменения состояния; запросы отправляются часто, когда устройство активно работает, но интервал постепенно увеличивается по мере того, как устройство остается в режиме ожидания.

Повторная аутентификация

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