Na jednym obiekcie firma zarządzająca pracuje na platformie zarządzania nieruchomościami, służba bezpieczeństwa – w systemie kontroli dostępu (SKD), a mieszkańcy – w osobnej aplikacji mobilnej. Jeśli system domofonowy pozostanie kolejnym odizolowanym systemem, ci sami użytkownicy, prawa dostępu i zdarzenia będą musiały być zarządzane w kilku miejscach jednocześnie.

BAS-IP można zintegrować z infrastrukturą cyfrową budynku, która jest już w użyciu. Platforma zarządzania pozostaje głównym interfejsem pracy dla personelu, a istniejąca aplikacja dla mieszkańców zyskuje funkcje wideodomofonu i otwierania drzwi.

Istnieją cztery drogi, aby to osiągnąć: kompatybilność poprzez standardowe protokoły, BAS-IP Link API, BAS-IP Mobile SDK oraz BAS-IP Device API. Poniżej znajduje się opis tego, co pasuje do jakiego zadania.

Czym jest BAS-IP Link

BAS-IP Link to platforma programowa, która zarządza podłączonymi urządzeniami BAS-IP, obiektami i mieszkaniami, użytkownikami, identyfikatorami dostępu, połączeniami i konfiguracją sprzętu.

Jest dostępna w dwóch wariantach: Link Self-Hosted na serwerze klienta oraz Link Cloud jako usługa chmurowa BAS-IP.

Kompatybilność poprzez standardowe protokoły

Nie do każdego zadania potrzebni są programiści. Sprzęt BAS-IP działa na tych samych standardowych protokołach co telefonia, monitoring wideo i systemy kontroli dostępu:

• SIP — panel rejestruje się jako klient SIP na centrali PBX klienta, a połączenia trafiają na istniejące telefony i softphony;
• RTSP — panel łączy się z VMS lub NVR jako źródło wideo wraz z pozostałymi kamerami w obiekcie;
• Wiegand — czytnik panelu przekazuje identyfikator do zewnętrznego systemu kontroli dostępu.

Takie scenariusze konfiguruje się po obu stronach i nie wymagają one pracy z API czy SDK BAS-IP.

Uwaga. W przypadku scenariusza SIP należy wcześniej sprawdzić kompatybilność kodeków audio i wideo systemu zewnętrznego z konkretnym sprzętem BAS-IP. Przykładowo, sprzęt BAS-IP obsługuje scenariusze z PCMA dla audio i H.264 dla wideo. Aktualny zestaw kodeków należy zweryfikować dla konkretnego modelu i wersji oprogramowania układowego (firmware).

Standardowe protokoły pozwalają na przesyłanie połączeń, strumieni wideo i identyfikatorów, ale same w sobie nie zapewniają synchronizacji użytkowników, mieszkań i praw dostępu pomiędzy systemami.

Jeśli wymagana jest automatyzacja zarządzania użytkownikami, wydawania i odbierania praw dostępu lub praca z dziennikami zdarzeń, wykorzystuje się API lub SDK.

BAS-IP Link API: integracja z platformą zarządzania lub serwerem

Link API pozwala zautomatyzować zarządzanie mieszkańcami, prawami dostępu i zdarzeniami BAS-IP za pośrednictwem używanej już platformy zarządzania nieruchomościami, SKD lub innego systemu korporacyjnego.

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

Pracownik tworzy profil na swojej platformie: imię, nazwisko, mieszkanie i dane kontaktowe. Bez integracji ten sam użytkownik jest dodawany ręcznie po raz drugi do systemu domofonowego.

Za pośrednictwem Link API dane są przesyłane automatycznie: użytkownik pojawia się w odpowiednim obiekcie i mieszkaniu w BAS-IP Link, a stamtąd informacje są stosowane do podłączonej infrastruktury BAS-IP.

To tylko jeden ze scenariuszy.

Poprzez Link API system zewnętrzny może pracować z:

• użytkownikami i strukturą obiektów;
• prawami dostępu;
• stałymi identyfikatorami: kartami, brelokami, kodami, kodami QR, Face ID, UKEY i numerami rejestracyjnymi pojazdów;
• tymczasowymi identyfikatorami o ograniczonym czasie ważności;
• dostępem dla gości i odwiedzających;
• wiadomościami dla mieszkańców;
• numerami wirtualnymi i przekazywaniem połączeń;
• zdalną konfiguracją urządzeń;
• zdarzeniami i dziennikami.

Konkretny zestaw zależy od zadania.

