Configuração com Conta Xiaomi Home

Este método deve ser usado se o robô aspirador estiver atualmente gerenciado através do aplicativo Xiaomi Home. Para garantir a compatibilidade, ele pode ser verificado no aplicativo oficial Xiaomi Home disponível para iOS e Android.

Requisitos

• Credenciais: Devem ser o nome de usuário e senha exatos usados para fazer login no aplicativo móvel (não no site oficial).
• Região do Servidor: O país selecionado deve corresponder à região onde o dispositivo está registrado no aplicativo. Regiões diferentes resultarão em erros como "falha no login" ou "dispositivo não encontrado".

Logins de Terceiros

Se a conta foi criada usando um serviço de terceiros (como Google ou Apple), uma senha dedicada deve primeiro ser gerada nas configurações do usuário do aplicativo. Senhas de contas de terceiros não podem ser usadas para autenticação.

Recomendação de Seleção de App

Alguns dispositivos podem ser configurados usando o aplicativo Dreamehome ou Xiaomi Home. A menos que uma conexão local seja estritamente necessária, é altamente recomendado usar o aplicativo Dreamehome em vez do Xiaomi Home para dispositivos compatíveis:

• Transmissão de Câmera: O recurso de transmissão de câmera não está disponível para dispositivos configurados via Xiaomi Home.
• Atualizações Push: A conexão Dreamehome utiliza o Cloud Push para atualizações em tempo real, eliminando a necessidade de solicitações de polling periódicas.

Prefira a Opção Cloud

Durante a etapa de configuração, uma opção adicional Preferir Cloud está disponível e marcada por padrão.

• Quando marcado (Padrão): Força toda a comunicação através da nuvem (se for suportado pelo dispositivo). Este é o comportamento padrão porque em dispositivos mais novos, a Xiaomi desativou as capacidades de acesso local. Além disso, se o dispositivo e o Home Assistant estiverem em sub-redes diferentes, a comunicação local falhará.
• Quando desmarcado (Recomendado para configurações suportadas): A integração obtém o token necessário da nuvem, mas estabelece uma conexão local direta com o dispositivo (semelhante ao método Conexão Local). Isso proporciona o benefício da renovação automática do token e do IP, mantendo todas as comunicações (exceto dados do mapa) locais. Se este método resultar em um erro de "não é possível alcançar o dispositivo" na etapa final da configuração, a configuração deve ser tentada novamente com a opção Preferir Nuvem marcada.

  Requisito de Sub-rede

  Por razões de segurança, o dispositivo responde apenas a solicitações originadas de sua própria sub-rede. Portanto, o aspirador robô e o Home Assistant devem estar exatamente na mesma sub-rede para que a comunicação local funcione. Consulte este artigo do python-miio para solução de problemas em casos de sub-redes diferentes.

Verificação de Captcha

Se os servidores Xiaomi Home sinalizarem a tentativa de login ou o endereço IP como não confiável, será necessário um passo de verificação de captcha. Quando isso ocorrer, a imagem do captcha deve ser resolvida para prosseguir para a próxima etapa.

Autenticação de Dois Fatores (2FA)

Além do captcha, uma tentativa de login não confiável também pode acionar a Autenticação de Dois Fatores (2FA). A integração solicitará automaticamente um código 2FA dos servidores Xiaomi Home, que será enviado para o número de telefone registrado (prioritário) ou endereço de e-mail.

Este código deve ser obtido e inserido na etapa de configuração para concluir o login.

Limitações do 2FA

• Validade do Código: Se a janela de configuração for fechada e uma nova tentativa de login for feita, um novo código 2FA será gerado. Sempre deve ser utilizado o código mais recentemente recebido.
• Limite de Taxa: A Xiaomi limita rigorosamente o número de códigos 2FA que podem ser solicitados por dia. Tentativas repetidas de login podem resultar em um bloqueio temporário.

Atualizações Periódicas do Estado

Ao contrário de outros métodos de conexão em nuvem que suportam notificações push, a conexão Xiaomi Home depende inteiramente de sondagem em segundo plano para obter o estado mais recente. Para otimizar o uso da rede, o intervalo de sondagem é calculado dinamicamente com base no tempo decorrido desde a última mudança de estado; solicitações são enviadas com frequência enquanto o dispositivo está ativo, mas o intervalo aumenta gradualmente conforme mais tempo passa com o dispositivo permanecendo ocioso.

Reautenticação

A integração armazena de forma segura um token de autenticação após um login bem-sucedido para se comunicar com os servidores na nuvem. Se esse token expirar ou for invalidado pelo serviço na nuvem por qualquer motivo, o Home Assistant iniciará automaticamente um fluxo de reautenticação, solicitando que as credenciais da conta sejam inseridas novamente.