Xiaomi Mi Home
@vionvision/camera-ui-xiaomiv0.4.1
Connectez les caméras Xiaomi Mi Home et regardez le direct depuis votre réseau. La recherche des caméras passe par la connexion au compte Mi.
- Version
- 0.4.1
- Mis à jour
- 9 octobre 2026
- Nécessite
- ViON 2.2.11 ou plus récent
- Licence
- MIT
Description technique
Connecte les caméras Xiaomi Mi Home à ViON. Vous vous connectez avec votre compte Mi, le plugin trouve les caméras du compte et vous ajoutez celles de votre choix. Les caméras se connectent par votre réseau local ou, pour les modèles CS2, à distance via les relais P2P de Xiaomi. Le cloud fournit de nouvelles clés d’authentification pour chaque connexion.
Ce qu’il fait
- Se connecte à votre compte Mi, y compris la vérification par image et le code de confirmation que Xiaomi peut demander
- Trouve les caméras du compte dans toutes les régions Mi Home et propose de les ajouter
- Affiche la vidéo en direct de chaque caméra, avec le son si la caméra en dispose
- Fait pivoter les caméras motorisées : flèches dans le lecteur et suivi automatique, une fois activé pour la caméra ; zoome et fait la mise au point sur les caméras à objectif zoom
- Conserve le jeton de connexion de votre compte Mi au lieu du mot de passe : après un redémarrage, le plugin se reconnecte tout seul. Le jeton ouvre l’ensemble du compte Mi, voir Bon à savoir
Ce qu’il faut
- Des caméras sur le même réseau local que le serveur ViON, ou des caméras CS2 en ligne sur un autre réseau
- Une connexion internet : chaque connexion à une caméra demande ses clés au cloud Mi Home
- Le compte et le mot de passe de l’app Mi Home où se trouvent les caméras
- Des caméras utilisant le protocole de caméra courant de Xiaomi. La plupart des modèles depuis 2020 l’utilisent ; certains modèles anciens ne sont pas pris en charge. Les caméras que Xiaomi connecte via MTP ou Agora ne peuvent pas encore être lues : elles ne sont pas proposées à l’ajout, et la fenêtre de connexion les liste
Réglages
- Mi account et Password : l’e-mail, le numéro de téléphone ou le Mi ID et le mot de passe de votre compte Mi Home. Le mot de passe sert uniquement à la connexion et n’est pas conservé
- Sign in : se connecte et trouve les caméras. Lorsque Xiaomi demande les caractères d’une image ou un code envoyé sur votre téléphone ou votre boîte mail, une fenêtre vous les demande
- Signed-in account : l’ID du compte auquel le plugin est connecté
- Sign out : oublie la connexion et supprime le jeton de connexion de ViON. Les caméras ajoutées restent et affichent à nouveau la vidéo après la prochaine connexion
- Picture quality : Standard, High, Low ou Maximum. Maximum convient aux modèles récents ; sur les anciens, il peut dégrader l’image
Mode de connexion
Les réglages du plugin pour la caméra comportent Connection :
- Auto (par défaut) : vérifie le port local de découverte CS2 de la caméra, puis utilise le P2P distant si la caméra est injoignable en local et que Xiaomi fournit des identifiants de relais.
- Local network : conserve la connexion directe ; aucun relais n’est ouvert.
- Remote P2P : utilise le relais de Xiaomi même si la caméra a une adresse locale. Choisissez-le pour une caméra située ailleurs. La caméra doit être en ligne dans Mi Home ; ni redirection de ports ni VPN ne sont nécessaires.
Le réglage s’applique à la prochaine connexion vidéo ou PTZ. Le P2P distant prend en charge pour l’instant les caméras CS2 ; les caméras TUTK et anciennes conservent la lecture sur le réseau local. Le canal chiffré MISS passe par un pont UDP limité à l’interface locale vers le producteur go2rtc existant, ce qui préserve la vidéo, le son et le lecteur habituel. Les connexions en attente sont annulées à la déconnexion, à la suppression de la caméra et à l’arrêt ; les sessions inutilisées expirent. La disponibilité du relais et la bande passante dépendent de Xiaomi et du débit montant de la caméra.
Vérifié à distance avec xiaomi.camera.c01a01 : HEVC 2304×1296 en qualité Maximum. D’autres modèles peuvent nécessiter un autre réglage de qualité. Références des protocoles : CS2/PPPP, échange via le relais Xiaomi.
Ajouter les caméras
- Ouvrez les réglages du plugin, saisissez le compte Mi et le mot de passe, puis cliquez sur Sign in
- Si Xiaomi demande les caractères d’une image ou un code, saisissez-les dans la fenêtre qui s’ouvre. Un code mal saisi peut être retapé dans la même fenêtre ; une fenêtre restée en attente 10 minutes est annulée
- La fenêtre liste ensuite les caméras trouvées
- Ouvrez Cameras dans ViON : les caméras se trouvent sous Discovered. Cliquez sur une caméra, vérifiez son nom et confirmez
Rotation, inclinaison et zoom
Pour une caméra motorisée (Mi 360°, C200, C300 et similaires), ouvrez la caméra dans ViON, puis Settings, Autotrack, et activez Pan, tilt and zoom (PTZ). Le lecteur affiche alors des flèches : maintenez-en une pour faire pivoter la caméra, un appui bref la fait tourner d’un pas. Le suivi automatique peut ainsi suivre une personne. Le plugin pilote la caméra via sa propre connexion, comme le fait l’app Mi Home. Cela fonctionne pour les caméras utilisant le protocole CS2, celui de la plupart des modèles, mais pas pour celles en TUTK ; le journal de la caméra l’indique dès le premier pas.
Une caméra à objectif zoom zoome aussi : le zoom du lecteur l’avance et la recule pas à pas tant qu’il est maintenu, Home dézoome entièrement. Sa mise au point apparaît à côté de l’interrupteur : Focus nearer et Focus farther ajustent la mise au point pas à pas, Focus automatically (ou Autofocus) la laisse à la caméra. Le zoom et la mise au point passent par le cloud Mi Home, comme dans l’app, et le plugin les trouve dans la description MIoT que Xiaomi publie pour le modèle (miot-spec.org) : le serveur a besoin d’internet lorsque l’interrupteur est activé. Les caméras à objectif fixe (Mi 360°, C200, C300) n’ont pas de zoom à piloter : l’image du lecteur peut tout de même être agrandie à deux doigts ou avec la molette de la souris.
Bon à savoir
- Le jeton de connexion est une clé de tout votre compte Mi, pas seulement de ses caméras : quiconque le possède peut se connecter au compte sans le mot de passe. ViON le conserve dans les réglages du plugin : protégez donc le serveur ViON et ses sauvegardes comme vous protégeriez le mot de passe. Sign out le supprime de ViON ; pour rendre une copie inutilisable, changez le mot de passe du compte Mi. Après un changement de mot de passe, Xiaomi refuse le jeton et le plugin vous demande de vous reconnecter
- Xiaomi ne propose pas d’interface officielle pour les autres systèmes. Le plugin se connecte comme l’app Mi Home : un changement côté Xiaomi peut donc nécessiter une mise à jour du plugin
- Les caméras à deux objectifs affichent le premier objectif
- Une caméra qui obtient une nouvelle adresse sur le réseau est retrouvée en quelques minutes