# Xiaomi Mi Home — plugins de ViON

Fuente: https://vionvision.tech/es/plugins/cameras/xiaomi

Conecte cámaras Xiaomi Mi Home y vea la imagen en directo desde su red. Para encontrar las cámaras se inicia sesión en la cuenta Mi.

- Paquete: @vionvision/camera-ui-xiaomi
- Grupo: Cámaras y grabación
- Versión: 0.4.1
- Requiere: ViON 2.2.11 o posterior
- Licencia: MIT
- https://npm.vionvision.tech/-/web/detail/@vionvision/camera-ui-xiaomi
- https://github.com/atva0408-create/Vion-plagin/tree/main/camera-ui-xiaomi#readme

## Descripción técnica

Conecta cámaras Xiaomi Mi Home a ViON. Inicia sesión con su cuenta Mi, el plugin encuentra las cámaras de la cuenta y usted añade las que quiera. Las cámaras se conectan por su red local o, en los modelos CS2, a distancia a través de los relés P2P de Xiaomi. La nube proporciona claves de autenticación nuevas para cada conexión.

## Qué hace

- Inicia sesión en su cuenta Mi, incluida la verificación por imagen y el código de confirmación que Xiaomi puede pedir
- Encuentra las cámaras de la cuenta en todas las regiones de Mi Home y ofrece añadirlas
- Muestra la vista en directo de cada cámara, con sonido si la cámara lo tiene
- Gira las cámaras con motor: flechas en el reproductor y seguimiento automático, una vez activado para la cámara; acerca y enfoca las cámaras con objetivo zoom
- Guarda el token de inicio de sesión de su cuenta Mi en lugar de la contraseña, así que tras un reinicio el plugin vuelve a iniciar sesión solo. El token abre toda la cuenta Mi, consulte **Conviene saber**

## Qué necesita

- Cámaras en la misma red local que el servidor ViON, o cámaras CS2 conectadas en otra red
- Conexión a internet: cada conexión con una cámara pide sus claves a la nube de Mi Home
- La cuenta y la contraseña de la app Mi Home en la que están las cámaras
- Cámaras con el protocolo de cámara habitual de Xiaomi. La mayoría de los modelos desde 2020 lo usan; algunos modelos antiguos no son compatibles. Las cámaras que Xiaomi conecta por MTP o Agora aún no se pueden reproducir: no se ofrecen para añadir y la ventana de inicio de sesión las muestra en una lista

## Configuración

- **Mi account** y **Password**: el email, número de teléfono o Mi ID y la contraseña de su cuenta Mi Home. La contraseña solo se usa para iniciar sesión y no se guarda
- **Sign in**: inicia sesión y encuentra las cámaras. Cuando Xiaomi pide los caracteres de una imagen o un código enviado a su teléfono o buzón, una ventana se los solicita
- **Signed-in account**: el ID de la cuenta en la que ha iniciado sesión el plugin
- **Sign out**: olvida el inicio de sesión y elimina el token de ViON. Las cámaras añadidas se mantienen y vuelven a mostrar vídeo tras el siguiente inicio de sesión
- **Picture quality**: Standard, High, Low o Maximum. Maximum es adecuado para modelos recientes; en los antiguos puede estropear la imagen

## Modo de conexión

La configuración del plugin para cada cámara incluye **Connection**:

- **Auto** (predeterminado): comprueba el puerto local de descubrimiento CS2 de la cámara y usa P2P remoto si la cámara no es accesible localmente y Xiaomi proporciona credenciales de relé.
- **Local network**: mantiene la conexión directa; no se abre ningún relé.
- **Remote P2P**: usa el relé de Xiaomi aunque la cámara tenga una dirección local. Elíjalo para una cámara en otra ubicación. La cámara debe estar en línea en Mi Home; no hacen falta redirección de puertos ni VPN.

El ajuste se aplica a la siguiente conexión de vídeo o PTZ. El P2P remoto admite por ahora cámaras CS2; las cámaras TUTK y las antiguas mantienen la reproducción por red local. El canal cifrado MISS pasa por un puente UDP limitado a la interfaz local hacia el productor go2rtc existente, de modo que se conservan el vídeo, el sonido y el reproductor habitual. Las conexiones pendientes se cancelan al cerrar sesión, al eliminar la cámara y al apagar; las sesiones sin uso caducan. La disponibilidad del relé y el ancho de banda dependen de Xiaomi y de la conexión de subida de la cámara.

Verificado a distancia con `xiaomi.camera.c01a01`: HEVC 2304×1296 con calidad **Maximum**. Otros modelos pueden requerir otro ajuste de calidad. Referencias de protocolos: [CS2/PPPP](https://github.com/magicus/pppp-dissector/blob/main/PPPP.md), [intercambio por el relé de Xiaomi](https://github.com/eugeneRover/micam#how-it-works).

## Añadir las cámaras

1. Abra la configuración del plugin, introduzca la cuenta Mi y la contraseña y haga clic en **Sign in**
2. Si Xiaomi pide los caracteres de una imagen o un código, introdúzcalos en la ventana que se abre. Un código mal escrito se puede volver a escribir en la misma ventana; una ventana que espera más de 10 minutos se cancela
3. La ventana muestra entonces las cámaras encontradas
4. Abra **Cameras** en ViON: las cámaras están en **Discovered**. Haga clic en una cámara, compruebe su nombre y confirme

## Giro, inclinación y zoom

Para una cámara con motor (Mi 360°, C200, C300 y similares) abra la cámara en ViON, luego **Settings**, **Autotrack**, y active **Pan, tilt and zoom (PTZ)**. El reproductor muestra entonces flechas: mantenga una pulsada para girar la cámara; una pulsación corta la gira un paso. El seguimiento automático puede seguir a una persona con ello. El plugin gira la cámara mediante una conexión propia, como hace la app Mi Home. Esto funciona con las cámaras que usan el protocolo CS2, el de la mayoría de los modelos, y no con las que usan TUTK; el registro de la cámara lo indica en el primer paso.

Una cámara con objetivo zoom también hace zoom: el zoom del reproductor la acerca y la aleja paso a paso mientras se mantiene pulsado, **Home** aleja del todo. Su enfoque aparece junto al interruptor: **Focus nearer** y **Focus farther** mueven el enfoque paso a paso, **Focus automatically** (o **Autofocus**) lo deja en manos de la cámara. El zoom y el enfoque pasan por la nube de Mi Home, como en la app, y el plugin los encuentra en la descripción MIoT que Xiaomi publica para el modelo (miot-spec.org): el servidor necesita internet cuando el interruptor está activado. Las cámaras de objetivo fijo (Mi 360°, C200, C300) no tienen zoom que controlar: la imagen del reproductor se puede ampliar igualmente con dos dedos o con la rueda del ratón.

## Conviene saber

- El token de inicio de sesión es una llave de toda su cuenta Mi, no solo de sus cámaras: quien lo tenga puede entrar en la cuenta sin la contraseña. ViON lo guarda en la configuración del plugin, así que proteja el servidor ViON y sus copias de seguridad como protegería la contraseña. **Sign out** lo elimina de ViON; para inutilizar una copia, cambie la contraseña de la cuenta Mi. Tras un cambio de contraseña Xiaomi rechaza el token y el plugin le pide iniciar sesión de nuevo
- Xiaomi no ofrece una interfaz oficial para otros sistemas. El plugin inicia sesión como lo hace la app Mi Home, así que un cambio por parte de Xiaomi puede requerir una actualización del plugin
- Las cámaras con dos objetivos muestran el primer objetivo
- Una cámara que obtiene una nueva dirección en la red se vuelve a encontrar en pocos minutos