Налаштування з локальним підключенням Не рекомендовано

Цей метод слід використовувати для встановлення прямого локального підключення до робот-пилососа без залежності від постійного з'єднання з хмарою. Щоб використати цей метод, пристрій повинен бути успішно доданий до офіційного додатку Xiaomi Home (доступного для iOS та Android) хоча б один раз для генерації дійсного токена. Крім того, він повинен залишатися прив'язаним до облікового запису під час цього кроку налаштування, щоб інтеграція могла отримати необхідну IP-адресу та токен з хмари.

Сумісність пристрою

Цей метод підключення підтримується виключно для пристроїв, вироблених до 2022 року, які підтримуються додатком Xiaomi Home. Якщо пристрій не можна додати до додатку Xiaomi Home, він за жодних обставин не надасть локальний API з будь-яким токеном.

Підтримка карти відсутня Не рекомендовано

Технічно неможливо отримати дані карти через локальний API. В результаті метод локального з'єднання забезпечує відсутність підтримки карти, що повністю відключає кілька основних функцій, які залежать від даних карти, таких як Історія прибирань, Відновлення карт та динамічні Сутності кімнати. Оскільки карта та залежні від неї функції є центральними для основної функціональності інтеграції, цей метод з'єднання суворо не рекомендується. Для повного та повноцінного досвіду настійно рекомендується використовувати один із методів підключення через хмару.

Отримання IP та токена

Для налаштування локального з'єднання ви повинні вручну вказати IP-адресу пристрою та токен.

Вимога щодо підмережі

З міркувань безпеки пристрій відповідає лише на запити із власної підмережі. Тому робот-пилосос і Home Assistant повинні знаходитися в одній і тій же підмережі, щоб локальна комунікація працювала. Дивіться цю статтю python-miio для вирішення проблем із крос-підмережами.

Метод 1: Xiaomi Cloud Tokens Extractor Рекомендовано

Це найнадійніший метод. Він працює на Windows, macOS або Linux, підключаючись безпосередньо до хмарних серверів Xiaomi для отримання IP-адрес та токенів для всіх пристроїв, пов’язаних з обліковим записом, одночасно.

1. Завантажити інструмент: Завантажте відповідний реліз (наприклад, .exe для Windows) Xiaomi Cloud Tokens Extractor з GitHub.
2. Запустити додаток: Виконайте завантажений файл, щоб відкрити інтерфейс терміналу.
3. Ввести облікові дані: Вкажіть точний логін (Email або Xiaomi ID) та пароль, використані в додатку Xiaomi Home.
4. Вибрати регіон сервера: Вкажіть регіон сервера, що відповідає додатку Xiaomi Home (наприклад, de для Європи). Якщо регіон невідомий, залиште підказку порожньою та натисніть Enter, щоб сканувати всі доступні сервери.
5. Отримати токен: Інструмент виведе список усіх пристроїв, підключених до облікового запису. Знайдіть цільовий пилосос у списку та скопіюйте відповідний 32-символьний токен.

Метод 2: Десктопний графічний інтерфейс (Get_MiHome_devices_token)

Для користувачів, які віддають перевагу графічному інтерфейсу замість командного рядка, доступний десктопний додаток.

1. Завантажити додаток: Завантажте та встановіть додаток Get_MiHome_devices_token з GitHub.
2. Увійти: Відкрийте додаток, введіть дані облікового запису Xiaomi і виберіть відповідний регіон сервера.
3. Отримати токен: Після автентифікації всі підключені пристрої разом з їхніми IP-адресами та токенами будуть відображені у табличному форматі.

Метод 3: Модифікований додаток Mi Home для Android Не рекомендовано

Користувачі Android можуть використовувати модифіковану версію додатку Mi Home для перегляду токенів безпосередньо в інтерфейсі додатку на своїх мобільних пристроях.

1. Видалити оригінальний додаток: Повністю видаліть офіційний додаток Mi Home з Android-пристрою. (Примітка: Пристрої залишаться безпечно підключеними до хмарного облікового запису).
2. Встановити модифікований додаток: Знайдіть в Інтернеті модифікований APK "MiHome by Vevs", завантажте останню версію та встановіть її на пристрій.
3. Увійти: Відкрийте модифікований додаток та увійдіть, використовуючи облікові дані облікового запису Xiaomi.
4. Отримати токен: Виберіть цільовий пилосос, щоб відкрити його інтерфейс керування. Натисніть три крапки у верхньому правому куті, щоб отримати доступ до налаштувань, а потім перейдіть до розділу Інформація про мережу або Загальні налаштування. IP-адреса пристрою та токен будуть безпосередньо видимі на цьому екрані.