# Xiaomi Mi Home — ViON Plugins

Quelle: https://vionvision.tech/de/plugins/cameras/xiaomi

Binden Sie Xiaomi-Mi-Home-Kameras an und sehen Sie das Livebild aus Ihrem Netzwerk. Für die Kamerasuche wird die Anmeldung im Mi-Konto verwendet.

- Paket: @vionvision/camera-ui-xiaomi
- Gruppe: Kameras und Aufzeichnung
- Version: 0.4.1
- Benötigt: ViON 2.2.11 oder neuer
- Lizenz: MIT
- https://npm.vionvision.tech/-/web/detail/@vionvision/camera-ui-xiaomi
- https://github.com/atva0408-create/Vion-plagin/tree/main/camera-ui-xiaomi#readme

## Technische Beschreibung

Verbindet Xiaomi-Mi-Home-Kameras mit ViON. Sie melden sich mit Ihrem Mi-Konto an, das Plugin findet die Kameras des Kontos, und Sie fügen die gewünschten hinzu. Die Kameras verbinden sich über Ihr lokales Netzwerk oder, bei CS2-Modellen, aus der Ferne über die P2P-Relays von Xiaomi. Die Cloud liefert für jede Verbindung neue Authentifizierungsschlüssel.

## Was es kann

- Meldet sich bei Ihrem Mi-Konto an, einschließlich der Bildprüfung und des Bestätigungscodes, die Xiaomi verlangen kann
- Findet die Kameras des Kontos in allen Mi-Home-Regionen und bietet sie zum Hinzufügen an
- Zeigt das Livebild jeder Kamera, mit Ton, wo die Kamera ihn hat
- Dreht Kameras mit Motor: Pfeile im Player und automatische Verfolgung, sobald sie für die Kamera eingeschaltet ist; zoomt und fokussiert Kameras mit Zoomobjektiv
- Speichert statt des Passworts das Anmeldetoken Ihres Mi-Kontos, sodass sich das Plugin nach einem Neustart selbst wieder anmeldet. Das Token öffnet das gesamte Mi-Konto, siehe **Gut zu wissen**

## Was Sie brauchen

- Kameras im selben lokalen Netzwerk wie der ViON-Server oder online erreichbare CS2-Kameras in einem anderen Netzwerk
- Eine Internetverbindung: Jede Verbindung zu einer Kamera fragt ihre Schlüssel bei der Mi-Home-Cloud ab
- Konto und Passwort der Mi-Home-App, in der sich die Kameras befinden
- Kameras mit dem gängigen Xiaomi-Kameraprotokoll. Die meisten Modelle seit 2020 nutzen es; einige ältere Modelle werden nicht unterstützt. Kameras, die Xiaomi über MTP oder Agora verbindet, lassen sich noch nicht abspielen: Sie werden nicht zum Hinzufügen angeboten, und das Anmeldefenster listet sie auf

## Einstellungen

- **Mi account** und **Password**: E-Mail, Telefonnummer oder Mi ID und das Passwort Ihres Mi-Home-Kontos. Das Passwort wird nur für die Anmeldung verwendet und nicht gespeichert
- **Sign in**: meldet sich an und findet die Kameras. Verlangt Xiaomi die Zeichen eines Bildes oder einen an Ihr Telefon oder Postfach gesendeten Code, fragt ein Fenster danach
- **Signed-in account**: die ID des Kontos, bei dem das Plugin angemeldet ist
- **Sign out**: vergisst die Anmeldung und löscht das Anmeldetoken aus ViON. Hinzugefügte Kameras bleiben und zeigen nach der nächsten Anmeldung wieder Video
- **Picture quality**: Standard, High, Low oder Maximum. Maximum eignet sich für neuere Modelle; bei älteren kann es das Bild stören

## Verbindungsmodus

Die Plugin-Einstellungen der Kamera enthalten **Connection**:

- **Auto** (Standard): prüft den lokalen CS2-Erkennungsport der Kamera und nutzt dann Remote-P2P, wenn die Kamera lokal nicht erreichbar ist und Xiaomi Relay-Zugangsdaten bereitstellt.
- **Local network**: behält die direkte Verbindung bei; es wird kein Relay geöffnet.
- **Remote P2P**: nutzt das Relay von Xiaomi, auch wenn die Kamera eine lokale Adresse hat. Wählen Sie dies für eine Kamera an einem anderen Standort. Die Kamera muss in Mi Home online sein; Portweiterleitung und VPN sind nicht nötig.