W tym schemacie główna platforma klienta może pozostać interfejsem pracy dla jego pracowników.

Obecnie integracje z zewnętrznymi serwerami za pośrednictwem Link API są obsługiwane w BAS-IP Link Self-Hosted. W przypadku projektów na Link Cloud dostępne opcje integracji należy uzgodnić z BAS-IP.

BAS-IP Mobile SDK: wideodomofon wewnątrz własnej aplikacji

Drugi scenariusz — firma posiada już aplikację mobilną dla mieszkańców, najemców lub pracowników.

Może ona zawierać zgłoszenia do administracji, płatności, rezerwację pomieszczeń i powiadomienia. Oddzielna aplikacja przeznaczona tylko do obsługi domofonu w takiej sytuacji może być zbędna.

BAS-IP Mobile SDK pozwala na osadzenie szerokiego zestawu funkcji wideodomofonu i kontroli dostępu poprzez BAS-IP Link w istniejącej aplikacji. Dostępne funkcje obejmują:

• autoryzację użytkownika;
• odbieranie i wykonywanie połączeń audio i wideo;
• podgląd wideo z panelu przed odebraniem połączenia;
• powiadomienia push;
• otwieranie drzwi;
• historię połączeń;
• dostęp mobilny przez BLE za pomocą komponentu UKEY;
• wezwanie windy na dozwolone piętro w przypadku posiadania skonfigurowanego modułu windowego BAS-IP.

Obsługiwane są systemy iOS i Android.

Mieszkaniec odbiera połączenie z panelu bezpośrednio w używanej już aplikacji, może zobaczyć gościa przed odebraniem połączenia i otworzyć drzwi.

Programista nie musi budować modułu domofonowego od podstaw: szczegóły komunikacji SIP i interakcji z BAS-IP Link są już zaimplementowane w gotowych komponentach, a zadaniem zespołu partnera jest zintegrowanie ich ze swoją aplikacją.

Mobile SDK nie powiela pełnej funkcjonalności aplikacji BAS-IP Link, ale zapewnia określony zestaw gotowych funkcji.

Niektóre funkcje, których brakuje w Mobile SDK, są dostępne za pośrednictwem BAS-IP Link API. Na przykład generowanie kodów QR dla gości i rezerwacja pomieszczeń mogą zostać zrealizowane w aplikacji partnera poprzez dodatkową integrację z Link API.

Integracja z aplikacjami mobilnymi stron trzecich poprzez Mobile SDK jest obecnie obsługiwana w BAS-IP Link Self-Hosted.

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

Nie każda integracja wymaga platformy BAS-IP Link.

Panele wywołania, monitory wewnętrzne i inne obsługiwane urządzenia BAS-IP, w tym moduł windowy, posiadają własne lokalne API, co pozwala zewnętrznemu systemowi na bezpośrednią komunikację ze sprzętem.

Różnica jest prosta:

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

Bezpośrednia praca z urządzeniami jest odpowiednia dla lokalnego projektu z ograniczonym i z góry znanym zestawem modeli.

Integracja poprzez Link jest wygodniejsza, gdy system obejmuje różne modele, dużą liczbę urządzeń lub wiele obiektów: Link zmniejsza zależność integracji od specyfiki poszczególnych modeli i ich oprogramowania.

Dostęp do Device API jest łatwiejszy do uzyskania: dokumentacja jest otwarta, NDA nie jest wymagane. Wystarczy zarejestrować się na portalu deweloperskim BAS-IP — developers.bas-ip.com — i potwierdzić e-mail.

Webhooks

Panele BAS-IP z systemem Android dodatkowo obsługują webhooki (webhooks).

System zewnętrzny odbiera zdarzenia w momencie ich wystąpienia: otwarcie drzwi, przyznanie lub odmowa dostępu, aktualizacja urządzenia i inne zdarzenia z dziennika.

Jest to przydatne w scenariuszach inteligentnego budynku, gdzie inny system musi zareagować na przejście lub otwarcie drzwi.

Webhooki są konfigurowane bezpośrednio na panelu poprzez konfigurację urządzenia.

Na panelach z systemem Linux, monitorach oraz na poziomie BAS-IP Link webhooki nie są obsługiwane.

Jaki sposób integracji wybrać

Nie trzeba z góry określać podejścia. Zazwyczaj staje się ono jasne po opisaniu istniejącego systemu i pożądanego scenariusza.

Co to daje na obiekcie

