Подключение камер YingShi Cloud
Полное руководство по интеграции камер Ezviz и Hikvision в HomeAssistant через RTSP, ONVIF и WebRTC протоколы
О камерах YingShi Cloud (萤石云)
YingShi Cloud (Ezviz) - это популярная линейка камер видеонаблюдения от компании Hikvision. Они поддерживают протоколы RTSP и ONVIF, что позволяет интегрировать их в HomeAssistant для создания единой системы умного дома с возможностью просмотра видеопотоков и записи событий.
Предварительные требования
Подготовка камеры
Перед покупкой убедитесь, что камера поддерживает протоколы RTSP/ONVIF. Проверьте спецификации на официальном сайте.
Данные для доступа
Вам понадобится IP-адрес камеры, имя пользователя (обычно admin) и проверочный код (verification code).
Сетевое подключение
Камера и HomeAssistant должны быть в одной локальной сети для стабильной работы.
Выбор метода интеграции
- ONVIF: Простая настройка, но высокая задержка видео
- RTSP + ffmpeg: Хорошая производительность, стабильное соединение
- WebRTC Camera: Минимальная задержка, лучшая плавность (требует HACS)
Шаг 1: Включение RTSP на камере
Для начала работы необходимо включить RTSP сервис на вашей камере YingShi/Ezviz:
- Откройте мобильное приложение "萤石云" (Ezviz)
- Перейдите на страницу устройства
- Нажмите на иконку настроек (Ещё)
- Выберите 【Конфигурация сети】 → 【Расширенная конфигурация】
- Найдите опцию 【RTSP сервис】 и включите её
- Сохраните сгенерированный RTSP адрес
После включения RTSP убедитесь, что камера доступна в локальной сети. Запишите RTSP адрес и проверочный код - они понадобятся для настройки в HomeAssistant.
Шаг 2: Получение RTSP адреса
Существует несколько способов найти RTSP адрес вашей камеры:
Способ 1: Через приложение Ezviz
- Откройте приложение Ezviz
- Перейдите: 【Мой】 → 【Инструменты】 → 【Предпросмотр LAN-устройства】
- Нажмите 【Начать сканирование】
- Выберите вашу камеру из списка
- Перейдите в 【Настройки】 → 【Ещё настройки】 → 【Локальный сервис】
Способ 2: Стандартный формат RTSP
rtsp://username:password@ip_address:554/h264/ch1/main/av_stream
Где:
• username - admin (по умолчанию)
• password - проверочный код камеры
• ip_address - IP-адрес вашей камеры
Шаг 3: Интеграция через ONVIF
ONVIF - самый простой способ добавить камеру в HomeAssistant:
- Откройте HomeAssistant
- Перейдите: 【Настройки】 → 【Устройства и службы】
- Нажмите 【Добавить интеграцию】
- Найдите и выберите 【ONVIF】
- Введите данные:
• IP-адрес камеры
• Порт (обычно 80 или 8000)
• Имя пользователя (admin)
• Пароль (проверочный код)
Если камера не обнаруживается автоматически, попробуйте указать разные порты. Для камер Ezviz обычно используются порты 80, 8000 или 8080.
Шаг 4: Интеграция через RTSP (ffmpeg)
Для лучшей производительности используйте RTSP с ffmpeg. Добавьте в configuration.yaml:
# configuration.yaml
camera:
- platform: ffmpeg
name: YingShi Camera
input: rtsp://admin:verification_code@192.168.1.100:554/h264/ch1/main/av_stream
extra_options: -pred 1 -q:v 2
После добавления конфигурации:
- Перезагрузите конфигурацию HomeAssistant (Разработчики → YAML → Перезагрузить)
- Проверьте наличие камеры в разделе "Устройства и службы"
- Добавьте камеру на панель управления
Шаг 5: Интеграция через WebRTC Camera
Для достижения минимальной задержки видео используйте WebRTC Camera:
- Установите HACS (если ещё не установлен)
- В HACS найдите и установите 【WebRTC Camera】
- Перезагрузите HomeAssistant
- Перейдите: 【Настройки】 → 【Устройства и службы】
- Добавьте интеграцию 【WebRTC Camera】
- Настройте камеру, используя RTSP адрес
Пример конфигурации WebRTC:
rtsp://admin:your_code@192.168.1.100:554/h264/ch1/main/av_stream
• Минимальная задержка (less than 1 second)
• Плавное воспроизведение
• Низкая нагрузка на CPU
• Поддержка двухсторонней аудио связи (на некоторых моделях)
Решение проблем
Камера не обнаруживается
Проверьте: правильность IP-адреса, камера включена, находится в той же сети, что и HA. Попробуйте пропинговать камеру.
Ошибка аутентификации
Убедитесь, что используете правильный проверочный код (находится рядом с QR-кодом на камере или в приложении).
Видео зависает
Попробуйте использовать RTSP вместо ONVIF, или установите WebRTC Camera для лучшей производительности.
Дополнительные возможности
Интеграция с HomeKit
После добавления камеры в HomeAssistant вы можете интегрировать её в HomeKit:
- Настройте интеграцию "Мост HomeKit" в HomeAssistant
- Камера станет доступна в приложении "Дом" на iOS
- Можно просматривать видео на Apple TV, Mac и других устройствах Apple
Запись и детекция движения
Для расширенных функций записи и анализа видео рассмотрите установку Frigate:
- Frigate предоставляет локальную детекцию движения
- Интеграция с автоматизацией HA
- Запись событий на NAS
Полезные ресурсы
Ссылки и документация
Оригинальная статья на冬瓜HA
Документация ONVIF на HomeAssistant
WebRTC Camera на GitHub