Інтеграція IP-домофонії BAS-IP з існуючими системами будівлі
На одному об’єкті керуюча компанія працює в платформі управління нерухомістю, служба безпеки — у СКУД, а мешканці — в окремому мобільному додатку. Якщо домофонія залишається ще однією ізольованою системою, одних і тих самих користувачів, права доступу та події доводиться вести відразу в декількох місцях.
BAS-IP можна вбудувати в цифрову інфраструктуру будівлі, яка вже використовується. Керуюча платформа залишається основним робочим інтерфейсом для персоналу, а існуючий додаток для мешканців отримує функції домофонії та відкриття дверей.
Шляхів для цього чотири: сумісність за стандартними протоколами, BAS-IP Link API, BAS-IP Mobile SDK та BAS-IP Device API. Нижче — що підходить під яке завдання.
Що таке BAS-IP Link
BAS-IP Link — програмна платформа, яка керує підключеними пристроями BAS-IP, об’єктами та квартирами, користувачами, ідентифікаторами доступу, викликами та конфігурацією обладнання.
Вона доступна у двох варіантах: Link Self-Hosted на сервері замовника та Link Cloud як хмарний сервіс BAS-IP.
Сумісність за стандартними протоколами
Не для кожного завдання потрібні розробники. Обладнання BAS-IP працює за тими ж стандартними протоколами, що й телефонія, відеоспостереження та системи контролю доступу:
- SIP — панель реєструється як SIP-клієнт на АТС замовника, а виклики приходять на існуючі телефони та софтфони;
- RTSP — панель підключається до VMS або NVR як джерело відео разом із рештою камер об’єкта;
- Wiegand — зчитувач панелі передає ідентифікатор у сторонню систему контролю доступу.
Такі сценарії налаштовуються з обох боків і не вимагають роботи з BAS-IP API або SDK.
Примітка. Для SIP-сценарію необхідно заздалегідь перевірити сумісність аудіо- та відеокодеків сторонньої системи з конкретним обладнанням BAS-IP. Наприклад, обладнання BAS-IP підтримує сценарії з PCMA для аудіо та H.264 для відео. Актуальний набір кодеків необхідно перевіряти для конкретної моделі та версії прошивки.
Стандартні протоколи дозволяють передавати виклики, відеопотоки та ідентифікатори, але самі по собі не забезпечують синхронізацію користувачів, квартир і прав доступу між системами.
Якщо потрібно автоматизувати управління користувачами, видачу та відкликання прав доступу або роботу з журналами подій, використовуються API або SDK.
BAS-IP Link API: інтеграція з керуючою або серверною платформою
Link API дозволяє автоматизувати управління мешканцями, правами доступу та подіями BAS-IP через вже використовувану платформу управління нерухомістю, СКУД або іншу корпоративну систему.
Простий приклад — заселення мешканця.
Співробітник створює профіль у своїй платформі: ім’я, квартиру та контактні дані. Без інтеграції того ж користувача заводять вдруге вручну в системі домофонії.
Через Link API дані передаються автоматично: користувач з’являється в потрібному об’єкті та квартирі в BAS-IP Link, а звідти інформація застосовується до підключеної інфраструктури BAS-IP.
Це лише один зі сценаріїв.
Через Link API стороння система може працювати з:
- користувачами та структурою об’єктів;
- правами доступу;
- постійними ідентифікаторами: картками, брелоками, кодами, QR-кодами, Face ID, UKEY та номерами автомобілів;
- тимчасовими ідентифікаторами з обмеженим терміном дії;
- гостьовим доступом і відвідувачами;
- повідомленнями для мешканців;
- віртуальними номерами та переадресацією викликів;
- віддаленою конфігурацією пристроїв;
- подіями та журналами.
Конкретний набір залежить від завдання.
При такій схемі основна платформа замовника може залишатися робочим інтерфейсом його співробітників.
Наразі сторонні серверні інтеграції через Link API підтримуються в BAS-IP Link Self-Hosted. Для проектів на Link Cloud доступні варіріанти інтеграції необхідно узгодити з BAS-IP.
BAS-IP Mobile SDK: домофонія всередині власного додатка
Другий сценарій — у компанії вже є мобільний додаток для мешканців, орендарів або співробітників.
У ньому можуть бути заявки в керуючу компанію, платежі, бронювання приміщень і повідомлення. Окремий додаток тільки для домофонії в такій ситуації може бути надлишковим.
BAS-IP Mobile SDK дозволяє вбудувати в існуючий додаток широкий набір функцій домофонії та управління доступом через BAS-IP Link. Серед доступних можливостей:
- авторизація користувача;
- прийом і здійснення викликів з аудіо та відео;
- перегляд відео з панелі до відповіді на виклик;
- push-повідомлення;
- відкриття дверей;
- історія викликів;
- мобільний доступ по BLE через компонент UKEY;
- виклик ліфта на дозволений поверх за наявності налаштованого ліфтового модуля BAS-IP.
Підтримуються iOS та Android.
Мешканець приймає виклик з панелі прямо в додатку, яким вже користується, може побачити відвідувача ще до відповіді та відкрити двері.
Розробнику при цьому не потрібно будувати домофонний модуль з нуля: деталі SIP-комунікації та взаємодії з BAS-IP Link вже реалізовані в готових компонентах, а завдання команди партнера — вбудувати їх у свій додаток.
Mobile SDK не повторює весь функціонал додатка BAS-IP Link, а дає певний набір готових можливостей.
Деякі функції, відсутні в Mobile SDK, доступні через BAS-IP Link API. Наприклад, створення гостьових QR-кодів і бронювання приміщень можна реалізувати в додатку партнера через додаткову інтеграцію з Link API.
Інтеграція сторонніх мобільних додатків через Mobile SDK зараз підтримується в BAS-IP Link Self-Hosted.
BAS-IP Device API: пряма робота з обладнанням
Не кожна інтеграція вимагає BAS-IP Link.
Викличні панелі, внутрішні монітори та інші підтримувані пристрої BAS-IP, включаючи ліфтовий модуль, мають власний локальний API, тому стороння система може звертатися до обладнання безпосередньо.
Різниця проста:
- Device API пов’язує вашу систему безпосередньо з конкретними пристроями BAS-IP.
- Link API пов’язує вашу систему з BAS-IP Link, який вже керує підключеним обладнанням.
Пряма робота з пристроями підходить для локального проекту з обмеженим і заздалегідь відомим набором моделей.
Інтеграція через Link зручніша, коли система охоплює різні моделі, велику кількість пристроїв або кілька об’єктів: Link знижує залежність інтеграції від особливостей окремих моделей та їх прошивок.
Доступ до Device API отримати простіше: документація відкрита, NDA не потрібна. Достатньо зареєструватися на порталі розробників BAS-IP — developers.bas-ip.com — і підтвердити email.
Webhooks
Android-панелі BAS-IP додатково підтримують webhooks.
Зовнішня система отримує події в момент, коли вони відбуваються: відкриття дверей, надання або відмова в доступі, оновлення пристрою та інші події журналу.
Це зручно для сценаріїв розумної будівлі, де на прохід або відкриття дверей повинна реагувати інша система.
Webhooks налаштовуються безпосередньо на панелі через конфігурацію пристрою.
На Linux-панелях, моніторах і на рівні BAS-IP Link webhooks не підтримуються.
Який спосіб інтеграції вибрати
| Якщо у вас вже є | Зазвичай підходить | Основне завдання |
|---|---|---|
| Телефонія, VMS або СКУД | SIP, RTSP, Wiegand | Передати виклик, відеопотік або ідентифікатор без глибокої програмної інтеграції |
| Платформа управління нерухомістю, СКУД або інша серверна система | BAS-IP Link API | Зв’язати користувачів, доступ і процеси BAS-IP з існуючою платформою |
| Власний мобільний додаток | BAS-IP Mobile SDK | Додати виклики, відео та відкриття дверей в існуючий додаток |
| Локальна система з конкретними пристроями BAS-IP | BAS-IP Device API | Працювати з обладнанням безпосередньо; на Android-панелях — у тому числі отримувати події через webhooks |
| Серверна платформа і власний мобільний додаток | Link API + Mobile SDK | Закрити і серверні процеси, і користувацькі функції |
Визначати підхід заздалегідь необов’язково. Найчастіше він стає зрозумілим після того, як описані існуюча система і потрібний сценарій.
Що це дає на об’єкті
- Швидше початкове налаштування: дані про користувачів і пов’язані з ними параметри можна передавати з системи, де вони вже ведуться.
- Менше повторного введення: одні й ті самі дані не потрібно заносити в кілька інтерфейсів.
- Спільні дані об’єкта: події домофонії та доступу можна збирати разом з рештою інформації.
- Звичні робочі процеси: персонал продовжує працювати в знайомій системі, а мешканці — в одному додатку.
Чим більший об’єкт, кількість користувачів і пов’язаних систем, тим помітніший ефект.
Як проходить інтеграція
Робота починається з обговорення завдання. Партнер розповідає, яку систему використовує і що хоче реалізувати. Наприклад, приймати виклики з домофонів BAS-IP у власному додатку для мешканців або автоматично передавати дані про нових користувачів з платформи управління нерухомістю. На основі цих вимог BAS-IP допомагає вибрати відповідний спосіб інтеграції та узгодити, як має працювати готове рішення.
Коли сценарій визначено, команда партнера отримує необхідні технічні матеріали і може приступати до розробки. Для роботи з Link API та Mobile SDK попередньо підписується NDA, а документація по Device API доступна відкрито. Умови надання тестового середовища, ліцензій та обладнання обговорюються з урахуванням особливостей проекту.
Саму інтеграцію розробляє команда партнера, а фахівці BAS-IP консультують щодо роботи своїх продуктів і допомагають розібратися з технічними питаннями, що виникають у процесі. Якщо для реалізації задуманого сценарію не вистачає існуючих можливостей BAS-IP, можна обговорити додаткову розробку. Терміни таких доопрацювань залежать від обсягу робіт і поточних пріоритетів продуктової команди.
Після завершення розробки партнер тестує інтеграцію у своєму середовищі, а потім демонструє результат BAS-IP або надає опис реалізованого рішення.
Тривалість інтеграції залежить від складності проекту, архітектури сторонньої системи та завантаження команди розробників. На терміни також впливають підготовка середовища розробки та тестування.
Скільки це коштує
BAS-IP за замовчуванням не стягує окремої плати за доступ до документації та інструментів інтеграції.
Ліцензування продуктів BAS-IP при цьому здійснюється на звичайних умовах, а додаткові доопрацювання або зміна їх пріоритету узгоджуються окремо.
Часті запитання
Чим Link API відрізняється від Mobile SDK?
Link API зв’язує BAS-IP з серверною системою — наприклад, платформою управління нерухомістю або СКУД. Mobile SDK додає функції домофонії в мобільний додаток. В одному проекті їх можна використовувати разом.
Чи потрібен BAS-IP Link для інтеграції?
Не завжди. Багато пристроїв BAS-IP мають власний локальний API, тому стороння система може працювати з обладнанням безпосередньо. Link зазвичай зручніший, коли інтеграція охоплює різні моделі, багато пристроїв або кілька об’єктів.
Чи потрібна NDA?
NDA вимагається для Link API та Mobile SDK. Документація по Device API відкрита.
Чи є webhooks?
Так, на Android-панелях. Зовнішня система може отримувати події пристрою в реальному часі. На Linux-панелях, моніторах і на рівні Link webhooks немає.
Чи можна інтегрувати сторонню платформу з BAS-IP Link Cloud?
Зовнішні інтеграції сторонніх серверних систем через Link API зараз реалізуються на Link Self-Hosted. Для Link Cloud така можливість знаходиться в розробці.
Хочете інтегрувати BAS-IP зі своєю системою?
Розкажіть, яку платформу, додаток або обладнання ви використовуєте і який сценарій хочете реалізувати.
Команда BAS-IP допоможе визначити відповідний варіант: сумісність за протоколами, Link API, Mobile SDK, Device API або їх комбінацію.