# Xiaomi Mi Home — plugin ViON

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

Colleghi le telecamere Xiaomi Mi Home e guardi la diretta dalla Sua rete. La ricerca delle telecamere usa l’accesso all’account Mi.

- Pacchetto: @vionvision/camera-ui-xiaomi
- Gruppo: Telecamere e registrazione
- Versione: 0.4.1
- Richiede: ViON 2.2.11 o successiva
- Licenza: MIT
- https://npm.vionvision.tech/-/web/detail/@vionvision/camera-ui-xiaomi
- https://github.com/atva0408-create/Vion-plagin/tree/main/camera-ui-xiaomi#readme

## Descrizione tecnica

Collega le telecamere Xiaomi Mi Home a ViON. Accedete con il vostro account Mi, il plugin trova le telecamere dell’account e voi aggiungete quelle che volete. Le telecamere si collegano tramite la vostra rete locale oppure, per i modelli CS2, da remoto attraverso i relay P2P di Xiaomi. Il cloud fornisce chiavi di autenticazione nuove per ogni connessione.

## Cosa fa

- Accede al vostro account Mi, compresi la verifica tramite immagine e il codice di conferma che Xiaomi può richiedere
- Trova le telecamere dell’account in tutte le regioni Mi Home e propone di aggiungerle
- Mostra la visione in diretta di ogni telecamera, con l’audio se la telecamera lo ha
- Ruota le telecamere motorizzate: frecce nel player e tracciamento automatico, una volta attivato per la telecamera; zooma e mette a fuoco le telecamere con obiettivo zoom
- Conserva il token di accesso del vostro account Mi al posto della password, così dopo un riavvio il plugin accede di nuovo da solo. Il token apre l’intero account Mi, vedi **Da sapere**

## Cosa serve

- Telecamere nella stessa rete locale del server ViON, oppure telecamere CS2 online in un’altra rete
- Una connessione a internet: ogni connessione a una telecamera chiede le chiavi al cloud Mi Home
- Account e password dell’app Mi Home in cui si trovano le telecamere
- Telecamere con il protocollo comune delle telecamere Xiaomi. La maggior parte dei modelli dal 2020 lo usa; alcuni modelli più vecchi non sono supportati. Le telecamere che Xiaomi collega tramite MTP o Agora non si possono ancora riprodurre: non vengono proposte per l’aggiunta e la finestra di accesso le elenca

## Impostazioni

- **Mi account** e **Password**: email, numero di telefono o Mi ID e password del vostro account Mi Home. La password si usa solo per l’accesso e non viene salvata
- **Sign in**: esegue l’accesso e trova le telecamere. Quando Xiaomi chiede i caratteri di un’immagine o un codice inviato al vostro telefono o alla vostra casella di posta, una finestra ve li chiede
- **Signed-in account**: l’ID dell’account a cui il plugin ha effettuato l’accesso
- **Sign out**: dimentica l’accesso ed elimina il token di accesso da ViON. Le telecamere aggiunte restano e mostrano di nuovo il video dopo il prossimo accesso
- **Picture quality**: Standard, High, Low o Maximum. Maximum è adatto ai modelli più recenti; su quelli più vecchi può guastare l’immagine

## Modalità di connessione

Le impostazioni del plugin per la telecamera includono **Connection**:

- **Auto** (predefinita): controlla la porta locale di rilevamento CS2 della telecamera, poi usa il P2P remoto se la telecamera non è raggiungibile in locale e Xiaomi fornisce le credenziali del relay.
- **Local network**: mantiene la connessione diretta; non viene aperto alcun relay.
- **Remote P2P**: usa il relay di Xiaomi anche quando la telecamera ha un indirizzo locale. Sceglietela per una telecamera in un’altra sede. La telecamera deve essere online in Mi Home; non servono port forwarding né VPN.

