Xiaomi Mi Home

Подключает камеры 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, обмен через ретранслятор Xiaomi.

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

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 могут потребовать обновления плагина
• Камеры с двумя объективами показывают первый объектив
• Камера, получившая новый адрес в сети, находится снова в течение нескольких минут