# Xiaomi Mi Home — plugins do ViON

Fonte: https://vionvision.tech/pt/plugins/cameras/xiaomi

Conecte câmeras Xiaomi Mi Home e veja ao vivo pela sua rede. A busca de câmeras usa o login na conta Mi.

- Pacote: @vionvision/camera-ui-xiaomi
- Grupo: Câmeras e gravação
- Versão: 0.4.1
- Requer: ViON 2.2.11 ou mais recente
- Licença: MIT
- https://npm.vionvision.tech/-/web/detail/@vionvision/camera-ui-xiaomi
- https://github.com/atva0408-create/Vion-plagin/tree/main/camera-ui-xiaomi#readme

## 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](https://github.com/magicus/pppp-dissector/blob/main/PPPP.md), [troca pelo relé da Xiaomi](https://github.com/eugeneRover/micam#how-it-works).

## 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