|
Ключ
Эта строка удалена.
Это слово было удалено. Это слово было добавлено.
Эта строка добавлена.
|
Комментарий:
Изменения (1)
просмотр истории страницы... {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 на камере выключено, биллинг считает это параметром "по-умолчанию", создавать для этого отдельной услуги не нужно. Требуется создать отдельную услугу для включения опции с параметром *motion_detector_enabled*. {code}motion_detector_enabled=True{code} Если на камере включено dvr_lock_days, но выключено motion_detector_enabled, то биллинг подключает услугу motion_detector_enabled и включает motion_detector_enabled на камере. Для опций onvif_ptz и motion_detector_enabled есть значение по умолчанию, если соответствующих услуг у абонента нет, то на камере для опции будет выставлено False. h4. Опция "Получать событие" Опция "Получать событие" позволяет сохранять в ЛК Flussonic в разделе "События" фрагменты записи, полученные при срабаотывании датчика движения в камере. 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_v2.php, на него мы получаем информацию о появившихся в сети камерах, например: {code}https://169.254.14.43:2443/integration_flussonic_v2.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. Настройте услуги {info:title=Что нельзя настраивать с услугами Flussonic} # *Делать их включёнными в тариф*: интеграция оперирует только услугами, и не сможет удалить услугу включенную в тариф, если, абонент захочет поменять условия обслуживания по видеонаблюдению |
| Если у абонента видеонаблюдение основной или единственный сервис - создайте тариф "заглушку", с единственной услугутой типо "Стандартная" без стоимости. На вкладке "Дополнительно" включите опцию "Не отображать абоненту". # Включать опцию *Для услуги необходима привязка к учетной записи*: эта опция была сделана для других интеграций (например, выдача белого IPv4) и в услугах Flussonic будет вызывать ошибку. |
| # *Строка с дополнительными параметрами по {color:green}активации{color}* и *Строка с дополнительными параметрами по {color:red}деактивации{color}* должны быть уникальны среди услуг! То есть, нельзя сделать две услуги с "preset_id=2", "dvr_lock_days=None" и так далее. |
| {info} |
... || Вкладка "Основные" || Вкладка "Дополнительно" || Вкладка "Личный кабинет" || | * *Тип*: обязательно "Стандартный" * *Цена*: укажите размер абонентской платы за период * *Метод списания*: любой с периодическим списанием !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:Типы списания]|| |Flussonic: PTZ|50|onvif_ptz=True|onvif_ptz=True|Стандартный|Ежемесячно|Предоплата| h2. Подключение Watcher абоненту h3. Добавьте учётную запись, привязанную к NAS со схемой Flussonic !Watcher Учетная запись абонента.png|border=0,width=500! Добавьте [учётную запись|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. Журнал синхронизации Лог синхронизации всегда по одному пути {code}tail -f /app/asr_billing/var/log/nas_event_daemon/flussonic.log{code} Лог отправленных команд по учетным записям абонентов тоже в папке nas_event_daemon, название состоит из наименования NAS и его IP, например: {code}tail -f /app/asr_billing/var/log/nas_event_daemon/Flussonic_v2_1.1.1.8.log{code} h3. Команды диагностики учётной записи Схемой предусмотрена [диагностика учётной записи|CarbonBilling:Команды диагностики пользователей] - эта информация будет полезна инженерам и разработчикам при обращении абонента в техподдержку. || Информация для оператора биллинга || Сырые данные для разработчика || | !https://docs.carbonsoft.ru/download/attachments/186286637/disgnostic+commands+flussonic+user_info+main.png?version=1&modificationDate=1612859364028|border=0,width=250! | !https://docs.carbonsoft.ru/download/attachments/186286637/disgnostic+commands+flussonic+user_info+dev.png?version=1&modificationDate=1612859498469|border=0,width=200! | h3. Отчёт со списком всех абонентов В статье [CarbonBilling:Примеры технических отчётов] мы подготовили несколько отчётов, которые могут быть полезны администраторам: * [Количество абонентов с услугами привязанными к NAS-серверам|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=175833127#Примерытехническихотчётов-Услуги%2CпривязанныекNASSUP675790] покажет количество абонентов по NAS - то есть, с подключенным видеонаблюдением. * [Flussonic Watcher v2, учтётные записи, камеры и услуги по камерам для схемы интеграции SUP-675790|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=175833127#Примерытехническихотчётов-FlussonicWatcherv2%2Cучтётныезаписи%2CкамерыиуслугипокамерамдлясхемыинтеграцииSUP675790] покажет важные параметры для техподдержки по всем абонентам с учетными записями и камерами Flussonic !Watcheh Абонент, в отчёте.png|border=0,width=700! * [Flussonic Watcher v2, услуги сервиса, которые можно подключить абонентам, с контролем ошибок SUP-772439|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=175833127#Примерытехническихотчётов-FlussonicWatcherv2%2Cуслугисервиса%2Cкоторыеможноподключитьабонентам%2CсконтролемошибокSUP772439] отразит основные параметры услуг Flussonic и укажет на возможные ошибки настройки h2. FAQ h3. Что будет если абонент поменяет параметры камеры прямо на Watcher? В течение пяти минут пройдёт синхронизация и параметры камеры вернутся к тем, что указаны в биллинге. Например, если абонент заблокирован по балансу, но зайдёт в Watcher и включит камеру - биллинг её выключит. Если изменит пресет - то вернётся тот пресет, что настроен услугами в биллинге. h3. Что будет, если удалить камеру на Watcher? Синхронизатор автоматически отключит в биллинге услуги по этой камере в течение 5 минут - этим управляет синхронизация. h3. Если удалить камеру на Watcher, и добавить вновь, что будет в справочнике оборудования? Старая камера останется, добавится новая. Услуги абонента будут только по новой камере. Это связано с тем, что биллинг не имеет представления о камере как физическом объекте, потому что Watcher не всегда отражает серийный номер камеры. Поэтому в качестве "серийного номера" в биллинге мы записываем наименование камеры, указанное в Watcher - оно всегда уникально для новой камеры, и изменится если её удалить и снова добавить тому же или другому абоненту. h3. Как заново синхронизировать камеру? Вы можете вручную удалить услуги по этой камере в течение 5 минут между синхронизациями и поменять параметры камеры на Watcher. Тогда биллинг подгрузит услуги по параметрам камеры, указанным в Watcher - для него это будет новая камера. h3. Если это сделает абонент заблокированный по балансу? Новые услуги подключатся, но сразу будут заблокированы и камера всё равно выключится. h3. Как заменить тариф камеры в администраторской панели? По статье [CarbonBilling:Изменение условий обслуживания]. Привязку оборудования биллинг сохранит в новой услуге. h3. Если удалить учётную запись в биллинге, что будет с ней на Вотчере? Организация и учётная запись останутся на Watcher, Вы можете удалить их вручную. h3. Не работает синхронизация в биллинге с flussonic? В случае, если все настройки указаны корректно, при выполнении диагностики в биллинге удается получить информацию о настройках камер из flussonic, а синхронизация корректно не отрабатывает, требуется выполнить перезапуск службы oss и повторно проверить состояние службы в логах. Перезапуск службы oss {code}chroot /app/asr_billing/ service oss restart{code} {code:title=Фрагмент лога /app/asr_billing/var/log/nas_event_daemon/flussonic.log при работе синхронизации} 2021-06-15 19:31:29,770 - worker - flussonic_sync - DEBUG - compare_cameras_in_organization return 2021-06-15 19:31:29,771 - worker - flussonic_sync - DEBUG - compare_cameras user_processed_cameras_names=[u'test-cam0143'] 2021-06-15 19:31:29,781 - worker - flussonic_sync - DEBUG - compare_cameras return 2021-06-15 19:31:29,782 - worker - flussonic_sync - INFO - Завершена синхронизация Flussonic 2021-06-15 19:31:29,782 - worker - flussonic_sync - INFO - Ждем 5 минут {code} |