Configuração com Conta Xiaomi Home

Este método deve ser usado se o aspirador robô estiver atualmente gerido através da aplicação Xiaomi Home. Para garantir a compatibilidade, pode ser verificado na aplicação oficial Xiaomi Home disponível para iOS e Android.

Requisitos

• Credenciais: Devem ser o nome de utilizador e a senha exatos usados para iniciar sessão na aplicação móvel (não no website oficial).
• Região do Servidor: O país selecionado deve corresponder à região onde o dispositivo está registado na aplicação. Regiões incompatíveis resultarão em erros de "falha no login" ou "dispositivo não encontrado".

Logins de Terceiros

Se a conta foi criada utilizando um serviço de terceiros (como Google ou Apple), deve primeiro ser gerada uma senha dedicada nas definições de utilizador da aplicação. As senhas de contas de terceiros não podem ser usadas para autenticação.

Recomendação de Seleção de Aplicação

Alguns dispositivos podem ser configurados utilizando a aplicação Dreamehome ou a Xiaomi Home. A menos que uma ligação local seja estritamente necessária, é altamente recomendado utilizar a aplicação Dreamehome em vez da Xiaomi Home para dispositivos suportados:

• Transmissão de Câmera: A funcionalidade de transmissão de câmera não está disponível para dispositivos configurados via Xiaomi Home.
• Atualizações Push: A ligação Dreamehome utiliza o Cloud Push para atualizações em tempo real, eliminando a necessidade de pedidos de sondagem periódicos.

Preferir a Opção Cloud

Durante o passo de configuração, uma opção adicional Preferir Cloud está disponível e encontra-se selecionada por defeito.

• Quando selecionado (Predefinição): Força toda a comunicação através da nuvem (se suportado pelo dispositivo). Este é o comportamento predefinido porque, em dispositivos mais recentes, 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 Ligação Local). Isto oferece 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 num erro de "não é possível alcançar o dispositivo" na etapa final da configuração, a configuração deve ser repetida com a opção Preferir Nuvem selecionada.

  Requisito de Sub-rede

  Por razões de segurança, o dispositivo apenas responde a pedidos que se originem da sua própria sub-rede. Portanto, o aspirador robô e o Home Assistant devem estar na mesma sub-rede exata para que a comunicação local funcione. Consulte este artigo python-miio para resolver problemas entre sub-redes.

Verificação 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 captcha. Quando isto acontecer, a imagem captcha deve ser resolvida para prosseguir para o próximo passo.

Autenticação de Dois Fatores (2FA)

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

Este código deve ser obtido e inserido no passo de configuração para completar 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. O código mais recentemente recebido deve ser sempre utilizado.
• Limitação de Taxa: A Xiaomi limita estritamente o número de códigos 2FA que podem ser solicitados por dia. Tentativas repetidas de login podem resultar num bloqueio temporário.

Atualizações de Estado Periódicas

Ao contrário de outros métodos de ligação à cloud que suportam notificações push, a ligação ao Xiaomi Home depende inteiramente de polling em background para obter o estado mais recente. Para otimizar o uso da rede, o intervalo de polling é calculado dinamicamente com base no tempo decorrido desde a última alteração de estado; os pedidos são enviados com frequência enquanto o dispositivo está ativo, mas o intervalo aumenta gradualmente à medida que passa mais tempo enquanto o dispositivo permanece em inatividade.

Reautenticação

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