Integracja domofonów IP BAS-IP z istniejącymi systemami budynkowymi

W ramach jednego obiektu zespół zarządzający może pracować w platformie zarządzania nieruchomością, zespół ochrony w systemie kontroli dostępu, a mieszkańcy w osobnej aplikacji mobilnej. Jeśli system domofonowy pozostaje kolejną izolowaną częścią budynku, to ci sami użytkownicy, uprawnienia i zdarzenia muszą być zarządzani w kilku miejscach.

System BAS-IP można zintegrować z istniejącą infrastrukturą cyfrową budynku. Platforma zarządzania nieruchomością może pozostać głównym interfejsem operacyjnym dla personelu, podczas gdy istniejąca aplikacja dla mieszkańców może zyskać funkcje domofonu, wideo i otwierania drzwi.

Istnieją cztery główne podejścia: interoperacyjność poprzez standardowe protokoły, BAS-IP Link API, BAS-IP Mobile SDK oraz BAS-IP Device API. Właściwy wybór zależy od tego, co wymaga integracji i jak działa obecny system.

Czym jest BAS-IP Link?

BAS-IP Link to platforma oprogramowania do zarządzania podłączonymi urządzeniami BAS-IP, obiektami i mieszkaniami, użytkownikami, uprawnieniami (poświadczeniami dostępu), połączeniami oraz konfiguracją urządzeń.

Jest dostępna w dwóch modelach wdrożenia: Link Self-Hosted (instalowana na własnej infrastrukturze serwerowej klienta) oraz Link Cloud (dostarczana jako usługa w chmurze BAS-IP).

Niektóre integracje działają poprzez platformę Link, podczas gdy inne komunikują się bezpośrednio ze sprzętem BAS-IP.

Interoperacyjność poprzez standardowe protokoły

Nie każda integracja wymaga tworzenia oprogramowania.

Sprzęt BAS-IP obsługuje standardowe protokoły już powszechnie stosowane w systemach telefonii, monitoringu wizyjnego (CCTV) i kontroli dostępu:

• SIP: panel wejściowy rejestruje się jako klient SIP na centrali PBX klienta, co pozwala na kierowanie połączeń do istniejących aparatów i softphonów;
• RTSP: panel może zostać dodany do systemu VMS lub rejestratora NVR jako źródło wideo obok innych kamer CCTV na obiekcie;
• Wiegand: czytnik wbudowany w panel może przekazywać identyfikator do systemu kontroli dostępu innej firmy.

Te scenariusze są konfigurowane po obu stronach i nie wymagają prac programistycznych z użyciem API lub SDK BAS-IP.

Uwaga. W przypadku integracji SIP należy wcześniej sprawdzić kompatybilność kodeków audio i wideo między systemem innej firmy a konkretnym sprzętem BAS-IP. Na przykład urządzenia BAS-IP obsługują scenariusze z wykorzystaniem PCMA dla dźwięku i H.264 dla wideo. Aktualnie obsługiwany zestaw kodeków powinien być zawsze sprawdzony dla danego modelu i wersji oprogramowania układowego (firmware).

Standardowe protokoły mogą przenieść połączenie, strumień wideo czy identyfikator, ale nie rozumieją kim jest dany użytkownik, do jakiego mieszkania należy ani jakie powinien mieć prawa dostępu.

Kiedy integracja musi pracować na samych danych – tworzyć użytkowników, przyznawać lub odbierać dostęp, lub pobierać zdarzenia – wymagane jest użycie API lub SDK.

BAS-IP Link API: integracja z platformą zarządzania nieruchomością lub systemem serwerowym

Link API zostało zaprojektowane dla przypadków, gdy system zewnętrzny musi programowo współdziałać z BAS-IP Link: na przykład platforma zarządzania nieruchomością, system kontroli dostępu lub inna platforma korporacyjna używana już w obiekcie.

Prostym przykładem jest wprowadzenie się nowego mieszkańca.

