# Xiaomi Mi Home — плагины ViON

Источник: https://vionvision.tech/plugins/cameras/xiaomi

Подключите камеры Xiaomi Mi Home и смотрите прямой эфир из вашей сети. Для поиска камер используется вход в аккаунт Mi.

- Пакет: @vionvision/camera-ui-xiaomi
- Группа: Камеры и запись
- Версия: 0.4.1
- Требуется: ViON 2.2.11 или новее
- Лицензия: MIT
- https://npm.vionvision.tech/-/web/detail/@vionvision/camera-ui-xiaomi
- https://github.com/atva0408-create/Vion-plagin/tree/main/camera-ui-xiaomi#readme

## Техническое описание

Подключает камеры Xiaomi Mi Home к ViON. Вы входите в аккаунт Mi, плагин находит камеры аккаунта, и вы добавляете нужные. Камеры подключаются по вашей локальной сети или, для моделей на CS2, удалённо через P2P-ретрансляторы Xiaomi. Облако выдаёт свежие ключи аутентификации для каждого подключения.

## Что умеет

- Входит в ваш аккаунт Mi, включая проверку по картинке и код подтверждения, которые может запросить Xiaomi
- Находит камеры аккаунта во всех регионах Mi Home и предлагает их добавить
- Показывает прямой эфир каждой камеры, со звуком, если он есть у камеры
- Поворачивает камеры с мотором: стрелками в плеере и автослежением, если оно включено для камеры; приближает и фокусирует камеры с зум-объективом
- Хранит токен входа вашего аккаунта Mi вместо пароля, поэтому после перезапуска плагин входит снова сам. Токен открывает доступ ко всему аккаунту Mi, см. **Полезно знать**

## Что нужно

- Камеры в той же локальной сети, что и сервер ViON, или камеры на CS2 в другой сети, которые находятся в сети
- Подключение к интернету: каждое подключение к камере запрашивает ключи у облака Mi Home
- Аккаунт и пароль приложения Mi Home, в котором находятся камеры
- Камеры на распространённом протоколе камер Xiaomi. Большинство моделей с 2020 года используют его; некоторые старые модели не поддерживаются. Камеры, которые Xiaomi подключает через MTP или Agora, пока воспроизвести нельзя: их не предлагают для добавления, а окно входа показывает их списком

## Настройки

- **Mi account** и **Password**: email, номер телефона или Mi ID и пароль вашего аккаунта Mi Home. Пароль используется только для входа и не сохраняется
- **Sign in**: выполняет вход и находит камеры. Если Xiaomi запрашивает символы с картинки или код, отправленный на телефон или почту, окно попросит их ввести
- **Signed-in account**: ID аккаунта, в который вошёл плагин
- **Sign out**: забывает вход и удаляет токен входа из ViON. Добавленные камеры остаются и снова показывают видео после следующего входа
- **Picture quality**: Standard, High, Low или Maximum. Maximum подходит для новых моделей; на старых может нарушить изображение

## Режим подключения

В настройках плагина для камеры есть параметр **Connection**:

- **Auto** (по умолчанию): проверяет локальный порт обнаружения CS2 камеры, затем использует удалённый P2P, если камера недоступна локально и Xiaomi выдаёт данные для ретранслятора.
- **Local network**: сохраняет прямое подключение; ретранслятор не открывается.
- **Remote P2P**: использует ретранслятор Xiaomi, даже если у камеры есть локальный адрес. Выберите этот режим для камеры в другом месте. Камера должна быть в сети в Mi Home; проброс портов и VPN не нужны.

Настройка действует со следующего подключения к видео или PTZ. Удалённый P2P сейчас поддерживает камеры на CS2; камеры на TUTK и старые камеры остаются с воспроизведением по локальной сети. Зашифрованный канал MISS проходит через UDP-мост, доступный только на локальном интерфейсе, к уже существующему источнику go2rtc, поэтому сохраняются видео, звук и обычный плеер. Ожидающие подключения отменяются при выходе из аккаунта, удалении камеры и остановке; неиспользуемые сеансы истекают. Доступность ретранслятора и пропускная способность зависят от Xiaomi и исходящего канала камеры.

Проверено удалённо на `xiaomi.camera.c01a01`: HEVC 2304×1296 в качестве **Maximum**. Для других моделей может потребоваться другая настройка качества. Описание протоколов: [CS2/PPPP](https://github.com/magicus/pppp-dissector/blob/main/PPPP.md), [обмен через ретранслятор Xiaomi](https://github.com/eugeneRover/micam#how-it-works).

## Добавление камер

1. Откройте настройки плагина, введите аккаунт Mi и пароль и нажмите **Sign in**
2. Если Xiaomi запросит символы с картинки или код, введите их в открывшемся окне. Ошибочный код можно ввести заново в том же окне; окно, ожидающее дольше 10 минут, закрывается
3. Затем окно покажет найденные камеры
4. Откройте **Cameras** в ViON: камеры находятся в разделе **Discovered**. Нажмите на камеру, проверьте её название и подтвердите

## Поворот, наклон и зум

Для камеры с мотором (Mi 360°, C200, C300 и подобных) откройте камеру в ViON, затем **Settings**, **Autotrack**, и включите **Pan, tilt and zoom (PTZ)**. После этого в плеере появятся стрелки: удерживайте стрелку, чтобы поворачивать камеру, короткое нажатие поворачивает её на один шаг. Автослежение может с их помощью следовать за человеком. Плагин поворачивает камеру по собственному соединению, так же как приложение Mi Home. Это работает для камер на протоколе CS2, который используют большинство моделей, и не работает для камер на TUTK; журнал камеры сообщит об этом при первом шаге.

Камера с зум-объективом также приближает изображение: зум плеера, пока его удерживают, приближает и отдаляет её пошагово, **Home** отдаляет до упора. Рядом с переключателем появляется фокус: **Focus nearer** и **Focus farther** смещают фокус пошагово, **Focus automatically** (или **Autofocus**) оставляет его камере. Зум и фокус работают через облако Mi Home, как в приложении, а плагин находит их в описании MIoT, которое Xiaomi публикует для модели (miot-spec.org): когда переключатель включён, серверу нужен интернет. У камер с фиксированным объективом (Mi 360°, C200, C300) зума нет: изображение в плеере всё равно можно увеличить двумя пальцами или колёсиком мыши.

## Полезно знать

- Токен входа — это ключ ко всему вашему аккаунту Mi, а не только к камерам: тот, у кого он есть, может войти в аккаунт без пароля. ViON хранит его в настройках плагина, поэтому защищайте сервер ViON и его резервные копии так же, как пароль. **Sign out** удаляет его из ViON; чтобы сделать бесполезной его копию, смените пароль аккаунта Mi. После смены пароля Xiaomi отклоняет токен, и плагин попросит войти снова
- У Xiaomi нет официального интерфейса для сторонних систем. Плагин входит так же, как приложение Mi Home, поэтому изменения на стороне Xiaomi могут потребовать обновления плагина
- Камеры с двумя объективами показывают первый объектив
- Камера, получившая новый адрес в сети, находится снова в течение нескольких минут