BAS-IP Mobile SDK: Jak dodać wideodomofon do własnej aplikacji mobilnej

Osiedle mieszkaniowe, firma zarządzająca nieruchomościami lub platforma PropTech mogą już posiadać własną aplikację mobilną. Mieszkańcy używają jej do opłacania rachunków, rezerwowania sal spotkań, zgłaszania próśb o konserwację oraz otrzymywania powiadomień. Następnie instalowany jest system wideodomofonowy, a mieszkańcy proszeni są o pobranie kolejnej aplikacji tylko po to, aby odebrać połączenie z wejścia do budynku.

BAS-IP Mobile SDK eliminuje potrzebę korzystania z drugiej aplikacji. Połączenia wideo, otwieranie drzwi oraz dostęp mobilný mogą zostać zintegrowane z aplikacją, której mieszkańci już używają. Zespół programistów partnerskich pracuje z gotowymi komponentami BAS-IP i dostosowuje interfejs do własnego produktu.

W naszym przeglądzie integracji BAS-IP z istniejącymi systemami budynkowymi omówiliśmy dostępne podejścia: protokoły standardowe, Link API, Mobile SDK oraz Device API. Tutaj skupiamy się na integracji mobilnej: co potrafi SDK, co należy przygotować i jakie są jego ograniczenia.

Dzień z życia mieszkańca

Najprostszym sposobem na wyjaśnienie działania Mobile SDK jest przyjrzenie się zwykłemu dniowi osoby mieszkającej w budynku wyposażonym w system BAS-IP.

Gdy mieszkaniec jest w pracy, kurier dzwoni z panelu wejściowego. Telefon wyświetla obraz wideo z kamery jeszcze zanim mieszkaniec odbierze połączenie. Widzi przesyłkę, odbiera połączenie i zwalnia blokadę drzwi.

Wieczorem mieszkaniec wraca do domu i używa smartfona, aby otworzyć drzwi wejściowe przez Bluetooth. W aplikacji aktywowana jest już mobilna karta dostępu UKEY.

Chwilę później drzwi główne do budynku zatrzaskują się, a dziecko mieszkańca powinno już wracać ze szkoły. Mieszkaniec sam otwiera podgląd z kamery przy wejściu, bez żadnego połączenia, aby sprawdzić, kto znajduje się przed wejściem.

Wszystko to dzieje się w jednej aplikacji. Tej samej, której mieszkaniec używał rano do opłacenia rachunku.

Mobile SDK dostarcza komponenty niezbędne do wykonania każdej z tych czynności. Przyjrzyjmy się, jak działają i co zespół programistów musi przygotować.

Co zawiera BAS-IP Mobile SDK?

BAS-IP Mobile SDK udostępnia biblioteki, dokumentację techniczną oraz przykłady kodu dla programistów aplikacji mobilnych. Współpracuje z systemem BAS-IP Link i obsługuje zarówno system iOS, jak i Android.

SDK umożliwia aplikacji:

• rejestrowanie i uwierzytelnianie użytkowników;
• pobieranie profili użytkowników oraz list dostępnych urządzeń;
• odbieranie i wykonywanie połączeń domofonowych;
• przesyłanie dźwięku i obrazu wideo;
• wyświetlanie obrazu z kamery panelu wejściowego przed odebraniem połączenia;
• podgląd kamery panelu wejściowego bez połączenia przychodzącego;
• zdalne zwalnianie blokady drzwi;
• wyświetlanie historii połączeń przychodzących i wychodzących;
• używanie smartfona jako mobilnej karty dostępu Bluetooth;
• wywoływanie windy, jeśli w budynku zainstalowano odpowiedni sprzęt.

Partnerzy mogą wybrać potrzebne im komponenty i zdecydować, jak te funkcje będą wyglądać w ich aplikacji.

Trzy komponenty: Core, Calls oraz UKEY

Core (Rdzeń) łączy aplikację z serwerem BAS-IP Link. Obsługuje logowanie mieszkańców, odzyskiwanie haseł oraz pobieranie profili użytkowników i dostępnych urządzeń. Zapewnia również funkcjonalność niezbędną do inicjowania połączeń, otwierania drzwi, wyświetlania historii połączeń i wzywania windy.

Calls (Połączenia) obsługuje komunikację domofonową, w tym połączenia przychodzące i wychodzące, transmisję audio i wideo oraz zarządzanie połączeniami. SDK zarządza stanami połączenia, takimi jak nadejście połączenia przychodzącego, gotowość aplikacji do odebrania, zakończenie połączenia oraz informacja, która strona zakończyła rozmowę. W systemie iOS do obsługi połączeń na poziomie systemu wykorzystywany jest CallKit.

