Nastavení s účtem Xiaomi Home

Tato metoda by měla být použita, pokud je robotický vysavač aktuálně spravován prostřednictvím aplikace Xiaomi Home. Pro zajištění kompatibility lze ověřit proti oficiální aplikaci Xiaomi Home dostupné pro iOS a Android.

Požadavky

• Přihlašovací údaje: Musí jít přesně o uživatelské jméno a heslo používané k přihlášení do mobilní aplikace (ne na oficiálních webových stránkách).
• Region serveru: Vybraná země musí odpovídat regionu, kde je zařízení registrováno v aplikaci. Nesoulad regionů povede k chybám "přihlášení selhalo" nebo "zařízení nenalezeno".

Přihlášení třetích stran

Pokud byl účet vytvořen prostřednictvím služby třetí strany (například Google nebo Apple), musí být nejprve v nastavení uživatele aplikace vygenerováno speciální heslo. Hesla účtů třetích stran nelze použít pro ověřování.

Doporučení výběru aplikace

Některá zařízení lze konfigurovat buď pomocí aplikace Dreamehome, nebo Xiaomi Home. Pokud místní připojení není striktně vyžadováno, důrazně se doporučuje používat aplikaci Dreamehome namísto Xiaomi Home pro podporovaná zařízení:

• Přenos kamery: Funkce přenosu kamery není dostupná pro zařízení konfigurovaná přes Xiaomi Home.
• Push aktualizace: Připojení Dreamehome využívá Cloud Push pro aktualizace v reálném čase, čímž eliminuje potřebu periodických požadavků na dotazování.

Preferovat cloudovou možnost

Během konfiguračního kroku je k dispozici další možnost Preferovat cloud, která je zaškrtnuta ve výchozím nastavení.

• Když je zaškrtnuto (Výchozí): Nutí veškerou komunikaci přes cloud (pokud je podporováno zařízením). Toto je výchozí chování, protože na novějších zařízeních Xiaomi zakázalo možnosti lokálního přístupu. Dále, pokud se zařízení a Home Assistant nacházejí na různých podsítích, lokální komunikace selže.
• Když není zaškrtnuto (Doporučeno pro podporovaná nastavení): Integrace získá potřebný token z cloudu, ale naváže přímé lokální spojení se zařízením (podobně jako metoda Lokální připojení). Toto poskytuje výhodu automatického obnovování tokenu a IP adresy, přičemž veškerá komunikace (kromě dat mapy) zůstává lokální. Pokud tato metoda na posledním kroku konfigurace způsobí chybu „nelze dosáhnout zařízení“, měla by se konfigurace zopakovat se zaškrtnutou možností Preferovat Cloud.

  Požadavek na podsíť

  Z bezpečnostních důvodů zařízení reaguje pouze na požadavky pocházející z jeho vlastní podsítě. Proto musí být robotický vysavač a Home Assistant ve stejné podsíti, aby místní komunikace fungovala. Podívejte se na tento článek python-miio pro řešení problémů s komunikací mezi různými podsítěmi.

Ověření Captcha

Pokud servery Xiaomi Home označí pokus o přihlášení nebo IP adresu jako nedůvěryhodnou, bude vyžadován krok ověření captcha. V takovém případě musí být obrázek captcha vyřešen, aby bylo možné pokračovat do dalšího kroku.

Dvoufaktorová autentizace (2FA)

Kromě captcha může nedůvěryhodný pokus o přihlášení spustit také dvoufaktorovou autentizaci (2FA). Integrace automaticky požádá servery Xiaomi Home o kód 2FA, který je zaslán na registrované telefonní číslo (preferované) nebo e-mailovou adresu.

Tento kód musí být získán a zadán do konfiguračního kroku pro dokončení přihlášení.

Omezení 2FA

• Platnost kódu: Pokud je konfigurační okno zavřeno a je proveden nový pokus o přihlášení, bude vygenerován nový 2FA kód. Vždy musí být použit nejnověji obdržený kód.
• Omezení rychlosti: Xiaomi přísně omezuje počet 2FA kódů, které lze za den požadovat. Opakované pokusy o přihlášení mohou vést k dočasnému zablokování.

Periodické aktualizace stavu

Na rozdíl od jiných metod připojení k cloudu, které podporují push notifikace, připojení Xiaomi Home se zcela spoléhá na pozadní dotazování, aby bylo možné získat nejnovější stav. Pro optimalizaci využití sítě je interval dotazování dynamicky vypočítáván na základě doby uplynulé od poslední změny stavu; požadavky jsou odesílány často, když je zařízení aktivně v provozu, ale interval se postupně prodlužuje, jakmile zařízení zůstává nečinné.

Znovuověřování

Integrace bezpečně uchovává ověřovací token po úspěšném přihlášení, aby mohla komunikovat s cloudovými servery. Pokud tento token vyprší nebo bude zneplatněn cloudovou službou z jakéhokoli důvodu, Home Assistant automaticky spustí proces znovuověřování a vyzve k opětovnému zadání přihlašovacích údajů účtu.