Xiaomi Mi Home
@vionvision/camera-ui-xiaomiv0.4.1
Conecte câmeras Xiaomi Mi Home e veja ao vivo pela sua rede. A busca de câmeras usa o login na conta Mi.
- Versão
- 0.4.1
- Atualizado
- 9 de outubro de 2026
- Requer
- ViON 2.2.11 ou mais recente
- Licença
- MIT
- Grupo
- Câmeras e gravação
Descrição técnica
Conecta câmeras Xiaomi Mi Home ao ViON. Você entra com sua conta Mi, o plugin encontra as câmeras da conta e você adiciona as que quiser. As câmeras se conectam pela sua rede local ou, nos modelos CS2, remotamente pelos relés P2P da Xiaomi. A nuvem fornece chaves de autenticação novas para cada conexão.
O que faz
- Entra na sua conta Mi, incluindo a verificação por imagem e o código de confirmação que a Xiaomi pode pedir
- Encontra as câmeras da conta em todas as regiões do Mi Home e oferece adicioná-las
- Mostra a transmissão ao vivo de cada câmera, com som quando a câmera tem
- Gira câmeras com motor: setas no player e rastreamento automático, depois de ativado para a câmera; aproxima e foca câmeras com lente zoom
- Guarda o token de login da sua conta Mi em vez da senha, então após reiniciar o plugin entra de novo sozinho. O token abre a conta Mi inteira, veja Bom saber
O que é necessário
- Câmeras na mesma rede local que o servidor ViON, ou câmeras CS2 online em outra rede
- Conexão com a internet: cada conexão com uma câmera pede as chaves à nuvem Mi Home
- A conta e a senha do app Mi Home em que as câmeras estão
- Câmeras com o protocolo de câmera comum da Xiaomi. A maioria dos modelos desde 2020 o usa; alguns modelos antigos não são suportados. Câmeras que a Xiaomi conecta por MTP ou Agora ainda não podem ser reproduzidas: não são oferecidas para adicionar, e a janela de login as lista
Configurações
- Mi account e Password: o e-mail, número de telefone ou Mi ID e a senha da sua conta Mi Home. A senha é usada só para o login e não é armazenada
- Sign in: entra e encontra as câmeras. Quando a Xiaomi pede os caracteres de uma imagem ou um código enviado ao seu telefone ou e-mail, uma janela os solicita
- Signed-in account: o ID da conta em que o plugin entrou
- Sign out: esquece o login e apaga o token de login do ViON. As câmeras adicionadas permanecem e voltam a mostrar vídeo após o próximo login
- Picture quality: Standard, High, Low ou Maximum. Maximum serve para modelos mais novos; em modelos antigos pode estragar a imagem
Modo de conexão
As configurações do plugin para a câmera incluem Connection:
- Auto (padrão): verifica a porta local de descoberta CS2 da câmera e usa P2P remoto se a câmera não estiver acessível localmente e a Xiaomi fornecer credenciais de relé.
- Local network: mantém a conexão direta; nenhum relé é aberto.
- Remote P2P: usa o relé da Xiaomi mesmo quando a câmera tem um endereço local. Escolha para uma câmera em outro local. A câmera precisa estar online no Mi Home; não é preciso redirecionamento de portas nem VPN.
A configuração vale a partir da próxima conexão de vídeo ou PTZ. O P2P remoto suporta por enquanto câmeras CS2; câmeras TUTK e antigas continuam com reprodução pela rede local. O canal criptografado MISS passa por uma ponte UDP restrita à interface local até o produtor go2rtc existente, preservando vídeo, som e o player normal. Conexões pendentes são canceladas ao sair da conta, ao remover a câmera e ao desligar; sessões sem uso expiram. A disponibilidade do relé e a largura de banda dependem da Xiaomi e do upload da câmera.
Verificado remotamente com xiaomi.camera.c01a01: HEVC 2304×1296 na qualidade Maximum. Outros modelos podem exigir outra configuração de qualidade. Referências de protocolo: CS2/PPPP, troca pelo relé da Xiaomi.
Adicionando as câmeras
- Abra as configurações do plugin, digite a conta Mi e a senha e clique em Sign in
- Se a Xiaomi pedir os caracteres de uma imagem ou um código, digite-os na janela que se abre. Um código digitado errado pode ser digitado de novo na mesma janela; uma janela esperando por 10 minutos é cancelada
- A janela então lista as câmeras encontradas
- Abra Cameras no ViON: as câmeras estão em Discovered. Clique em uma câmera, confira o nome e confirme
Giro, inclinação e zoom
Para uma câmera com motor (Mi 360°, C200, C300 e similares), abra a câmera no ViON, depois Settings, Autotrack, e ative Pan, tilt and zoom (PTZ). O player passa a mostrar setas: mantenha uma pressionada para girar a câmera; um toque curto a gira um passo. O rastreamento automático pode seguir uma pessoa com isso. O plugin gira a câmera por uma conexão própria, como faz o app Mi Home. Isso funciona com câmeras no protocolo CS2, que a maioria dos modelos usa, e não com câmeras em TUTK; o log da câmera informa isso no primeiro passo.
Uma câmera com lente zoom também faz zoom: o zoom do player a aproxima e afasta passo a passo enquanto é mantido, Home afasta ao máximo. O foco aparece ao lado do interruptor: Focus nearer e Focus farther ajustam o foco passo a passo, Focus automatically (ou Autofocus) deixa por conta da câmera. Zoom e foco passam pela nuvem Mi Home, como no app, e o plugin os encontra na descrição MIoT que a Xiaomi publica para o modelo (miot-spec.org): o servidor precisa de internet quando o interruptor está ligado. Câmeras de lente fixa (Mi 360°, C200, C300) não têm zoom a controlar: a imagem do player ainda pode ser ampliada com dois dedos ou com a roda do mouse.
Bom saber
- O token de login é uma chave para toda a sua conta Mi, não só para as câmeras: quem o tiver pode entrar na conta sem a senha. O ViON o guarda nas configurações do plugin, então proteja o servidor ViON e seus backups como protegeria a senha. Sign out o apaga do ViON; para inutilizar uma cópia, troque a senha da conta Mi. Depois de uma troca de senha, a Xiaomi recusa o token e o plugin pede que você entre de novo
- A Xiaomi não oferece interface oficial para outros sistemas. O plugin entra do jeito que o app Mi Home faz, então uma mudança do lado da Xiaomi pode exigir uma atualização do plugin
- Câmeras com duas lentes mostram a primeira lente
- Uma câmera que recebe um novo endereço na rede é encontrada de novo em poucos minutos