UKEY zamienia smartfon w mobilny klucz. Mieszkaniec skanuje kod QR, co aktywuje mobilną kartę dostępu w aplikacji. Telefon może być następnie używany do otwierania drzwi przez Bluetooth za pomocą kompatybilnego czytnika BAS-IP.

W zależności od sposobu wdrożenia aplikacji, dostęp można skonfigurować bez konieczności naciskania osobnego przycisku. Na przykład otwarcie drzwi może zostać wywołane, gdy mieszkaniec odblokuje telefon w pobliżu czytnika. Jednak całkowicie automatyczne otwarcie drzwi poprzez samo zbliżenie się z zablokowanym telefonem nie jest standardową funkcją SDK.

Kod QR jest używany jednorazowo do aktywacji uprawnień w telefonie. Nie ma on związku z kodem QR dla gości, którego kurier mógłby użyć do wejścia do budynku.

Jak połączenie przychodzące trafia do telefonu?

Gdy aplikacja mobilna działa w tle lub telefon jest zablokowany, do dostarczania połączeń przychodzących wykorzystywane są powiadomienia typu push. Pozwalają one na aktywację aplikacji i przygotowanie jej do odebrania połączenia, nawet jeśli mieszkaniec jej nie otworzył.

Proces przebiega następująco:

1. Odwiedzający naciska przycisk wywołania na panelu wejściowym BAS-IP.
2. Połączenie trafia do serwera BAS-IP Link.
3. Serwer powiadomień push wysyła powiadomienie na smartfon mieszkańca.
4. Aplikacja zostaje aktywowana i przygotowuje się do odebrania połączenia.
5. Mieszkaniec otrzymuje połączenie przychodzące i może je odebrać.

Odbieranie połączeń przychodzących wymaga infrastruktury powiadomień push. Obejmuje ona serwer powiadomień push, który komunikuje się z usługą Firebase Cloud Messaging (FCM) dla systemu Android oraz Apple Push Notification service (APNs) dla systemu iOS.

W zależności od architektury projektu, serwer push może zostać wdrożony przez partnera lub dostarczony przez firmę BAS-IP. Odpowiedni model jest uzgadniany podczas planowania integracji.

Jeśli aplikacja nie wymaga funkcji wykonywania połączeń, serwer push nie jest potrzebny. Serwer BAS-IP Link jest wymagany we wszystkich przypadkach, ponieważ SDK działa wyłącznie z systemem Link.

Twoja aplikacja, Twój interfejs

BAS-IP dostarcza przykładowe ekrany i ikony wraz z zestawem SDK, jednak partnerzy nie muszą z nich korzystać. Przyciski, ekrany połączeń, nawigacja i kolory mogą zostać zaprojektowane tak, aby pasowały do istniejącej aplikacji.

Dla mieszkańców wideodomofon staje się naturalną częścią ich aplikacji do zarządzania nieruchomością, a nie osobną usługą oznaczonego marką zewnętrznego dostawcy.

Wiele telefonów dla jednego mieszkania

Kurier naciska przycisk wywołania dla danego mieszkania i dzwonią telefony obojga rodziców. Pierwsza osoba, która odbierze, przejmuje połączenie, podczas gdy na drugim telefonie dzwonienie zostaje przerwane.

Połączenia mogą docierać do różnych telefonów z niewielkim opóźnieniem, zależnym od warunków sieciowych i stanu poszczegicznych urządzeń.

Lista odbiorców jest określana przez ustawienia przekierowania połączeń w systemie BAS-IP Link. Istotne jest to, że system domofonowy w mieszkaniu nie musi być powiązany z telefonem tylko jednego mieszkańca.

Podgląd wideo przed odebraniem i bez połączenia przychodzącego

Obraz wideo z panelu wejściowego może być wyświetlany zanim mieszkaniec odebrać połączenie. Może zobaczyć, kto znajduje się przy wejściu, a następnie zdecydować, czy chce odebrać.

Istnieje również drugi scenariusz: podgląd kamery przy wejściu, kiedy nikt nie dzwoni.

Technicznie nadal wiąże się to z nawiązaniem połączenia z panelem. Jednak z perspektywy mieszkańca może to być tak proste, jak dotknięcie przycisku w celu zobaczenia, kto stoi przy wejściu.

Do kogo mieszkańcy mogą dzwonić z aplikacji?

