Configuració amb el Compte Xiaomi Home

Aquest mètode s'hauria d'utilitzar si l'aspirador robot es gestiona actualment mitjançant l'aplicació Xiaomi Home. Per assegurar la compatibilitat, es pot verificar amb l'aplicació oficial Xiaomi Home disponible per a iOS i Android.

Requisits

• Credencials: Han de ser exactament el nom d'usuari i la contrasenya utilitzats per iniciar sessió a l'aplicació mòbil (no al lloc web oficial).
• Regió del Servidor: El país seleccionat ha de coincidir amb la regió on el dispositiu està registrat a l'aplicació. Les regions incompatibles resultaran en errors de "inici de sessió fallit" o "dispositiu no trobat".

Inicis de Sessió de Tercers

Si el compte es va crear utilitzant un servei de tercers (com Google o Apple), primer s'ha de generar una contrasenya dedicada dins de la configuració d'usuari de l'aplicació. No es poden utilitzar contrasenyes de comptes de tercers per a l'autenticació.

Recomanació de Selecció d'Aplicació

Alguns dispositius es poden configurar utilitzant tant l'aplicació Dreamehome com Xiaomi Home. A menys que es requereixi estrictament una connexió local, es recomana molt utilitzar l'aplicació Dreamehome en comptes de Xiaomi Home per a dispositius compatibles:

• Transmissió de la Càmera: La funció de transmissió de la càmera no està disponible per a dispositius configurats mitjançant Xiaomi Home.
• Actualitzacions Push: La connexió Dreamehome utilitza Cloud Push per a actualitzacions en temps real, eliminant la necessitat de sol·licituds periòdiques.

Preferir l'Opció en Núvol

Durant el pas de configuració, hi ha una opció addicional Preferir Núvol i està marcada per defecte.

• Quan està seleccionat (per defecte): Obliga que tota la comunicació es faci a través del núvol (si el dispositiu ho suporta). Aquest és el comportament per defecte perquè en els dispositius més nous, Xiaomi ha desactivat les capacitats d'accés local. A més, si el dispositiu i Home Assistant estan en subxarxes diferents, la comunicació local fallarà.
• Quan no està seleccionat (Recomanat per a configuracions compatibles): La integració recupera el token necessari des del núvol però estableix una connexió local directa amb el dispositiu (semblant al mètode Connexió local). Això proporciona el benefici de renovació automàtica del token i de l'IP mantenint tota la comunicació (excepte les dades del mapa) de manera local. Si aquest mètode genera un error de "no es pot accedir al dispositiu" en l'últim pas de la configuració, s'ha de tornar a intentar la configuració amb l'opció Preferir núvol seleccionada.

  Requisit de Subxarxa

  Per motius de seguretat, el dispositiu només respon a les sol·licituds que provenen de la seva pròpia subxarxa. Per tant, l’aspirador robot i Home Assistant han d’estar a la mateixa subxarxa exacta perquè la comunicació local funcioni. Vegeu aquest article de python-miio per a la resolució de problemes d’errors entre subxarxes.

Verificació Captcha

Si els servidors de Xiaomi Home consideren l’intent d’inici de sessió o l’adreça IP com a no fiables, serà necessari un pas de verificació captcha. Quan això passa, cal resoldre la imatge captcha per poder continuar amb el següent pas.

Autenticació de Dos Factors (2FA)

A més d’un captcha, un intent d’inici de sessió no fiable també pot activar l’Autenticació de Dos Factors (2FA). La integració sol·licitarà automàticament un codi 2FA als servidors de Xiaomi Home, que s’envia al número de telèfon registrat (prioritari) o a l’adreça de correu electrònic.

Aquest codi s’ha d’obtenir i introduir en el pas de configuració per completar l’inici de sessió.

Limitacions del 2FA

• Validesa del codi: Si la finestra de configuració es tanca i es fa un nou intent d'inici de sessió, es generarà un nou codi 2FA. Sempre s'ha d'utilitzar el codi rebut més recent.
• Limitació de la tarifa: Xiaomi limita estrictament el nombre de codis 2FA que es poden sol·licitar per dia. Els intents repetits d'inici de sessió poden provocar un bloqueig temporal.

Actualitzacions periòdiques de l'estat

A diferència d'altres mètodes de connexió al núvol que admeten notificacions push, la connexió Xiaomi Home depèn completament de la sondeig en segon pla per obtenir l'estat més recent. Per optimitzar l'ús de la xarxa, l'interval de sondeig es calcula de manera dinàmica segons el temps transcorregut des de l'últim canvi d'estat; les sol·licituds s'envien amb freqüència mentre el dispositiu funciona activament, però l'interval s'incrementa gradualment a mesura que passa més temps mentre el dispositiu roman inactiu.

Reautenticació

La integració emmagatzema de manera segura un token d'autenticació després d'un inici de sessió correcte per comunicar-se amb els servidors al núvol. Si aquest token caduca o és invalidat pel servei al núvol per qualsevol motiu, Home Assistant iniciarà automàticament un flux de reautenticació, demanant que es tornin a introduir les credencials del compte.