... {toc:maxLevel=3}
h2. Как работает интеграция
Интеграция делалась на максимальное упрощение работы для инженера и абонента: помогите абоненту освоиться с Флюссоником, покажите как пользоваться приложением, проконсультируйте по тарифам и услугам, дайте абоненту самостоятельно их выбрать при подключении. Дальнейшее управление происходит полностью через личный кабинет оператора связи.
По шагам бизнес-процесс подключения абонента к телевидению следующий:
# Получите заявку от абонента на видеонаблюдение
#* Добавьте ему учётную запись Flussonic в биллинге
#* Биллинг сразу создаст на Watcher [организацию|https://flussonic.ru/doc/watcher/upravlenie-organizatsiyami/] и [пользователя|https://flussonic.ru/doc/watcher/upravlenie-polzovatelyami/] для абонента
#* Назначьте инженера
# Отправьте инженера на подключение
#* Установите камеру
#* Добавьте камеры [через мобильное приложение|https://flussonic.ru/doc/watcher/upravlenie-kamerami/#watcher-manage-cameras-add_cam_agent] ([Android|https://play.google.com/store/apps/details?id=com.flussonic.watcher] или [iPhone|https://apps.apple.com/ru/app/flussonic-watcher/id1233594294])
#* Или [вручную в интерфейсе Watcher|https://flussonic.ru/doc/watcher/upravlenie-kamerami/#watcher-manage-cameras-add_camera]
#* При добавлении камеры, {color:#cc0055}{*}укажите настройки, какие захочет абонент{*}{color}
# В течение 5 минут биллинг заберёт параметры новых камер из Watcher, и подключит пользователю услуги в системе
# Если абонент захочет сменить тариф видеонаблюдения, он сделает это в [личном кабинете оператора связи|CarbonBilling:Локальный сайт. Личный кабинет.], вместе с прочими услугами.
h3. Какими параметрами камеры управляет биллинг
!Watcher Камера, управляемые параметры.png|border=0,width=600!
h4. Пресет и "Глубина DVR"
Это связанные параметры - глубина DVR всегда определяется через пресет.
В настройках услуг в биллинге, пресеты определяются парамтером *preset_id*, например:
{code}preset_id=1{code}
h4. Лимит DVR в днях для записи по движению и "Получать события"
Этот параметр определяется отдельно. Его нельзя задавать в пресете. В Watcher предустановлено 16 возможных вариантов этого параметра
В настройках услуг в биллинге, лимит DVR в днях определяются парамтером *dvr_lock_days*, например:
{code}dvr_lock_days=7{code}
Опция камеры "Получать события" должна быть включена, чтобы работало сохранения записи по движению, поэтому если задать параметры лимита DVR, то опция "Получать события" будет включена автоматический.
h4. PTZ
PTZ определяет возможность удалённого управлять камерой. Вы можете включить взимать за это дополнительную плату, но можете и предоставлять эту опцию бесплатно.
В настройках услуг в биллинге, PTZ определяются парамтером *onvif_ptz*, нужно создать только услугу для включения PTZ:
{code}onvif_ptz=True{code}
Если PTZ на камере выключено, биллинг считает это параметром "по-умолчанию", создавать для этого отдельной услуги не нужно.
h4. Состояние (включена/выключена)
Камера будет включена пока оплачены услуги. Если абонента заблокировать, его камеры будут выключены биллингом.
h3. Что будет если поменять эти параметры прямо в Watcher?
В течение пяти минут пройдёт синхронизация и параметры камеры вернутся к тем, что указаны в биллинге.
Например, если абонент заблокирован по балансу, но зайдёт в Watcher и включит камеру - биллинг её выключит.
Если изменит пресет - то вернётся тот пресет, что настроен услугами в биллинге.
h2. Настройка Flussonic
h3. Создайте пресеты
В меню "*Пресеты камер*" добавьте "тарифы" телевидения:
В каждом тарифе укажите:
# *Глубина DVR*: этот параметр нужно задать.
# *Лимит DVR в днях...*: этот параметр *всегда* должен быть "не задано"
# *Доступен во всех организациях*: включите
Название задайте каждому пресету любое, удобное Вам.
Опции "Лимит DVR в ГБ" и "Настраиваемый" не определяются интеграцией, укажите любые. Рекомендуется оставить как на скриншоте.
| !Watcher Пресеты список.png|border=0,width=700! | !Watcher Пресет настройки.png|border=0,width=350! |
h3. Настройте пользователя для управления камерами
Добавьте пользователя, например *service* или *support* - это будет служебная учетная запись, от имени него биллинг будет управлять параметрами камер.
!Watcher Пользователи.png|border=0,width=800!
Настройте пользователю "разрешения" как на скриншоте, он должен быть включен и являться администратором.
!Watcher Пользователь, настройки.png|border=0,width=700!
Авторизуйтесь от созданного пользователя в интерфейсе Watcher и зайдите в настройки профиля
!Watcher Пользотватель, кнопка перехода в профиль.png|border=0,width=600!
Сгенерируйте ключ API, если его ещё нет, или скопируйте существующий. Он понадобится при настройке интеграции со стороны биллинга.
!Watcher Пользователь, профиль.png|border=0,width=600!
h3. Настройте интеграцию с биллингом
# Запишите системный "Ключ API" - он используется как резервный при интеграции, если настройка служебного пользователя или доступа к камерам будет нарушена.
# В области "Главная страница" укажите путь к обработчику auth_flussonic.php на биллинге, на него мы ожидаем запросы авторизации, например:
{code}https://169.254.14.43:2443/auth_flussonic.php{code}
169.254.14.43 замените на IP биллинга
# В области "Уведомления о событиях" укажите путь до обработчика integration_flussonic.php, на него мы получаем информацию о появившихся в сети камерах, например:
{code}https://169.254.14.43:2443/integration_flussonic.php{code}
169.254.14.43 так же замените на IP биллинга
!Watcher Системные настройки.png|border=0,width=600!
h2. Настройка Billing
h3. Настройте NAS
Добавьте NAS со схемой Flussonic и версией 2
IP-адрес укажите любой - его заполнить обязательно только чтобы создался NAS.
Каталог OSS заполнится автоматический.
!Watcher NAS описание.png|border=0,width=350!
На вкладке "Управление", инициализируйте схему, откройте закладку "Настройка", файл main.ini и заполните данные доступа к Watcher:
* watcher_url - путь к Flussonic в Вашей сети
* watcher_api_system_key - системный ключ из общих настроек пользователя, он нужен как резервный
* watcher_api_key - ключ API из профиля служебного пользователя
* watchet_api_user - логин этого пользователя
!Watcher NAS main_ini.png|border=0,width=500!
{code:title=Пример main.ini}tmplt=tmplt/main.cfg.tmplt
enabled="1"
watcher_url=https://watcher.provider.ru
watcher_api_system_key=50od9t83-f80o-39i8-okd0-d9k3kd8i0ov
watcher_api_key=p29kbk54gj3eszy2mrdpnw36a
watcher_api_user=service{code}
h3. Настройте услуги
|| Вкладка "Основные" || Вкладка "Дополнительно" || Вкладка "Личный кабинет" ||
| * *Тип*: обязательно "Стандартный"
* *Цена*: укажите размер абонентской платы за период
* *Метод списания*: любой с периодическим списанием
!Watcher услуга пресета, основные.png|border=0,width=300! \\ !Watcher услуга пресета, абонплата.png|border=0,width=300! | * *Строка с доп. параметрами*: ID пресетов и доп. услуг
* *NAS*: укажите NAS Flussonic
!Watcher услуга пресета, дополнительно.png|border=0,width=300! | Настройте возможность включения и отключения услуги
из личного кабинета
!Watcher услуга пресета, личный кабинет.png|border=0,width=300! |
h4. Услуги для пресетов, примеры
||Название услуги||Стоимость||Строка с дополнительными
параметрами по {color:green}активации{color}||Строка с дополнительными
параметрами по {color:red}деактивации{color}||[Тип услуги|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=50660430#Услуги-Вкладка"Основные"]||[Метод списания|CarbonBilling:Методы списания]||[Тип списания|CarbonBilling:Типы списания]||
|Flussonic: тариф Default (служебный, для сотрудников)|0|preset_id=1|preset_id=1|Стандартный|Ежемесячно|Предоплата|
|Flussonic: тариф без хранения, онлайн|100|preset_id=2|preset_id=2|Стандартный|Ежемесячно|Предоплата|
|Flussonic: тариф Базовый|200|preset_id=3|preset_id=3|Стандартный|Ежемесячно|Предоплата|
|Flussonic: тариф Удобный|500|preset_id=4|preset_id=4|Стандартный|Ежемесячно|Предоплата|
h4. Услуга лимита DVR для записи по движению, примеры
Лимит DVR в днях для записей по движению - количество дней, в течение которых необходимо хранить записи событий движения. Этот лимит устанавливается в дополнение к глубине архива.
В отличие от пресетов, список для выбора глубины лимита записи по движению предустановлен в Watcher. Вы можете создать услуги именно с указанными параметрами по активации и деактивации, выбрав собственные параметры списания и указав своё название.
||Название услуги||Стоимость||Строка с дополнительными
параметрами по {color:green}активации{color}||Строка с дополнительными
параметрами по {color:red}деактивации{color}||[Тип услуги|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=50660430#Услуги-Вкладка"Основные"]||[Метод списания|CarbonBilling:Методы списания]||[Тип списания|CarbonBilling:Типы списания]||
|Flussonic: лимит DVR записи по движению не задано|0|dvr_lock_days=None|dvr_lock_days=None|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 1 день|30|dvr_lock_days=1|dvr_lock_days=1|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 2 дня|50|dvr_lock_days=2|dvr_lock_days=2|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 3 дня|70|dvr_lock_days=3|dvr_lock_days=3|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 4 дня|90|dvr_lock_days=4|dvr_lock_days=4|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 5 дней|100|dvr_lock_days=5|dvr_lock_days=5|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 6 дней|115|dvr_lock_days=6|dvr_lock_days=6|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 1 неделя|130|dvr_lock_days=7|dvr_lock_days=7|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 10 дней|140|dvr_lock_days=10|dvr_lock_days=10|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 2 недели|180|dvr_lock_days=14|dvr_lock_days=14|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 1 месяц|360|dvr_lock_days=30|dvr_lock_days=30|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 40 дней|480|dvr_lock_days=40|dvr_lock_days=40|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 2 месяца|720|dvr_lock_days=60|dvr_lock_days=60|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению 3 месяца|900|dvr_lock_days=90|dvr_lock_days=90|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению полгода|1620|dvr_lock_days=180|dvr_lock_days=180|Стандартный|Ежемесячно|Предоплата|
|Flussonic: лимит DVR записи по движению год|2555|dvr_lock_days=365|dvr_lock_days=365|Стандартный|Ежемесячно|Предоплата|
h4. Услуга удалённого управления камерой (PTZ), пример
Включение PTZ позволит абоненту удалённо управлять положением камеры (должно поддерживаться моделью камеры)
||Название услуги||Стоимость||Строка с дополнительными
параметрами по {color:green}активации{color}||Строка с дополнительными
параметрами по {color:red}деактивации{color}||[Тип услуги|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=50660430#Услуги-Вкладка"Основные"]||[Метод списания|CarbonBilling:Методы списания]||[Тип списания|CarbonBilling:Типы списания]||
|
...
Добавьте [учётную запись|CarbonBilling:Учетная запись. Создание и изменение.], привязанную к NAS со схемой Flussonic версии 2.
Биллинг сразу создаст на Watcher [организацию|https://flussonic.ru/doc/watcher/upravlenie-organizatsiyami/] и [пользователя|https://flussonic.ru/doc/watcher/upravlenie-polzovatelyami/] для абонента
Остальные поля не важны, в том числе тип авторизации. "Внешний ИД" заполнится автоматический после создания пользователя на Flussonic.
h3. Отправьте инженера подключить абоненту камеру
Установите камеру и авторизуйтесь в Watcher с учётной записью ранее созданной для абонента.
Добавьте абоненту камеры [через мобильное приложение|https://flussonic.ru/doc/watcher/upravlenie-kamerami/#watcher-manage-cameras-add_cam_agent] ([Android|https://play.google.com/store/apps/details?id=com.flussonic.watcher] или [iPhone|https://apps.apple.com/ru/app/flussonic-watcher/id1233594294]).
При добавлении камеры, {color:#cc0055}{*}укажите настройки, какие захочет абонент{*}{color}
Камеру можно настроить в [вручную в интерфейсе Watcher|https://flussonic.ru/doc/watcher/upravlenie-kamerami/#watcher-manage-cameras-add_camera], например если в ней нет агента Watcher, но к ней есть прямой доступ по белому IP-адресу.
h3. Биллинг синхронизирует выбранные настройки
Биллинг автоматический подключит абоненту услуги по каждой добавленной камере
!Watcheh Абонент, вкладка услуги.png|border=0,width=900!
Каждая подключенная услуга привязывается к камере из справочника оборудорвания (тоже синхронизируются биллингом автоматический)
!Watcheh Абонент, подключенная услуга.png|border=0,width=700!
h3. Камеры абонента появятся в справочнике "Оборудование"
URL потока вещания - это прямая ссылка на видеопоток с камеры, её можно открыть в браузере.
!Watcheh Абонент, параметры камеры.png|border=0,width=600!
h2. Отладка
h3. Журнал синхронизации
|