Mieszkańcy mogą dzwonić na urządzenia dostępne dla nich za pośrednictwem BAS-IP Link. W zależności od konfiguracji obiektu mogą to być: panel wejściowy, monitor wewnętrzny w ich mieszkaniu, recepcja lub zespół ochrony.

Czego nie mogą zrobić, to zadzwonić bezpośrednio na inną aplikację mobilną. SDK nie obsługuje połączeń bezpośrednich typu aplikacja-aplikacja (app-to-app) między dwoma smartfonami.

Ograniczenie to należy wziąć pod uwagę podczas projektowania listy kontaktów oraz funkcji połączeń w aplikacji.

Historia połączeń i otwieranie drzwi

Aplikacja może wyświetlać historię połączeń zawierającą połączenia przychodzące i wychodzące, datę i godzinę, informację o tym, kto dzwonił lub do kogo dzwoniono, a także czy połączenie zostało odebrane czy nieodebrane.

Na przykład mieszkaniec może sprawdzić, czy ktoś dzwonił, gdy podróżował komunikacją miejską.

Partner może umieścić przycisk otwierania drzwi w dowolnym, dogodnym miejscu na ekranie połączenia. SDK obsługuje niezbędną komunikację ze sprzętem BAS-IP, dzięki czemu programistowie nie muszą samodzielnie implementować mechanizmu wysyłania komendy otwarcia drzwi.

Sterowanie windą

Funkcja przywołania windy działa po spełnieniu dwóch warunków: w budynku zainstalowano i skonfigurowano moduł windowy BAS-IP, a mieszkaniec posiada odpowiednie uprawnienia dostępu.

SDK nie może sterować systemem windy bezpośrednio bez modułu windowego BAS-IP. Wymagany sprzęt, kompatybilność i konfiguracja muszą zostać potwierdzone na etapie projektowania.

Dlaczego warto używać Mobile SDK zamiast tworzyć komunikację domofonową od zera?

Firma może opracować własną funkcjonalność wideodomofonu dla swojej aplikacji mobilnej. Jednak jej zespół musiałby wówczas samodzielnie zaimplementować połączenia przychodzące i wychodzące, powiadomienia push, działanie w tle, transmisję audio i wideo, zarządzanie połączeniami, otwieranie drzwi oraz komunikację z serwerem BAS-IP Link.

Funkcjonalność ta wymagałaby również ciągłego utrzymania w miarę rozwoju systemów iOS i Android.

BAS-IP Mobile SDK dostarcza gotowe komponenty do realizacji tych zadań. Partner nadal odpowiada za integrację komponentów, projekt interfejsu aplikacji, przygotowanie niezbędnej infrastruktury oraz testowanie rozwiązania, ale nie musi budować całego systemu komunikacji domofonowej od podstaw.

Jest to szczególnie cenne w przypadku platform PropTech, w których wideodomofon stanowi jedynie jedną z funkcji dużo szerszego produktu. Zespół programistów może skupić się na własnej platformie, korzystając z istniejących komponentów BAS-IP do obsługi komunikacji domofonowej.

Praktycznym przykładem jest studium przypadku integracji Accrete, które opisuje, w jaki sposób dostawca technologii dla nieruchomości dodał funkcje domofonu BAS-IP do swojej istniejącej aplikacji mobilnej.

Co otrzymuje zespół programistów?

Po uzgodnieniu projektu i podpisaniu umowy o zachowaniu poufności (NDA) zespół programistów partnera otrzymuje dostęp do niezbędnych materiałów BAS-IP Mobile SDK.

Obejmują one biblioteki oprogramowania, dokumentację techniczną oraz przykłady kodu. Dokładny zakres dostarczonych materiałów oraz sposób ich udostępnienia zależą od konfiguracji technicznej i wymagań projektu.

Niezbędne aktualizacje bibliotek i dokumentacji są dostarczane w ramach wsparcia technicznego dla integracji. Zespół partnera decyduje, kiedy zaktualizować używane komponenty i wydać nową wersję swojej aplikacji.

Co pozostaje w gestii partnera?

Partner odpowiada za integrację bibliotek SDK, rozwój interfejsu użytkownika i logiki aplikacji, testowanie, publikację aplikacji w sklepach App Store i Google Play oraz jej bieżące utrzymanie.

Wymagania dotyczące infrastruktury push oraz odpowiedzialność za jej wdrożenie są uzgadniane osobno dla każdego projektu.

BAS-IP dostarcza zestaw SDK, dokumentację oraz przykłady kodu, a także odpowiada na pytania techniczne związane z własnymi komponentami.

