Configurare cu Cont Xiaomi Home

Această metodă trebuie utilizată dacă aspiratorul robot este gestionat în prezent prin aplicația Xiaomi Home. Pentru a asigura compatibilitatea, aceasta poate fi verificată împotriva aplicației oficiale Xiaomi Home disponibilă pentru iOS și Android.

Cerințe

• Date de autentificare: Trebuie să fie exact numele de utilizator și parola folosite pentru a vă conecta la aplicația mobilă (nu pe site-ul oficial).
• Regiune server: Țara selectată trebuie să corespundă regiunii în care este înregistrat dispozitivul în aplicație. Regiunile incompatibile vor genera erori de tipul "autentificare eșuată" sau "dispozitiv nu a fost găsit".

Autentificări terțe

Dacă contul a fost creat folosind un serviciu terț (cum ar fi Google sau Apple), trebuie să fie generată mai întâi o parolă dedicată în setările de utilizator ale aplicației. Parolele conturilor terțe nu pot fi folosite pentru autentificare.

Recomandare Alegere Aplicație

Unele dispozitive pot fi configurate folosind fie aplicația Dreamehome, fie Xiaomi Home. Cu excepția cazului în care o conexiune locală este strict necesară, este recomandat să se utilizeze aplicația Dreamehome în locul Xiaomi Home pentru dispozitivele compatibile:

• Flux Cameră: Funcția de flux video nu este disponibilă pentru dispozitivele configurate prin Xiaomi Home.
• Actualizări Push: Conexiunea Dreamehome utilizează Cloud Push pentru actualizări în timp real, eliminând necesitatea cererilor periodice de interogare.

Preferă Opțiunea Cloud

În timpul pasului de configurare, este disponibilă o opțiune suplimentară Preferă Cloud și este bifată implicit.

• Când este bifat (Implicit): Forțează toată comunicația prin cloud (dacă este acceptată de dispozitiv). Acesta este comportamentul implicit deoarece pe dispozitivele mai noi, Xiaomi a dezactivat capacitățile de acces local. În plus, dacă dispozitivul și Home Assistant se află pe subrețele diferite, comunicația locală va eșua.
• Când nu este bifat (Recomandat pentru configurații suportate): Integrarea preia tokenul necesar din cloud, dar stabilește o conexiune locală directă cu dispozitivul (similar metodei Conexiune Locală). Acest lucru oferă avantajul reînnoirii automate a tokenului și a IP-ului, păstrând toate comunicațiile (cu excepția datelor pentru hartă) locale. Dacă această metodă generează eroarea „nu se poate accesa dispozitivul” la pasul final de configurare, configurația ar trebui repetată cu opțiunea Prefer Cloud bifată.

  Cerința subnetului

  Din motive de securitate, dispozitivul răspunde doar la cererile care provin din propria sa subrețea. Prin urmare, aspiratorul robot și Home Assistant trebuie să fie pe exact aceeași subrețea pentru ca comunicarea locală să funcționeze. Consultați acest articol python-miio pentru depanarea problemelor între subrețele.

Verificare Captcha

Dacă serverele Xiaomi Home consideră tentativa de autentificare sau adresa IP ca fiind neîncredere, va fi necesar un pas de verificare Captcha. În acest caz, imaginea captcha trebuie rezolvată pentru a trece la pasul următor.

Autentificare cu Doi Factori (2FA)

Pe lângă un captcha, o tentativă de autentificare neîncrezătoare poate declanșa și Autentificarea cu Doi Factori (2FA). Integratia va solicita automat un cod 2FA de la serverele Xiaomi Home, care este trimis către numărul de telefon înregistrat (prioritar) sau adresa de email.

Acest cod trebuie obținut și introdus în pasul de configurare pentru a finaliza autentificarea.

Limitări 2FA

• Validitatea codului: Dacă fereastra de configurare este închisă și se încearcă un nou autentificare, se va genera un nou cod 2FA. Trebuie utilizat întotdeauna cel mai recent cod primit.
• Limitarea ratei: Xiaomi limitează strict numărul de coduri 2FA care pot fi solicitate pe zi. Încercările repetate de autentificare pot duce la un bloc temporar.

Actualizări periodice ale stării

Spre deosebire de alte metode de conectare în cloud care suportă notificări push, conexiunea Xiaomi Home se bazează complet pe interogarea în fundal pentru a prelua cea mai recentă stare. Pentru a optimiza utilizarea rețelei, intervalul de interogare este calculat dinamic în funcție de timpul scurs de la ultima schimbare de stare; solicitările sunt trimise frecvent în timp ce dispozitivul este activ, dar intervalul crește treptat pe măsură ce trece timpul în timp ce dispozitivul rămâne inactiv.

Reautentificare

Integrarea stochează în siguranță un token de autentificare după un login reușit pentru a comunica cu serverele cloud. Dacă acest token expiră sau este invalidat de serviciul cloud din orice motiv, Home Assistant va declanșa automat un proces de reautentificare, solicitând introducerea din nou a credențialelor contului.