Configuração com Ligação Local Não Recomendado

Este método deve ser utilizado para estabelecer uma ligação direta local ao aspirador robot sem depender de conectividade contínua à cloud. Para utilizar este método, o dispositivo deve ter sido adicionado com sucesso à aplicação oficial Xiaomi Home (disponível para iOS e Android) pelo menos uma vez para gerar um token válido. Além disso, deve permanecer ligado à conta durante esta etapa de configuração para que a integração possa recuperar o endereço IP e o token necessários da cloud.

Compatibilidade do Dispositivo

Este método de ligação é exclusivamente suportado para dispositivos fabricados antes de 2022 que são compatíveis com a aplicação Xiaomi Home. Se um dispositivo não puder ser adicionado à aplicação Xiaomi Home, não exporá uma API local em nenhuma circunstância com qualquer token.

Sem Suporte a Mapas Não Recomendado

Não é tecnicamente possível obter dados do mapa através da API local. Como resultado, o método de ligação local oferece nenhum suporte a mapas, o que desativa completamente várias funcionalidades essenciais que dependem de dados do mapa, tais como Histórico limpeza, Restaurar mapa e Entidades de Sala dinâmicos. Uma vez que o mapa e as suas funcionalidades dependentes são centrais para a funcionalidade principal da integração, este método de ligação é estritamente não recomendado. Para uma experiência completa e totalmente funcional, é altamente aconselhado utilizar um dos métodos de ligação em nuvem.

Obtenção de IP e Token

Para configurar a ligação local, deve fornecer manualmente o endereço IP e o token do dispositivo.

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 exata mesma sub-rede para que a comunicação local funcione. Consulte este artigo python-miio para resolução de problemas de questões entre sub-redes.

Método 1: Xiaomi Cloud Tokens Extractor Recomendado

Este é o método mais fiável. Funciona no Windows, macOS ou Linux, ligando-se diretamente aos servidores da Xiaomi na cloud para obter os endereços IP e tokens de todos os dispositivos ligados à conta simultaneamente.

1. Descarregar a Ferramenta: Descarregue a versão adequada (por exemplo, .exe para Windows) do Xiaomi Cloud Tokens Extractor a partir do GitHub.
2. Executar a Aplicação: Execute o ficheiro descarregado para abrir uma interface de terminal.
3. Introduzir Credenciais: Forneça o nome de utilizador exato (Email ou ID Xiaomi) e a palavra-passe usados na aplicação Xiaomi Home.
4. Selecionar Região do Servidor: Especifique a região do servidor correspondente à aplicação Xiaomi Home (por exemplo, de para a Europa). Se a região for desconhecida, deixe o prompt em branco e pressione Enter para verificar todos os servidores disponíveis.
5. Recuperar o Token: A ferramenta irá apresentar uma lista de todos os dispositivos ligados à conta. Localize o aspirador alvo na lista e copie o seu token correspondente de 32 caracteres.

Método 2: Aplicação de Ambiente de Trabalho (Get_MiHome_devices_token)

Para utilizadores que preferem uma interface gráfica em vez de uma ferramenta de linha de comandos, está disponível uma aplicação de ambiente de trabalho.

1. Descarregar a Aplicação: Descarregue e instale a aplicação Get_MiHome_devices_token a partir do GitHub.
2. Iniciar Sessão: Abra a aplicação, introduza as credenciais da conta Xiaomi e selecione a região de servidor apropriada.
3. Recuperar o Token: Uma vez autenticado, todos os dispositivos ligados, juntamente com os seus respetivos endereços IP e tokens, serão exibidos em formato de tabela.

Método 3: App Mi Home Modificada para Android Não Recomendado

Os utilizadores de Android podem utilizar uma versão modificada da aplicação Mi Home para ver os tokens diretamente na interface da aplicação no seu dispositivo móvel.

1. Desinstalar a Aplicação Original: Desinstale completamente a aplicação oficial Mi Home do dispositivo Android. (Nota: Os dispositivos permanecerão ligados com segurança à conta na cloud).
2. Instalar a Aplicação Modificada: Procure online pelo APK modificado "MiHome by Vevs", descarregue a versão mais recente e instale-a no dispositivo.
3. Iniciar Sessão: Abra a aplicação modificada e inicie sessão usando as credenciais da conta Xiaomi.
4. Obter o Token: Selecione o aspirador alvo para abrir a sua interface de controlo. Toque nos três pontos no canto superior direito para aceder às definições, depois navegue até à secção Informação da Rede ou Definições Gerais. O endereço IP e o token do dispositivo serão visíveis diretamente neste ecrã.