L’impostazione vale dalla successiva connessione video o PTZ. Il P2P remoto supporta per ora le telecamere CS2; le telecamere TUTK e quelle meno recenti mantengono la riproduzione in rete locale. Il canale cifrato MISS passa attraverso un bridge UDP limitato all’interfaccia locale verso il producer go2rtc esistente, preservando video, audio e il normale player. Le connessioni in sospeso vengono annullate all’uscita dall’account, alla rimozione della telecamera e allo spegnimento; le sessioni inutilizzate scadono. La disponibilità del relay e la banda dipendono da Xiaomi e dall’upload della telecamera.

Verificato da remoto con `xiaomi.camera.c01a01`: HEVC 2304×1296 in qualità **Maximum**. Altri modelli possono richiedere un’altra impostazione di qualità. Riferimenti ai protocolli: [CS2/PPPP](https://github.com/magicus/pppp-dissector/blob/main/PPPP.md), [scambio tramite il relay Xiaomi](https://github.com/eugeneRover/micam#how-it-works).

## Aggiungere le telecamere

1. Aprite le impostazioni del plugin, inserite l’account Mi e la password e fate clic su **Sign in**
2. Se Xiaomi chiede i caratteri di un’immagine o un codice, inseriteli nella finestra che si apre. Un codice digitato male si può riscrivere nella stessa finestra; una finestra rimasta in attesa per 10 minuti viene annullata
3. La finestra elenca poi le telecamere trovate
4. Aprite **Cameras** in ViON: le telecamere sono in **Discovered**. Fate clic su una telecamera, controllatene il nome e confermate

## Rotazione, inclinazione e zoom

Per una telecamera motorizzata (Mi 360°, C200, C300 e simili) aprite la telecamera in ViON, poi **Settings**, **Autotrack**, e attivate **Pan, tilt and zoom (PTZ)**. Il player mostra quindi delle frecce: tenetene premuta una per ruotare la telecamera, una pressione breve la ruota di un passo. Il tracciamento automatico può così seguire una persona. Il plugin ruota la telecamera tramite una propria connessione, come fa l’app Mi Home. Funziona con le telecamere sul protocollo CS2, usato dalla maggior parte dei modelli, e non con quelle su TUTK; il registro della telecamera lo indica al primo passo.

Una telecamera con obiettivo zoom zooma anche: lo zoom del player la avvicina e la allontana a passi finché resta premuto, **Home** riporta lo zoom al minimo. La messa a fuoco compare accanto all’interruttore: **Focus nearer** e **Focus farther** spostano la messa a fuoco a passi, **Focus automatically** (o **Autofocus**) la lascia alla telecamera. Zoom e messa a fuoco passano dal cloud Mi Home, come nell’app, e il plugin li trova nella descrizione MIoT che Xiaomi pubblica per il modello (miot-spec.org): il server ha bisogno di internet quando l’interruttore è attivo. Le telecamere a obiettivo fisso (Mi 360°, C200, C300) non hanno uno zoom da comandare: l’immagine del player si può comunque ingrandire con due dita o con la rotella del mouse.

## Da sapere

- Il token di accesso è una chiave per l’intero account Mi, non solo per le telecamere: chi lo possiede può accedere all’account senza password. ViON lo conserva nelle impostazioni del plugin, quindi proteggete il server ViON e i suoi backup come proteggereste la password. **Sign out** lo elimina da ViON; per rendere inutile una sua copia, cambiate la password dell’account Mi. Dopo un cambio di password Xiaomi rifiuta il token e il plugin vi chiede di accedere di nuovo
- Xiaomi non offre un’interfaccia ufficiale per altri sistemi. Il plugin accede come fa l’app Mi Home, quindi un cambiamento da parte di Xiaomi può richiedere un aggiornamento del plugin
- Le telecamere con due obiettivi mostrano il primo obiettivo
- Una telecamera che riceve un nuovo indirizzo nella rete viene ritrovata entro pochi minuti