Skip to content

Управление камерами и организация структуры ​

RUSEON Core предоставляет удобные инструменты для администрирования любого количества камер — от небольших систем на 4 камеры до распределённых корпоративных комплексов на 500+ потоков.


1. Добавление и настройка камер через REST API ​

Создание записи камеры программным запросом:

bash
# Добавление новой IP-камеры
curl -X POST http://localhost:8080/api/v1/cameras \
  -H "Authorization: Bearer <JWT_ТОКЕН>" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "cam_gate_north",
    "name": "Северный въезд",
    "url": "rtsp://admin:secret@192.168.1.120:554/live",
    "transport": "tcp",
    "folder_id": "fld_perimeter",
    "tags": ["улица", "въезд", "ptz"],
    "recording_enabled": true,
    "lazy_hls": false
  }'

2. Управление камерами через утилиту ruseon-cli ​

bash
# Список всех камер и их текущий статус
ruseon-cli cameras list

# Добавление камеры из командной строки
ruseon-cli cameras add \
  --id cam_warehouse_01 \
  --name "Основной склад" \
  --url "rtsp://admin:pass@192.168.1.130:554/stream1" \
  --transport tcp \
  --record=true

# Проверка доступности потока перед добавлением
ruseon-cli cameras test --url "rtsp://admin:pass@192.168.1.130:554/stream1"

# Удаление камеры
ruseon-cli cameras delete --id cam_warehouse_01

3. Организация через папки и теги ​

Для поддержания порядка в больших инсталляциях:

  • Иерархические папки: Группировка камер по зданиям и этажам (например, Главный офис $\to$ Корпус А $\to$ Этаж 2).
  • Система тегов: Назначение произвольных тегов (ptz, 4k, территория, касса) для быстрой фильтрации в веб-интерфейсе.

4. Массовый импорт и экспорт топологии ​

Экспорт и импорт списка всех камер в формате JSON:

bash
# Экспорт конфигурации всех камер
curl -H "Authorization: Bearer <ТОКЕН>" http://localhost:8080/api/v1/cameras > cameras_backup.json

# Массовый импорт камер из файла
curl -X POST http://localhost:8080/api/v1/cameras/bulk \
  -H "Authorization: Bearer <ТОКЕН>" \
  -H "Content-Type: application/json" \
  -d @cameras_backup.json

Связанная документация ​

Released under the MIT License.