Trzecie strony integrujące Mobile SDK korzystają obecnie z rozwiązania BAS-IP Link Self-Hosted. Jeśli projekt ma wykorzystywać chmurę Link Cloud, proponowaną architekturę należy omówić z BAS-IP przed rozpoczęciem prac programistycznych.

Czego nie zawiera Mobile SDK?

Mobile SDK nie odwzorowuje każdej funkcji standardowej aplikacji BAS-IP Link. Na przykład nie zawiera funkcji generowania kodów QR dla gości ani rezerwacji części wspólnych (amenity booking), mimo że obie te funkcje są dostępne w standardowej aplikacji Link.

Generowanie kodów QR dla gości oraz rezerwacja części wspólnych są dostępne za pośrednictwem API systemu BAS-IP Link. Jeśli funkcje te są wymagane we własnej aplikacji mobilnej partnera, można je zaimplementować poprzez dodatkową integrację z BAS-IP Link.

Oba narzędzia mogą być używane w ramach tego samego projektu. Zaplecze (back-end) platformy zarządza mieszkańcami i ich uprawnieniami dostępu za pośrednictwem Link API, podczas gdy aplikacja mobilna korzysta z Mobile SDK do odbierania połączeń domofonowych i otwierania drzwi.

Scenariusze integracji po stronie serwera (server-side) zostały szczegółowo omówione w naszym artykule poświęconym BAS-IP Link API. Przed rozpoczęciem prac programistycznych warto wypisać wszystkie wymagane scenariusze i zdecydować, które narzędzie integracyjne obsłuży każdy z nich.

Ile kosztuje BAS-IP Mobile SDK?

Domyślnie firma BAS-IP nie pobiera osobnej opłaty za dostęp do Mobile SDK, jego dokumentacji ani wsparcia technicznego w trakcie integracji.

System BAS-IP Link i inne produkty są nadal licencjonowane na standardowych warunkach, natomiast mobilne karty dostępu UKEY są kupowane oddzielnie od BAS-IP lub jej dystrybutorów.

Jeśli projekt wymaga dodatkowych prac programistycznych ze strony BAS-IP lub zmiany priorytetów rozwojowych, warunki handlowe są uzgadniane indywidualnie.

Budżet projektu powinien również uwzględniać własne prace programistyczne partnera, infrastrukturę, testy oraz bieżące utrzymanie aplikacji.

Często zadawane pytania (FAQ)

Jakie wersje systemów iOS i Android są obsługiwane?

Aktualnie obsługiwane wersje minimalne są określone w dokumentacji technicznej SDK. Wymagania zmieniają się wraz z rozwojem mobilnych systemów operacyjnych, dlatego programistowie powinni je sprawdzać przed rozpoczęciem integracji oraz przy każdej aktualizacji bibliotek.

Czy dostępna jest publiczna piaskownica (sandbox)?

Nie ma wspólnej, publicznej piaskownice. W przypadku rozwiązania BAS-IP Link Self-Hosted partner wdraża system Link we własnym środowisku i używa tej instalacji do prac programistycznych. Kwestie licencji testowych oraz sprzętu są uzgadniane zgodnie z wymaganiami każdego projektu.

W jaki sposób dostarczane są aktualizacje SDK?

Niezbędne aktualizacje SDK są dostarczane w ramach wsparcia technicznego dla integracji. Zespół programistów partnera planuje, kiedy zastosować aktualizacje, przetestować zmiany i wydać nową wersję swojej aplikacji.

Chcesz dodać wideodomofon do swojej aplikacji?

Wyślij e-mail do zespołu ds. integracji BAS-IP na adres [email protected] lub wyślij zapytanie przez formularz kontaktowy.

Nie musisz przygotowywać szczegółowej specyfikacji technicznej przed nawiązaniem kontaktu. Wystarczy krótki opis Twojej aplikacji oraz wymaganej funkcjonalności.

Na przykład:

„Mamy aplikację dla mieszkańców na systemy iOS i Android. Chcemy, aby mieszkańcy mogli odbierać połączenia wideo z paneli wejściowych BAS-IP i otwierać drzwi podczas połączenia.”

Lub:

„Chcemy dodać mobilny dostęp przez Bluetooth. Planujemy zakup kart dostępu UKEY oraz wydawanie mieszkańcom kodów QR aktywujących.”

Jeśli sprzęt i konfiguracja systemu BAS-IP Link zostały już zdefiniowane, uwzględnij te szczegóły.

Pomoże to w szybszym przejście do konkretnej dyskusji. Zespół BAS-IP może doradzić, jakie komponenty są potrzebne, jaka infrastruktura może być wymagana oraz w jaki sposób pozyskać zestaw SDK.