Pracownik tworzy profil mieszkańca w dotychczasowej platformie: imię i nazwisko, numer mieszkania i dane kontaktowe. Bez integracji ten sam użytkownik musi być potem tworzony ręcznie po raz drugi w systemie domofonowym.

Dzięki Link API dane mogą zostać przesłane automatycznie. Użytkownik jest tworzony we właściwym obiekcie i mieszkaniu w BAS-IP Link, skąd informacja może zostać zaaplikowana do podłączonej infrastruktury BAS-IP.

To tylko jeden z możliwych przypadków użycia.

Poprzez Link API, system innej firmy może pracować z:

• użytkownikami i strukturą obiektów;
• prawami dostępu;
• stałymi uprawnieniami (identyfikatorami) dostępu, w tym z kartami, brelokami, kodami PIN, kodami QR, Face ID, UKEY oraz numerami rejestracyjnymi pojazdów;
• uprawnieniami tymczasowymi o określonym okresie ważności;
• dostępem dla gości i odwiedzających;
• wysyłaniem wiadomości do mieszkańców;
• numerami wirtualnymi i przekierowywaniem połączeń;
• zdalną konfiguracją urządzeń;
• zdarzeniami i logami systemowymi.

Dokładny zakres wykorzystywanej funkcjonalności zależy od wymagań projektu.

Przy takiej architekturze istniejąca platforma klienta może pozostać codziennym interfejsem operacyjnym dla jego personelu.

Obecny status. Zewnętrzne integracje serwerowe poprzez Link API są obecnie implementowane na BAS-IP Link Self-Hosted.

Obsługa dla BAS-IP Link Cloud jest w fazie rozwoju i będzie dostarczana za pośrednictwem bramy API (API gateway).

Jeśli projekt ma wykorzystywać Link Cloud, wymagany scenariusz użycia i dostępne opcje powinny zostać omówione z BAS-IP przed rozpoczęciem prac programistycznych.

BAS-IP Mobile SDK: funkcje domofonowe w Twojej własnej aplikacji mobilnej

Drugi powszechny scenariusz dotyczy organizacji, która posiada już własną aplikację mobilną dla mieszkańców, najemców lub pracowników.

Taka aplikacja może już obsługiwać zgłoszenia serwisowe, płatności, rezerwacje udogodnień i powiadomienia. Wprowadzanie osobnej aplikacji wyłącznie do obsługi domofonów może więc być niepotrzebne.

BAS-IP Mobile SDK dodaje do istniejącej aplikacji kluczowe funkcje interkomu i kontroli wejścia za pośrednictwem BAS-IP Link, w tym:

• uwierzytelnianie użytkownika;
• przychodzące i wychodzące połączenia audio i wideo;
• podgląd wideo na żywo z panelu wejściowego przed odebraniem połączenia;
• powiadomienia push;
• otwieranie drzwi;
• historię połączeń;
• dostęp mobilny oparty na technologii BLE poprzez komponent UKEY;
• wzywanie windy na piętro mieszkańca.

Obsługiwane są zarówno systemy iOS, jak i Android.

Mieszkaniec może odebrać połączenie z panelu zewnętrznego bezpośrednio w aplikacji, z której już korzysta, zobaczyć podgląd odwiedzającego na żywo przed odebraniem i otworzyć drzwi.

Zespół programistów nie musi budować warstwy połączeń domofonowych od podstaw. Komunikacja SIP oraz interakcja z BAS-IP Link są już obsługiwane przez dostarczone komponenty; zadaniem partnera jest wbudowanie tych komponentów we własną aplikację.

Mobile SDK nie odwzorowuje każdej funkcji dostępnej w autorskiej aplikacji BAS-IP Link. Zapewnia natomiast zdefiniowany zestaw gotowych możliwości.

Jeśli jakaś wymagana funkcja nie jest zawarta w SDK — na przykład generowanie kodów QR dla gości — partner może ją zaimplementować we własnej aplikacji, używając bezpośrednich wywołań do Link API.

Obecny status. Integracje z Mobile SDK są realizowane na BAS-IP Link Self-Hosted.

