Настройка с акаунт на 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 автоматично ще стартира процес на повторно удостоверяване, изисквайки повторно въвеждане на данните за акаунта.