Die Einstellung gilt ab der nächsten Video- oder PTZ-Verbindung. Remote-P2P unterstützt derzeit CS2-Kameras; TUTK- und ältere Kameras behalten die Wiedergabe im lokalen Netzwerk. Der verschlüsselte MISS-Kanal läuft über eine nur lokal erreichbare UDP-Brücke zum bestehenden go2rtc-Producer, sodass Video, Ton und der normale Player erhalten bleiben. Ausstehende Verbindungen werden beim Abmelden, beim Entfernen der Kamera und beim Herunterfahren abgebrochen; ungenutzte Sitzungen laufen ab. Verfügbarkeit und Bandbreite des Relays hängen von Xiaomi und dem Upload der Kamera ab.

Aus der Ferne geprüft mit `xiaomi.camera.c01a01`: HEVC 2304×1296 bei Qualität **Maximum**. Andere Modelle benötigen eventuell eine andere Qualitätseinstellung. Protokollreferenzen: [CS2/PPPP](https://github.com/magicus/pppp-dissector/blob/main/PPPP.md), [Austausch über das Xiaomi-Relay](https://github.com/eugeneRover/micam#how-it-works).

## Kameras hinzufügen

1. Öffnen Sie die Plugin-Einstellungen, geben Sie Mi-Konto und Passwort ein und klicken Sie auf **Sign in**
2. Verlangt Xiaomi die Zeichen eines Bildes oder einen Code, geben Sie sie im sich öffnenden Fenster ein. Ein vertippter Code kann im selben Fenster erneut eingegeben werden; ein Fenster, das 10 Minuten wartet, wird abgebrochen
3. Das Fenster listet dann die gefundenen Kameras auf
4. Öffnen Sie **Cameras** in ViON: Die Kameras stehen unter **Discovered**. Klicken Sie auf eine Kamera, prüfen Sie ihren Namen und bestätigen Sie

## Schwenken, Neigen und Zoomen

Für eine Kamera mit Motor (Mi 360°, C200, C300 und ähnliche) öffnen Sie die Kamera in ViON, dann **Settings**, **Autotrack**, und schalten **Pan, tilt and zoom (PTZ)** ein. Der Player zeigt dann Pfeile: Halten Sie einen gedrückt, um die Kamera zu drehen; ein kurzer Druck dreht sie um einen Schritt. Die automatische Verfolgung kann damit einer Person folgen. Das Plugin dreht die Kamera über eine eigene Verbindung, so wie die Mi-Home-App. Das funktioniert bei Kameras mit dem CS2-Protokoll, das die meisten Modelle nutzen, und nicht bei Kameras mit TUTK; das Protokoll der Kamera meldet dies beim ersten Schritt.

Eine Kamera mit Zoomobjektiv zoomt auch: Der Zoom des Players zoomt sie schrittweise hinein und heraus, solange er gehalten wird, **Home** zoomt ganz heraus. Ihr Fokus erscheint neben dem Schalter: **Focus nearer** und **Focus farther** verstellen den Fokus schrittweise, **Focus automatically** (oder **Autofocus**) überlässt ihn der Kamera. Zoom und Fokus laufen über die Mi-Home-Cloud, wie in der App, und das Plugin findet sie in der MIoT-Beschreibung, die Xiaomi für das Modell veröffentlicht (miot-spec.org): Der Server braucht Internet, wenn der Schalter eingeschaltet ist. Kameras mit Festobjektiv (Mi 360°, C200, C300) haben keinen Zoom zum Steuern: Das Bild im Player lässt sich trotzdem mit zwei Fingern oder dem Mausrad vergrößern.

## Gut zu wissen

- Das Anmeldetoken ist ein Schlüssel zu Ihrem gesamten Mi-Konto, nicht nur zu den Kameras: Wer es hat, kann sich ohne Passwort beim Konto anmelden. ViON speichert es in den Plugin-Einstellungen, schützen Sie den ViON-Server und seine Backups also wie das Passwort. **Sign out** löscht es aus ViON; um eine Kopie davon unbrauchbar zu machen, ändern Sie das Passwort des Mi-Kontos. Nach einer Passwortänderung lehnt Xiaomi das Token ab, und das Plugin bittet Sie, sich erneut anzumelden
- Xiaomi bietet keine offizielle Schnittstelle für andere Systeme. Das Plugin meldet sich so an wie die Mi-Home-App, daher kann eine Änderung auf Seiten von Xiaomi ein Update des Plugins erfordern
- Kameras mit zwei Objektiven zeigen das erste Objektiv
- Eine Kamera, die eine neue Adresse im Netzwerk erhält, wird innerhalb weniger Minuten wiedergefunden