Налаштування з обліковим записом Xiaomi Home

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

Вимоги

• Облікові дані: Повинні бути точними ім'ям користувача та паролем, які використовуються для входу в мобільний додаток (не на офіційному вебсайті).
• Регіон серверу: Вибрана країна повинна відповідати регіону, де пристрій зареєстрований у додатку. Несумісні регіони призведуть до помилок "невдалий вхід" або "пристрій не знайдено".

Логіни через сторонні сервіси

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

Рекомендація щодо вибору додатку

Деякі пристрої можна налаштовувати за допомогою додатків Dreamehome або Xiaomi Home. Якщо локальне підключення не є суворо необхідним, настійно рекомендується використовувати додаток Dreamehome замість Xiaomi Home для підтримуваних пристроїв:

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

Віддати перевагу Cloud-варіанту

Під час етапу налаштування доступна додаткова опція Віддати перевагу Cloud, яка за замовчуванням є вибраною.

• При встановленій галочці (За замовчуванням): Примушує весь обмін даними йти через хмару (якщо пристрій це підтримує). Це поведінка за замовчуванням, оскільки на новіших пристроях 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 автоматично запустить процес повторної автентифікації, запрошуючи знову ввести облікові дані.