Nastavenie s účtom Xiaomi Home

Túto metódu treba použiť, ak je robotický vysávač momentálne spravovaný cez aplikáciu Xiaomi Home. Pre zaistenie kompatibility sa dá overiť prostredníctvom oficiálnej aplikácie Xiaomi Home dostupnej pre iOS a Android.

Požiadavky

• Prístupové údaje: Musia byť presne tieto používateľské meno a heslo používané na prihlásenie sa do mobilnej aplikácie (nie na oficiálnej webovej stránke).
• Región servera: Vybraná krajina musí zodpovedať regiónu, kde je zariadenie registrované v aplikácii. Nesprávne regióny povedú k chybám „prihlásenie zlyhalo“ alebo „zariadenie nenájdené“.

Prihlásenia tretích strán

Ak bol účet vytvorený pomocou služby tretej strany (napríklad Google alebo Apple), najprv musí byť v nastaveniach používateľa aplikácie vygenerované špeciálne heslo. Heslá účtov tretích strán sa na autentifikáciu použiť nedajú.

Odporúčanie výberu aplikácie

Niektoré zariadenia sa dajú konfigurovať pomocou aplikácie Dreamehome alebo Xiaomi Home. Pokiaľ nie je striktne potrebné lokálne pripojenie, dôrazne sa odporúča použiť aplikáciu Dreamehome namiesto Xiaomi Home pre podporované zariadenia:

• Stream z kamery: Funkcia streamovania z kamery nie je dostupná pre zariadenia konfigurované cez Xiaomi Home.
• Push aktualizácie: Pripojenie Dreamehome využíva Cloud Push pre aktualizácie v reálnom čase, čím eliminuje potrebu periodických dopytov.

Uprednostniť cloudovú možnosť

Počas kroku konfigurácie je k dispozícii ďalšia možnosť Uprednostniť cloud, ktorá je predvolene zaškrtnutá.

• Ak je začiarknuté (Predvolené): Vynucuje všetku komunikáciu prostredníctvom cloudu (ak zariadenie podporuje). Toto je predvolená funkcia, pretože na novších zariadeniach Xiaomi deaktivovalo možnosti miestneho prístupu. Okrem toho, ak sa zariadenie a Home Assistant nachádzajú na rôznych podsietiach, miestna komunikácia zlyhá.
• Ak nie je začiarknuté (Odporúčané pre podporované nastavenia): Integrácia získa potrebný token z cloudu, ale nastaví priamu miestnu spojenie so zariadením (podobne ako Lokálne pripojeniemetóda). Toto poskytuje výhodu automatického obnovovania tokenu a IP, pričom všetka komunikácia (okrem údajov mapy) zostáva lokálna. Ak táto metóda vyústi do chyby „zariadenie sa nedá dosiahnuť“ na poslednom kroku konfigurácie, konfiguráciu je potrebné opakovať s začiarknutou možnosťou Preferovať cloud.

  Požiadavka na podsieť

  Z bezpečnostných dôvodov zariadenie reaguje iba na požiadavky pochádzajúce z jeho vlastnej podsiete. Preto musí byť robotický vysávač a Home Assistant na presne rovnakej podsieti, aby lokálna komunikácia fungovala. Pozrite si tento článok python-miio na riešenie problémov s komunikáciou medzi podsieťami.

Overenie Captcha

Ak servery Xiaomi Home označia prihlasovací pokus alebo IP adresu ako nedôveryhodnú, bude potrebný krok overenia captcha. V takom prípade je potrebné vyriešiť captcha obrázok, aby ste mohli pokračovať na ďalší krok.

Dvojfaktorová autentifikácia (2FA)

Okrem captchy môže nedôveryhodný prihlasovací pokus spustiť aj dvojfaktorovú autentifikáciu (2FA). Integrácia automaticky požiada o 2FA kód zo serverov Xiaomi Home, ktorý je zaslaný na registrované telefónne číslo (uprednostňované) alebo e-mailovú adresu.

Tento kód je potrebné získať a zadať do konfiguračného kroku, aby sa dokončilo prihlásenie.

Obmedzenia 2FA

• Platnosť kódu: Ak je konfiguračné okno zatvorené a je vykonaný nový pokus o prihlásenie, bude vygenerovaný nový 2FA kód. Vždy je potrebné použiť najnovšie prijatý kód.
• Obmedzenie rýchlosti: Xiaomi prísne obmedzuje počet 2FA kódov, ktoré je možné požiadať za deň. Opakované pokusy o prihlásenie môžu viesť k dočasnému zablokovaniu.

Periodické aktualizácie stavu

Na rozdiel od iných metód cloudového pripojenia, ktoré podporujú push notifikácie, pripojenie Xiaomi Home sa úplne spolieha na pozadie pollingu na získanie najnovšieho stavu. Na optimalizáciu využitia siete sa interval pollingu dynamicky vypočítava na základe času uplynutého od poslednej zmeny stavu; požiadavky sa posielajú často, keď je zariadenie aktívne, ale interval sa postupne zvyšuje, keď zariadenie ostáva nečinné.

Znova autentifikácia

Integrácia bezpečne ukladá autentifikačný token po úspešnom prihlásení, aby komunikovala s cloudovými servermi. Ak tento token vyprší alebo bude cloudovou službou z nejakého dôvodu zneplatnený, Home Assistant automaticky spustí postup znovu autentifikácie, pričom vyžaduje opätovné zadanie prihlasovacích údajov účtu.