Configuración con Cuenta de Xiaomi Home

Este método debe usarse si el aspirador robot se gestiona actualmente a través de la aplicación Xiaomi Home. Para garantizar la compatibilidad, puede verificarse con la aplicación oficial Xiaomi Home disponible para iOS y Android.

Requisitos

• Credenciales: Deben ser el nombre de usuario y la contraseña exactos utilizados para iniciar sesión en la aplicación móvil (no en el sitio web oficial).
• Región del servidor: El país seleccionado debe coincidir con la región donde el dispositivo está registrado en la aplicación. Las regiones que no coincidan resultarán en errores de "inicio de sesión fallido" o "dispositivo no encontrado".

Inicios de sesión de terceros

Si la cuenta fue creada usando un servicio de terceros (como Google o Apple), primero debe generarse una contraseña dedicada dentro de la configuración de usuario de la aplicación. No se pueden usar contraseñas de cuentas de terceros para la autenticación.

Recomendación de Selección de Aplicación

Algunos dispositivos pueden configurarse utilizando la aplicación Dreamehome o Xiaomi Home. A menos que se requiera estrictamente una conexión local, se recomienda encarecidamente usar la aplicación Dreamehome en lugar de Xiaomi Home para los dispositivos compatibles:

• Transmisión de Cámara: La función de transmisión de cámara no está disponible para los dispositivos configurados a través de Xiaomi Home.
• Actualizaciones Push: La conexión con Dreamehome utiliza Push en la Nube para actualizaciones en tiempo real, eliminando la necesidad de solicitudes de sondeo periódicas.

Preferir Opción en la Nube

Durante el paso de configuración, está disponible una opción adicional Preferir Nube y está marcada por defecto.

• Cuando está marcado (Predeterminado): Obliga a que toda la comunicación pase por la nube (si el dispositivo lo soporta). Este es el comportamiento predeterminado porque en los dispositivos más recientes, Xiaomi ha deshabilitado las capacidades de acceso local. Además, si el dispositivo y Home Assistant residen en subredes diferentes, la comunicación local fallará.
• Cuando no está marcado (Recomendado para configuraciones compatibles): La integración obtiene el token requerido desde la nube pero establece una conexión local directa con el dispositivo (similar al método Conexión Local). Esto proporciona el beneficio de renovación automática del token y la IP mientras mantiene toda la comunicación (excepto los datos del mapa) local. Si este método resulta en un error de "no se puede alcanzar el dispositivo" en el paso final de la configuración, se debe intentar nuevamente la configuración con la opción Preferir la Nube marcada.

  Requisito de Subred

  Por razones de seguridad, el dispositivo solo responde a solicitudes que provienen de su propia subred. Por lo tanto, la aspiradora robot y Home Assistant deben estar en la misma subred exacta para que la comunicación local funcione. Consulte este artículo de python-miio para solucionar problemas de subred cruzada.

Verificación Captcha

Si los servidores de Xiaomi Home marcan el intento de inicio de sesión o la dirección IP como no confiables, se requerirá un paso de verificación captcha. Cuando esto ocurra, se debe resolver la imagen captcha para continuar con el siguiente paso.

Autenticación de Dos Factores (2FA)

Además de un captcha, un intento de inicio de sesión no confiable también puede activar la Autenticación de Dos Factores (2FA). La integración solicitará automáticamente un código 2FA de los servidores de Xiaomi Home, el cual se envía al número de teléfono registrado (prioritario) o a la dirección de correo electrónico.

Este código debe ser recuperado e ingresado en el paso de configuración para completar el inicio de sesión.

Limitaciones de 2FA

• Validez del Código: Si se cierra la ventana de configuración y se realiza un nuevo intento de inicio de sesión, se generará un nuevo código 2FA. Siempre debe usarse el código recibido más recientemente.
• Limitación de Frecuencia: Xiaomi limita estrictamente la cantidad de códigos 2FA que se pueden solicitar por día. Los intentos de inicio de sesión repetidos pueden resultar en un bloqueo temporal.

Actualizaciones Periódicas del Estado

A diferencia de otros métodos de conexión en la nube que admiten notificaciones push, la conexión de Xiaomi Home depende completamente del sondeo en segundo plano para obtener el estado más reciente. Para optimizar el uso de la red, el intervalo de sondeo se calcula dinámicamente según el tiempo transcurrido desde el último cambio de estado; las solicitudes se envían frecuentemente mientras el dispositivo está activo, pero el intervalo aumenta gradualmente a medida que pasa más tiempo mientras el dispositivo permanece inactivo.

Reautenticación

La integración almacena de forma segura un token de autenticación después de un inicio de sesión exitoso para comunicarse con los servidores en la nube. Si este token expira o es invalidado por el servicio en la nube por cualquier motivo, Home Assistant activará automáticamente un flujo de reautenticación, solicitando que se ingresen nuevamente las credenciales de la cuenta.