Інтеграція 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).

Деякі інтеграції працюють через Link, тоді як інші взаємодіють безпосередньо з обладнанням BAS-IP.

Сумісність через стандартні протоколи

Не кожна інтеграція вимагає розробки програмного забезпечення.

Обладнання BAS-IP підтримує стандартні протоколи, які вже широко використовуються в системах телефонії, відеоспостереження (CCTV) та контролю доступу:

• SIP — панель виклику реєструється як SIP-клієнт на PBX клієнта, що дозволяє направляти виклики на існуючі телефонні апарати та софтфони;
• RTSP — панель можна додати до VMS або NVR як джерело відео нарівні з іншими камерами відеоспостереження на об’єкті;
• Wiegand — вбудований у панель зчитувач може передавати ідентифікатор в сторонню систему контролю доступу.

Ці сценарії налаштовуються з обох боків і не вимагають розробки з використанням API або SDK BAS-IP.

Примітка. Для SIP-інтеграцій слід заздалегідь перевіряти сумісність аудіо- та відеокодеків між сторонньою системою та конкретним обладнанням BAS-IP. Наприклад, обладнання BAS-IP підтримує сценарії з використанням PCMA для аудіо та H.264 для відео. Завжди слід перевіряти поточний набір підтримуваних кодеків для відповідної моделі та версії прошивки.

Стандартні протоколи можуть передавати виклик, відеопотік або ідентифікатор, але вони не розуміють, хто є користувачем, до якої квартири він належить або які права доступу він повинен мати.

Коли інтеграція повинна працювати безпосередньо з даними — створювати користувачів, надавати або скасовувати доступ, отримувати події — потрібен API або SDK.

BAS-IP Link API: інтеграція з платформою управління нерухомістю або серверною системою

Link API призначений для випадків, коли сторонній системі потрібно програмно взаємодіяти з BAS-IP Link: наприклад, платформі управління нерухомістю, системі контролю доступу або іншій корпоративній платформі, яка вже використовується на об’єкті.

Простий приклад — заселення мешканця.

Співробітник створює профіль мешканця в існуючій платформі: ім’я, квартира та контактні дані. Без інтеграції цього ж користувача потім доводиться створювати вручну вдруге в системі домофонії.

Завдяки Link API дані можуть передаватися автоматично. Користувач створюється у відповідному об’єкті та квартирі в BAS-IP Link, звідки інформація може бути застосована до підключеної інфраструктури BAS-IP.

Через Link API стороння система може працювати з:

• користувачами та структурою об’єкта;
• правами доступу;
• постійними обліковими даними доступу, включаючи картки, брелоки, PIN-коди, QR-коди, Face ID, UKEY та номерні знаки автомобілів;
• тимчасовими обліковими даними з визначеним терміном дії;
• гостьовим доступом та відвідувачами;
• відправкою повідомлень мешканцям;
• віртуальними номерами та переадресацією викликів;
• віддаленим налаштуванням пристроїв;
• подіями та журналами.

З такою архітектурою існуюча платформа клієнта може залишатися щоденним робочим інтерфейсом для його персоналу.

Поточний статус. Сторонні серверні інтеграції через Link API наразі реалізовані на BAS-IP Link Self-Hosted. Підтримка BAS-IP Link Cloud знаходиться в розробці і буде надаватися через API-шлюз. Якщо проєкт передбачає використання Link Cloud, необхідний варіант використання слід обговорити з BAS-IP до початку розробки.

BAS-IP Mobile SDK: функції домофона у вашому власному мобільному додатку

Другий поширений сценарій — це організація, яка вже має власний мобільний додаток для мешканців, орендарів або співробітників. Цей додаток вже може обробляти запити на обслуговування, платежі, бронювання послуг та сповіщення. Тому впровадження окремого додатка виключно для домофонії може бути зайвим.

BAS-IP Mobile SDK додає ключові функції домофона, входу та доступу до існуючого додатка через BAS-IP Link, зокрема:

• аутентифікацію користувача;
• вхідні та вихідні аудіо- та відеодзвінки;
• перегляд відео в реальному часі з панелі виклику перед відповіддю на дзвінок;
• push-сповіщення;
• відкриття дверей;
• історію викликів;
• мобільний доступ на базі BLE через компонент UKEY;
• виклик ліфта на поверх мешканця.

Підтримуються як iOS, так і Android. Мешканець може відповісти на виклик з панелі прямо в додатку, який він уже використовує, побачити відео з відвідувачем перед відповіддю та відкрити двері.

Команді розробників не потрібно створювати рівень викликів домофона з нуля. SIP-комунікація та взаємодія з BAS-IP Link вже обробляються наданими компонентами; роль партнера полягає в інтеграції цих компонентів у власний додаток.

Mobile SDK не відтворює всі функції, доступні в додатку BAS-IP Link. Він надає визначений набір готових можливостей. Якщо потрібна функція не включена в SDK (наприклад, генерація гостьових QR-кодів), партнер може реалізувати її у власному додатку, використовуючи прямі виклики Link API.

BAS-IP Device API: пряма інтеграція з обладнанням

Не кожна інтеграція потребує BAS-IP Link. Панелі виклику BAS-IP, внутрішні монітори та інші підтримувані пристрої мають власні локальні API. Тому стороння система може взаємодіяти безпосередньо з обладнанням.

• Device API з’єднує вашу систему безпосередньо з конкретними пристроями BAS-IP.
• Link API з’єднує вашу систему з BAS-IP Link, який керує підключеним обладнанням BAS-IP.

Пряма інтеграція пристроїв добре підходить для локального проєкту з обмеженим і відомим діапазоном моделей пристроїв. Інтеграція через Link зазвичай більш доречна, коли рішення охоплює різні моделі або кілька об’єктів.

Отримати доступ до Device API простіше: документація є загальнодоступною і не вимагає підписання NDA.

Webhooks

Панелі виклику BAS-IP на базі Android також підтримують webhooks. Це дозволяє сторонній системі отримувати події в міру їх виникнення (наприклад, відкриття дверей, надання доступу). Це корисно в сценаріях розумної будівлі. Вебхуки налаштовуються безпосередньо на панелі виклику і не підтримуються на панелях на базі Linux.

Який підхід до інтеграції слід вибрати?

Що дає інтеграція на об’єкті?

• Швидше початкове налаштування: дані можна перенести з системи, де вони вже ведуться.
• Менше дублювання введення даних: інформацію не потрібно вводити кілька разів.
• Уніфіковані операційні дані: події домофонії можна об’єднати з іншою інформацією.
• Звичні робочі процеси: персонал працює в знайомих системах, а мешканці використовують єдиний додаток.

Як працює проєкт інтеграції?

Організація описує свою існуючу систему та необхідний варіант використання. BAS-IP допомагає визначити метод інтеграції. Для Link API та Mobile SDK технічні матеріали надаються після підписання NDA. Документація Device API є загальнодоступною. Сама інтеграція розробляється командою партнера. BAS-IP відповідає на технічні питання та надає підтримку. Для типової інтеграції орієнтиром може слугувати близько одного місяця сфокусованої розробки.

Скільки коштує інтеграція?

BAS-IP зазвичай не стягує окремої плати за доступ до документації та інструментів інтеграції. Продукти ліцензуються на стандартних умовах.

Часті питання

• Яка різниця між Link API та Mobile SDK? Link API з’єднує BAS-IP із серверною системою. Mobile SDK додає функції домофона до мобільного додатка. Обидва можна використовувати разом.
• Чи потрібен BAS-IP Link для кожної інтеграції? Ні. Багато пристроїв мають власний локальний API.
• Чи потрібен NDA? NDA потрібен для Link API та Mobile SDK. Документація Device API є відкритою.
• Чи підтримуються webhooks? Так, на панелях виклику на базі Android.
• Скільки розробників потрібно? Для Link API зазвичай потрібен back-end або full-stack розробник, для Mobile SDK — мобільний розробник.