Projekty wymagające BAS-IP Link Cloud powinny być planowane po udostępnieniu bramy Cloud API.

BAS-IP Device API: bezpośrednia integracja z urządzeniami

Nie każda integracja wymaga środowiska BAS-IP Link.

Panele zewnętrzne BAS-IP, monitory wewnętrzne i inne obsługiwane urządzenia (w tym moduł windy) posiadają własne, lokalne interfejsy API. System innej firmy może zatem komunikować się bezpośrednio ze sprzętem.

Różnica jest prosta:

• Device API łączy Twój system bezpośrednio z konkretnymi urządzeniami BAS-IP.
• Link API łączy Twój system z serwerem BAS-IP Link, który z kolei zarządza podłączonym sprzętem BAS-IP.

Bezpośrednia integracja z urządzeniem dobrze sprawdza się w przypadku lokalnych projektów z ograniczoną i znaną pulą modeli urządzeń.

Integracja poprzez Link jest z reguły bardziej odpowiednia tam, gdzie rozwiązanie obejmuje różne modele, większą liczbę urządzeń lub wiele lokalizacji. Link zmniejsza bowiem zależność integracji od specyfiki poszczególnych modeli sprzętu i wersji oprogramowania układowego.

Uzyskanie dostępu do Device API jest prostsze: dokumentacja jest publicznie dostępna i nie wymaga podpisywania umowy o poufności (NDA).

Programiści mogą zarejestrować się przez portal dla deweloperów BAS-IP i potwierdzić swój adres e-mail.

Webhooks (Webhooki)

Panele zewnętrzne BAS-IP oparte na systemie Android obsługują również webhooki.

Dzięki temu system zewnętrzny może na bieżąco odbierać zdarzenia w miarę ich występowania, w tym otwarcia drzwi, uzyskanie lub odmowę dostępu, aktualizacje urządzeń i inne zdarzenia odnotowane w dzienniku (logach) urządzenia.

Jest to przydatne w scenariuszach budynków inteligentnych (smart building), gdzie inny system musi natychmiast zareagować na zdarzenie dostępowe lub otwarcie drzwi.

Webhooki są konfigurowane bezpośrednio na panelu wejściowym poprzez ustawienia urządzenia.

Nie są one obsługiwane na panelach opartych na Linuksie, na monitorach wewnętrznych ani na poziomie platformy BAS-IP Link.

Które podejście do integracji wybrać?

Nie trzeba z góry decydować o metodzie integracji. W większości przypadków odpowiednie podejście staje się jasne po tym, jak zdefiniuje się istniejący system oraz wymagany scenariusz użytkowania.

Co daje integracja na obiekcie?

• Szybszą konfigurację początkową: dane użytkowników i powiązane z nimi parametry można przenieść z systemu, w którym są już utrzymywane.
• Mniej powielonego wprowadzania danych: tych samych informacji nie trzeba wprowadzać wielokrotnie w różnych interfejsach.
• Zunifikowane dane operacyjne: zdarzenia z domofonów, wejść i kontroli dostępu można zestawić z innymi informacjami z obiektu.
• Znane schematy pracy (workflows): personel może nadal pracować w systemach, które już zna, a mieszkańcy mogą korzystać z pojedynczej aplikacji.

Im większy obiekt, baza użytkowników i liczba połączonych systemów, tym korzyści stają się bardziej zauważalne.

Jak przebiega projekt integracyjny?

Organizacja zaczyna od opisu swojego obecnego systemu i wymaganego scenariusza. Na przykład: „Mamy już aplikację dla mieszkańców i chcemy, aby mieszkańcy odbierali w niej połączenia domofonowe”.

BAS-IP pomaga zidentyfikować odpowiednią metodę integracji i uzgodnić oczekiwany rezultat.

W przypadku Link API i Mobile SDK materiały techniczne są dostarczane po zatwierdzeniu projektu i podpisaniu umowy NDA. Dla każdego partnera tworzony jest osobny projekt zawierający wymagane specyfikacje.

