Inställning med Xiaomi Home-konto

Denna metod ska användas om robotdammsugaren för närvarande hanteras via Xiaomi Home-applikationen. För att säkerställa kompatibilitet kan den verifieras mot den officiella Xiaomi Home-appen som finns för iOS och Android.

Krav

• Inloggningsuppgifter: Måste vara exakt samma användarnamn och lösenord som används för att logga in i mobilappen (inte på den officiella webbplatsen).
• Serverregion: Det valda landet måste överensstämma med regionen där enheten är registrerad i appen. Felaktiga regioner kommer att resultera i felmeddelanden som "inloggning misslyckades" eller "enhet hittades inte".

Tredjepartsinloggningar

Om kontot skapades med en tredjepartstjänst (såsom Google eller Apple) måste ett dedikerat lösenord först genereras inom applikationens användarinställningar. Lösenord för tredjepartskonton kan inte användas för autentisering.

Rekommendation för appval

Vissa enheter kan konfigureras med antingen Dreamehome- eller Xiaomi Home-applikationen. Om inte en lokal anslutning är strikt nödvändig rekommenderas det starkt att använda Dreamehome-appen istället för Xiaomi Home för stödda enheter:

• Kameraström: Kameraströmsfunktionen är inte tillgänglig för enheter som konfigurerats via Xiaomi Home.
• Push-uppdateringar: Dreamehome-anslutningen använder Cloud Push för realtidsuppdateringar, vilket eliminerar behovet av periodiska förfrågningar.

Föredra molnalternativ

Under konfigurationssteget finns ett extra Föredra molnet-alternativ tillgängligt och det är förvalt markerat.

• När ikryssad (Standard): Tvingar all kommunikation via molnet (om enheten stöds). Detta är standardbeteendet eftersom Xiaomi på nyare enheter har inaktiverat lokala åtkomstmöjligheter. Dessutom, om enheten och Home Assistant befinner sig på olika subnät, kommer lokal kommunikation att misslyckas.
• När inte ikryssad (Rekommenderas för stödda konfigurationer): Hämtar integrationen den nödvändiga token från molnet men etablerar en direkt lokal anslutning med enheten (liknande Lokal anslutning-metoden). Detta ger fördelen med automatisk förnyelse av token och IP samtidigt som all kommunikation (förutom kartdata) hålls lokal. Om denna metod resulterar i ett "kan inte nå enheten"-fel vid det sista konfigurationssteget, bör konfigurationen försöka igen med alternativet Föredra Moln ikryssat.

  Subnätkrav

  Av säkerhetsskäl svarar enheten endast på förfrågningar som kommer från dess eget subnät. Därför måste robotdammsugaren och Home Assistant vara på exakt samma subnät för att lokal kommunikation ska fungera. Se denna python-miio-artikel för felsökning av problem över subnät.

Captcha-verifiering

Om Xiaomi Home-servrarna markerar inloggningsförsöket eller IP-adressen som opålitlig krävs ett captcha-verifieringssteg. När detta inträffar måste captcha-bilden lösas för att gå vidare till nästa steg.

Tvåfaktorsautentisering (2FA)

Utöver en captcha kan ett opålitligt inloggningsförsök även utlösa tvåfaktorsautentisering (2FA). Integration kommer automatiskt att begära en 2FA-kod från Xiaomi Home-servrarna, som skickas till det registrerade telefonnumret (prioriterat) eller e-postadressen.

Denna kod måste hämtas och anges i konfigurationssteget för att slutföra inloggningen.

2FA-begränsningar

• Kodens giltighet: Om konfigurationsfönstret stängs och ett nytt inloggningsförsök görs, kommer en ny 2FA-kod att genereras. Den senaste mottagna koden måste alltid användas.
• Begränsning av förfrågningar: Xiaomi begränsar strikt antalet 2FA-koder som kan begäras per dag. Upprepade inloggningsförsök kan resultera i ett tillfälligt block.

Periodiska statusuppdateringar

Till skillnad från andra molnanslutningsmetoder som stöder push-notiser, förlitar sig Xiaomi Home-anslutningen helt på bakgrundspollning för att hämta den senaste statusen. För att optimera nätverksanvändningen beräknas pollningsintervallet dynamiskt baserat på den tid som gått sedan senaste statusförändring; förfrågningar skickas ofta medan enheten är aktiv, men intervallet ökar gradvis ju längre tid som går när enheten förblir inaktiv.

Re-autentisering

Integrationen lagrar säkert en autentiseringstoken efter en lyckad inloggning för att kommunicera med molntjänsterna. Om denna token går ut eller ogiltigförklaras av molntjänsten av någon anledning kommer Home Assistant automatiskt att initiera ett re-autentiseringsflöde och be om att kontouppgifterna anges igen.