Câmeras e gravação

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

  1. Abra as configurações do plugin, digite a conta Mi e a senha e clique em Sign in
  2. 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
  3. A janela então lista as câmeras encontradas
  4. 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

Outras extensões do grupo