Dokumentacja dla Device API jest publicznie dostępna.

Samą integrację rozwija zespół po stronie partnera.

BAS-IP odpowiada na pytania techniczne dotyczące swoich produktów, pomaga doprecyzować scenariusz integracji oraz pomaga w sytuacjach, gdy implementacja oparta na dokumentacji nie zachowuje się tak, jak oczekiwano.

Jeśli projekt wymaga funkcjonalności, która aktualnie nie jest dostępna w produkcie, wymóg ten można omówić z zespołem produktowym BAS-IP. Najpierw ocenia się zakres prac i ich miejsce w planie rozwoju. Taka ocena nie stanowi sama w sobie gwarancji na konkretną datę wydania.

Środowisko testowe i kwestie związane ze sprzętem są ustalane dla każdego indywidualnego projektu.

Ukończone rozwiązanie jest testowane przez partnera. Po zakończeniu prac programistycznych partner demonstruje wynik firmie BAS-IP lub dostarcza opis zrealizowanej integracji.

Dla typowej integracji za ogólny punkt odniesienia można przyjąć około miesiąca skupionego czasu programistycznego.

Całkowity czas kalendarzowy z reguły bywa dłuższy, w zależności od dostępności zespołu partnera i czasu potrzebnego na zapoznanie się z systemem.

Ile kosztuje integracja?

BAS-IP standardowo nie pobiera oddzielnych opłat za dostęp do dokumentacji i narzędzi integracyjnych.

Produkty BAS-IP nadal podlegają licencjonowaniu na swoich standardowych warunkach.

Wszelki dodatkowy rozwój produktu lub prośby o zmianę priorytetów takich prac są ustalane osobno.

Często zadawane pytania

Czym różni się Link API od Mobile SDK?

Link API łączy system BAS-IP z systemem serwerowym (np. platformą do zarządzania nieruchomością czy systemem kontroli dostępu). Mobile SDK dodaje funkcje domofonu i otwierania drzwi BAS-IP do aplikacji mobilnej. W jednym projekcie można stosować obie metody łącznie.

Czy BAS-IP Link jest wymagany dla każdej integracji?

Nie. Wiele urządzeń BAS-IP posiada własne, lokalne API, co pozwala zewnętrznym systemom na bezpośrednią komunikację ze sprzętem. Link przeważnie przydaje się tam, gdzie integracja musi objąć wiele modeli urządzeń, dużą liczbę sprzętu lub różne obiekty.

Czy wymagane jest NDA (umowa o poufności)?

NDA jest wymagane dla Link API oraz Mobile SDK. Dokumentacja dla Device API jest z kolei publicznie dostępna.

Czy obsługiwane są webhooki?

Tak, na panelach zewnętrznych opartych na systemie Android. Zewnętrzny system może otrzymywać zdarzenia z urządzenia w czasie rzeczywistym. Webhooki nie są dostępne na panelach działających pod kontrolą Linuksa, w monitorach wewnętrznych ani na poziomie platformy BAS-IP Link.

Czy zewnętrzna platforma może być zintegrowana z BAS-IP Link Cloud?

Integracje serwerowe zewnętrznych firm poprzez Link API są obecnie realizowane na Link Self-Hosted. Podobna funkcjonalność dla Link Cloud znajduje się w fazie rozwoju.

Ilu programistów potrzeba do integracji?

W przypadku Link API z reguły będzie potrzebny programista typu back-end lub full-stack. Dla Mobile SDK niezbędny jest programista aplikacji mobilnych (mobile developer). Większe projekty mogą również wymagać wiedzy z obszaru DevOps.

Chcesz zintegrować BAS-IP ze swoim systemem?

Powiedz nam, z jakiej platformy, aplikacji czy sprzętu już korzystasz i jaki cel chcesz osiągnąć poprzez integrację.

Zespół BAS-IP pomoże zidentyfikować najbardziej odpowiednie podejście: interoperacyjność przez standardowe protokoły, Link API, Mobile SDK, Device API lub ich połączenie.