• Szybsza wstępna konfiguracja: dane o użytkownikach i powiązane z nimi parametry mogą być przesyłane z systemu, w którym są już przechowywane.
• Mniej ponownego wprowadzania danych: te same dane nie muszą być wprowadzane do wielu interfejsów.
• Wspólne dane obiektu: zdarzenia z domofonów i systemu dostępu mogą być gromadzone wraz z pozostałymi informacjami.
• Znane procesy pracy: personel kontynuuje pracę w znajomym systemie, a mieszkańcy – w jednej aplikacji.

Im większy obiekt, liczba użytkowników i połączonych systemów, tym wyraźniejszy jest efekt.

Jak przebiega integracja

Praca zaczyna się od omówienia zadania. Partner opowiada, z jakiego systemu korzysta i co chce zrealizować. Na przykład: odbieranie połączeń z domofonów BAS-IP we własnej aplikacji dla mieszkańców lub automatyczne przesyłanie danych o nowych użytkownikach z platformy zarządzania nieruchomościami. Na podstawie tych wymagań BAS-IP pomaga wybrać odpowiedni sposób integracji i uzgodnić, jak powinno działać gotowe rozwiązanie.

Gdy scenariusz zostanie zdefiniowany, zespół partnera otrzymuje niezbędne materiały techniczne i może przystąpić do prac programistycznych. W przypadku pracy z Link API i Mobile SDK wymagane jest wcześniejsze podpisanie NDA, podczas gdy dokumentacja dla Device API jest ogólnodostępna. Warunki udostępnienia środowiska testowego, licencji i sprzętu są omawiane z uwzględnieniem specyfiki projektu.

Samą integrację opracowuje zespół partnera, a specjaliści BAS-IP udzielają konsultacji dotyczących działania swoich produktów i pomagają rozwiązać problemy techniczne napotkane w trakcie prac. Jeśli istniejące możliwości BAS-IP nie wystarczają do realizacji zamierzonego scenariusza, można omówić dodatkowe prace programistyczne. Terminy takich modyfikacji zależą od nakładu pracy i aktualnych priorytetów zespołu produktowego.

Po zakończeniu prac programistycznych partner testuje integrację w swoim środowisku, a następnie prezentuje wynik firmie BAS-IP lub dostarcza opis zrealizowanego rozwiązania.

Czas trwania integracji zależy od złożoności projektu, architektury systemu zewnętrznego i obciążenia zespołu programistów. Na terminy wpływa również przygotowanie środowiska programistycznego oraz testy.

Ile to kosztuje

BAS-IP domyślnie nie pobiera dodatkowych opłat za dostęp do dokumentacji i narzędzi integracyjnych.

Licencjonowanie produktów BAS-IP odbywa się przy tym na standardowych warunkach, a dodatkowe modyfikacje lub zmiana ich priorytetu są ustalane indywidualnie.

Częste pytania

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

Link API łączy BAS-IP z systemem serwerowym — na przykład z platformą zarządzania nieruchomościami lub SKD. Mobile SDK dodaje funkcje wideodomofonu do aplikacji mobilnej. W jednym projekcie można z nich korzystać łącznie.

Czy BAS-IP Link jest wymagany do integracji?

Nie zawsze. Wiele urządzeń BAS-IP posiada własne lokalne API, dzięki czemu zewnętrzny system może współpracować ze sprzętem bezpośrednio. Link jest zazwyczaj wygodniejszy, gdy integracja obejmuje różne modele, dużą liczbę urządzeń lub wiele obiektów.

Czy wymagane jest NDA?

NDA jest wymagane w przypadku Link API i Mobile SDK. Dokumentacja dla Device API jest otwarta.

Czy obsługiwane są webhooki?

Tak, na panelach z systemem Android. Zewnętrzny system może odbierać zdarzenia z urządzenia w czasie rzeczywistym. Na panelach z systemem Linux, monitorach oraz na poziomie Link webhooki nie są obsługiwane.

Czy można zintegrować zewnętrzną platformę z BAS-IP Link Cloud?

Zewnętrzne integracje systemów serwerowych stron trzecich poprzez Link API są obecnie realizowane na platformie Link Self-Hosted. W przypadku Link Cloud taka możliwość jest w trakcie opracowywania.

Chcesz zintegrować BAS-IP ze swoim systemem?

Powiedz nam, z jakiej platformy, aplikacji lub sprzętu korzystasz i jaki scenariusz chcesz zrealizować.

Zespół BAS-IP pomoże Ci określić odpowiednie rozwiązanie: kompatybilność protokołów, Link API, Mobile SDK, Device API lub ich kombinację.