BAS-IP Mobile SDK: Wie Sie Video-Türsprechanlagen in Ihre eigene mobile App integrieren

Eine Wohnanlage, eine Hausverwaltung oder eine PropTech-Plattform verfügt möglicherweise bereits über eine eigene mobile App. Bewohner nutzen diese, um Rechnungen zu bezahlen, Besprechungsräume zu buchen, Wartungsanfragen einzureichen und Benachrichtigungen zu erhalten. Wird dann ein Video-Gegensprechanlagensystem installiert, werden die Bewohner aufgefordert, eine weitere App herunterzuladen – nur um einen Anruf von der Eingangstür anzunehmen.

Das BAS-IP Mobile SDK macht eine zweite App überflüssig. Videoanrufe, das Entriegeln von Türen und der mobile Zugriff können in die App integriert werden, die die Bewohner bereits verwenden. Das Entwicklungsteam des Partners arbeitet mit vorgefertigten BAS-IP-Komponenten und passt die Benutzeroberfläche an das eigene Produkt an.

In unserer Übersicht zur Integration von BAS-IP in bestehende Gebäudesysteme haben wir die verfügbaren Ansätze behandelt: Standardprotokolle, Link API, Mobile SDK und Device API. Hier konzentrieren wir uns auf die mobile Integration: Was das SDK leisten kann, was vorbereitet werden muss und wo seine Grenzen liegen.

Ein Tag im Leben eines Bewohners

Der einfachste Weg, das Mobile SDK zu erklären, ist ein Blick auf einen ganz normalen Tag im Leben einer Person, die in einem mit BAS-IP ausgestatteten Gebäude wohnt.

Während der Bewohner bei der Arbeit ist, klingelt ein Kurier an der Eingangsplatte. Das Smartphone zeigt das Video der Kamera an, noch bevor der Bewohner abhebt. Er sieht das Paket, nimmt den Anruf entgegen und öffnet die Tür.

Am Abend kehrt der Bewohner nach Hause zurück und öffnet die Eingangstür über Bluetooth mit seinem Smartphone. Eine UKEY Mobile Credential (mobiler Ausweis) wurde bereits in der App aktiviert.

Wenig später fällt die Haupteingangstür ins Schloss, und das Kind des Bewohners müsste eigentlich aus der Schule zurück sein. Der Bewohner öffnet die Eingangskamera selbst, ganz ohne Anruf, um nachzusehen, wer am Eingang steht.

All dies geschieht in einer einzigen App. Derselben App, mit der der Bewohner am Morgen eine Rechnung bezahlt hat.

Das Mobile SDK stellt die für jede dieser Aktionen erforderlichen Komponenten bereit. Schauen wir uns an, wie sie funktionieren und was das Entwicklungsteam vorbereiten muss.

Was ist im BAS-IP Mobile SDK enthalten?

Das BAS-IP Mobile SDK bietet Bibliotheken, technische Dokumentationen und Code-Beispiele für mobile Entwickler. Es funktioniert mit BAS-IP Link und unterstützt sowohl iOS als auch Android.

Das SDK versetzt eine App in die Lage, folgende Aktionen auszuführen:

• Benutzer zu registrieren und zu authentifizieren;
• Benutzerprofile und Listen zugänglicher Geräte abzurufen;
• Türsprechanrufe zu empfangen und zu tätigen;
• Audio und Video zu übertragen;
• Video von einer Eingangsplatte vor der Annahme eines Anrufs anzuzeigen;
• die Kamera einer Eingangsplatte ohne eingehenden Anruf anzusehen;
• Türen aus der Ferne zu entriegeln;
• den Verlauf eingehender und ausgehender Anrufe anzuzeigen;
• ein Smartphone als Bluetooth-Mobilzugangsausweis zu verwenden;
• einen Aufzug zu rufen, wenn die entsprechende Ausrüstung vor Ort installiert ist.

Partner können die benötigten Komponenten auswählen und entscheiden, wie diese Funktionen in ihrer App dargestellt werden sollen.

Drei Komponenten: Core, Calls und UKEY

Core verbindet die Anwendung mit BAS-IP Link. Die Komponente verwaltet die Anmeldung der Bewohner, die Passwortwiederherstellung sowie den Abruf von Benutzerprofilen und zugänglichen Geräten. Sie bietet zudem die erforderliche Funktionalität zum Initiieren von Anrufen, Entriegeln von Türen, Anzeigen des Anrufverlaufs und Rufen von Aufzügen.

Calls übernimmt die Kommunikation der Türsprechanlage, einschließlich eingehender und ausgehender Anrufe, Audio- und Videoübertragung sowie Anrufverwaltung. Das SDK verwaltet Anrufzustände wie den Empfang eines eingehenden Anrufs, die Bereitschaft der App zur Annahme, das Beenden eines Anrufs und die Partei, die das Gespräch beendet hat. Unter iOS wird CallKit für die systemweite Anrufbehandlung verwendet.

UKEY macht aus einem Smartphone einen mobilen Schlüssel. Der Bewohner scannt einen QR-Code, wodurch ein mobiler Ausweis in der App aktiviert wird. Das Telefon kann daraufhin über Bluetooth verwendet werden, um eine Tür mittels eines kompatiblen BAS-IP-Lesers zu öffnen.

Je nach Implementierung der App kann der Zugang eingerichtet werden, ohne eine separate Taste drücken zu müssen. Beispielsweise kann das Öffnen der Tür ausgelöst werden, wenn der Bewohner sein Telefon in der Nähe des Lesers entsperrt. Ein vollständig automatisches Entriegeln der Tür allein durch das Annähern mit einem gesperrten Telefon gehört jedoch nicht zu den Standardfunktionen des SDK.

Der QR-Code wird einmalig verwendet, um den Ausweis auf dem Telefon zu aktivieren. Er steht in keinem Zusammenhang mit dem Besucher-QR-Code, den ein Kurier zum Betreten des Gebäudes verwenden könnte.

Wie gelangt ein eingehender Anruf auf das Telefon?

Wenn die mobile App im Hintergrund ausgeführt wird oder das Telefon gesperrt ist, werden Push-Benachrichtigungen verwendet, um eingehende Anrufe zu übermitteln. Sie ermöglichen es, die App zu aktivieren und auf den Empfang eines Anrufs vorzubereiten, selbst wenn der Bewohner sie nicht geöffnet hat.

Der Prozess läuft wie folgt ab:

1. Ein Besucher drückt die Ruftaste an einer BAS-IP-Eingangsplatte.
2. Der Anruf erreicht den BAS-IP-Link-Server.
3. Der Push-Server sendet eine Benachrichtigung an das Smartphone des Bewohners.
4. Die App wird aktiviert und bereitet sich darauf vor, den Anruf entgegenzunehmen.
5. Der Bewohner erhält den eingehenden Anruf und kann ihn annehmen.

Der Empfang eingehender Anrufe erfordert eine Push-Infrastruktur. Diese umfasst einen Push-Benachrichtigungsserver, der mit Firebase Cloud Messaging (FCM) für Android und dem Apple Push Notification service (APNs) für iOS kommuniziert.

Je nach Projektarchitektur kann der Push-Server vom Partner bereitgestellt oder von BAS-IP zur Verfügung gestellt werden. Die entsprechende Regelung wird bei der Integrationsplanung vereinbart.

Wenn die App keine Anruffunktionalität erfordert, wird kein Push-Server benötigt. Ein BAS-IP-Link-Server ist in allen Fällen erforderlich, da das SDK ausschließlich mit Link funktioniert.

Ihre App, Ihre Benutzeroberfläche

BAS-IP stellt Musterbildschirme und Symbole mit dem SDK zur Verfügung, Partner sind jedoch nicht verpflichtet, diese zu verwenden. Schaltflächen, Anrufbildschirme, Navigation und Farben können so gestaltet werden, dass sie zur bestehenden Anwendung passen.

Für die Bewohner wird die Video-Türsprechanlage zu einem natürlichen Bestandteil ihrer Immobilienverwaltungs-App und nicht zu einem separaten Dienst im Design eines Drittanbieters.

Mehrere Telefone für eine Wohnung

Ein Kurier drückt die Ruftaste für eine Wohnung, und die Telefone beider Elternteile klingeln. Die Person, die zuerst abhebt, nimmt den Anruf entgegen, während der eingehende Anruf auf dem anderen Telefon aufhört zu klingeln.

Anrufe können je nach Netzwerkbedingungen und dem Status der einzelnen Geräte mit einigen Augenblicken Verzögerung auf verschiedenen Telefonen eingehen.

Die Liste der Empfänger wird durch die Anrufweiterleitungseinstellungen in BAS-IP Link bestimmt. Wichtig ist dabei, dass das Türsprechanlagensystem einer Wohnung nicht an das Telefon eines einzigen Bewohners gebunden sein muss.

Video vor der Annahme und ohne eingehenden Anruf

Das Video von der Eingangsplatte kann angezeigt werden, bevor der Bewohner den Anruf beantwortet. So kann er sehen, wer am Eingang steht, und dann entscheiden, ob er abhebt.

Es gibt zudem ein zweites Szenario: das Betrachten der Eingangskamera, wenn niemand geklingelt hat.

Technisch gesehen ist auch hierfür der Aufbau einer Verbindung zur Platte erforderlich. Aus Sicht des Bewohners kann dies jedoch so einfach sein wie das Tippen auf eine Schaltfläche, um zu sehen, wer am Eingang steht.

Wen können Bewohner aus der App heraus anrufen?

Bewohner können Geräte anrufen, die ihnen über BAS-IP Link zur Verfügung stehen. Je nach Konfiguration des Standorts können dies eine Eingangsplatte, ein Innenmonitor in ihrer Wohnung, der Concierge oder das Sicherheitsteam sein.

Was sie nicht tun können, ist eine andere mobile App direkt anzurufen. Das SDK unterstützt keine direkten App-zu-App-Anrufe zwischen zwei Smartphones.

Diese Einschränkung sollte beim Entwerfen der Kontaktliste und der Anruffunktionen der Anwendung berücksichtigt werden.

Anrufverlauf und Türöffnung

Die App kann einen Anrufverlauf anzeigen, der eingehende und ausgehende Anrufe, Datum und Uhrzeit, den Anrufer bzw. die angerufene Person sowie den Status (angenommen oder verpasst) enthält.

Beispielsweise kann ein Bewohner überprüfen, ob jemand angerufen hat, während er mit öffentlichen Verkehrsmitteln unterwegs war.

Der Partner kann die Schaltfläche zum Öffnen der Tür an einer beliebigen, sinnvollen Stelle im Anrufbildschirm platzieren. Das SDK übernimmt die erforderliche Kommunikation mit der BAS-IP-Ausrüstung, sodass Entwickler den Befehlsmechanismus zum Türöffnen nicht selbst implementieren müssen.

Aufzugssteuerung

Die Aufzugsruffunktion funktioniert, wenn zwei Bedingungen erfüllt sind: Ein BAS-IP-Aufzugsmodul wurde vor Ort installiert und konfiguriert, und der Bewohner verfügt über die erforderlichen Zugriffsrechte.

Das SDK kann ein Aufzugssystem ohne ein BAS-IP-Aufzugsmodul nicht direkt steuern. Die erforderliche Ausrüstung, Kompatibilität und Konfiguration müssen während des Projektdesigns bestätigt werden.

Warum das Mobile SDK verwenden, anstatt die Türsprechanlagen-Kommunikation von Grund auf neu zu entwickeln?

Ein Unternehmen kann eine eigene Video-Türsprechanlagen-Funktionalität für seine mobile App entwickeln. Allerdings müsste sein Team dann eingehende und ausgehende Anrufe, Push-Benachrichtigungen, den Hintergrundbetrieb, Audio- und Videoübertragung, Anrufverwaltung, Türöffnung und die Kommunikation mit BAS-IP Link selbst implementieren.

Diese Funktionalität würde zudem eine kontinuierliche Wartung erfordern, während sich iOS und Android weiterentwickeln.

Das BAS-IP Mobile SDK stellt vorgefertigte Komponenten für diese Aufgaben bereit. Der Partner bleibt verantwortlich für die Integration der Komponenten, das Design der App-Benutzeroberfläche, die Bereitstellung der erforderlichen Infrastruktur und das Testen der Lösung, muss jedoch nicht das gesamte Türsprechanlagen-Kommunikationssystem von Null aufbauen.

Dies ist besonders wertvoll für PropTech-Plattformen, bei denen die Video-Türsprechanlage nur ein Feature eines viel größeren Produkts ist. Das Entwicklungsteam kann sich auf seine eigene Plattform konzentrieren und gleichzeitig die bestehenden BAS-IP-Komponenten für die Türsprechanlagen-Kommunikation nutzen.

Ein praktisches Beispiel hierfür ist die Fallstudie (Case Study) zur Accrete-Integration, in der beschrieben wird, wie ein Anbieter von PropTech-Technologien BAS-IP-Türsprechanlagenfunktionen in seine bestehende mobile App integriert hat.

Was erhält das Entwicklungsteam?

Nachdem das Projekt vereinbart und eine Geheimhaltungsvereinbarung (NDA) unterzeichnet wurde, erhält das Entwicklungsteam des Partners Zugriff auf die erforderlichen BAS-IP-Mobile-SDK-Materialien.

Dazu gehören Softwarebibliotheken, technische Dokumentationen und Code-Beispiele. Die genauen bereitgestellten Materialien und deren Bereitstellung hängen von der technischen Konfiguration und den Anforderungen des Projekts ab.

Die erforderlichen Bibliotheks- und Dokumentationsupdates werden im Rahmen des technischen Supports für die Integration bereitgestellt. Das Team des Partners entscheidet, wann die verwendeten Komponenten aktualisiert und eine neue Version seiner Anwendung veröffentlicht wird.

Was verbleibt in der Verantwortung des Partners?

Der Partner ist verantwortlich für die Integration der SDK-Bibliotheken, die Entwicklung der Benutzeroberfläche und der Anwendungslogik, das Testen, die Veröffentlichung der App im App Store und bei Google Play sowie die laufende Wartung.

Die Anforderungen an die Push-Infrastruktur und die Verantwortung für deren Bereitstellung werden für jedes Projekt separat vereinbart.

BAS-IP stellt das SDK, die Dokumentation und Code-Beispiele zur Verfügung und beantwortet technische Fragen zu den eigenen Komponenten.

Mobile-SDK-Integrationen von Drittanbietern nutzen derzeit BAS-IP Link Self-Hosted. Wenn ein Projekt für Link Cloud geplant ist, sollte die vorgeschlagene Architektur vor Beginn der Entwicklung mit BAS-IP besprochen werden.

Was ist nicht im Mobile SDK enthalten?

Das Mobile SDK bildet nicht jede Funktion der BAS-IP-Link-App ab. Beispielsweise sind die Generierung von Besucher-QR-Codes oder die Buchung von Gemeinschaftseinrichtungen (Amenity Booking) darin nicht enthalten, obwohl beide Funktionen in der Standard-Link-App verfügbar sind.

Die Generierung von Besucher-QR-Codes und die Buchung von Gemeinschaftseinrichtungen stehen über die BAS-IP Link API zur Verfügung. Wenn diese Funktionen in der eigenen mobilen App des Partners benötigt werden, können sie über eine zusätzliche Integration mit BAS-IP Link implementiert werden.

Beide Tools können innerhalb desselben Projekts verwendet werden. Das Backend der Plattform verwaltet die Bewohner und deren Zugriffsrechte über die Link API, während die mobile App das Mobile SDK nutzt, um Türsprechanrufe entgegenzunehmen und Türen zu öffnen.

Serverseitige Integrationsszenarien werden in unserem Artikel über die BAS-IP Link API näher erläutert. Vor Beginn der Entwicklung empfiehlt es sich, alle erforderlichen Szenarien aufzulisten und festzulegen, welches Integrationswerkzeug das jeweilige Szenario abdeckt.

Was kostet das BAS-IP Mobile SDK?

Standardmäßig erhebt BAS-IP keine separate Gebühr für den Zugriff auf das Mobile SDK, dessen Dokumentation oder den technischen Support während der Integration.

BAS-IP Link und andere Produkte werden weiterhin unter ihren Standardlizenzbedingungen lizenziert, während UKEY Mobile Credentials separat von BAS-IP oder dessen Distributoren erworben werden.

Erfordert ein Projekt zusätzliche Entwicklungsarbeiten seitens BAS-IP oder eine Änderung der Entwicklungsprioritäten, werden die kommerziellen Bedingungen separat vereinbart.

Das Projektbudget sollte zudem die eigenen Entwicklungsarbeiten des Partners, die Infrastruktur, Tests und die laufende Wartung der Anwendung berücksichtigen.

Häufig gestellte Fragen (FAQ)

Welche iOS- und Android-Versionen werden unterstützt?

Die aktuell unterstützten Mindestversionen sind in der technischen Dokumentation des SDK angegeben. Da sich mobile Betriebssysteme weiterentwickeln, ändern sich auch die Anforderungen. Entwickler sollten diese daher vor Beginn der Integration und bei jedem Bibliotheksupdate überprüfen.

Gibt es eine öffentliche Sandbox?

Es gibt keine gemeinsam genutzte öffentliche Sandbox. Bei BAS-IP Link Self-Hosted stellt der Partner Link in seiner eigenen Umgebung bereit und nutzt diese Installation für die Entwicklung. Testlizenzen und Hardware-Vereinbarungen werden entsprechend den Anforderungen des jeweiligen Projekts getroffen.

Wie werden SDK-Updates bereitgestellt?

Die erforderlichen SDK-Updates werden im Rahmen des technischen Supports für die Integration bereitgestellt. Das Entwicklungsteam des Partners plant, wann die Updates eingespielt, die Änderungen getestet und eine neue Version der Anwendung veröffentlicht wird.

Möchten Sie eine Video-Türsprechanlage in Ihre App integrieren?

Schreiben Sie eine E-Mail an das Integrationsteam von BAS-IP unter [email protected] oder senden Sie eine Anfrage über das Kontaktformular.

Sie müssen vor der Kontaktaufnahme keine detaillierte technische Spezifikation vorbereiten. Eine kurze Beschreibung Ihrer App und der gewünschten Funktionalität ist völlig ausreichend.

Beispiel:

„Wir haben eine Bewohner-App für iOS und Android. Wir möchten, dass Bewohner Videoanrufe von BAS-IP-Eingangsplatten empfangen und während des Anrufs die Tür öffnen können.“

Oder:

„Wir möchten einen mobilen Bluetooth-Zugang hinzufügen. Wir planen, UKEY-Ausweise zu erwerben und Aktivierungs-QR-Codes an die Bewohner auszugeben.“

Falls die Ausrüstung und die BAS-IP-Link-Konfiguration bereits feststehen, fügen Sie diese Details bitte hinzu.

Dies trägt dazu bei, dass das Gespräch schneller vorankommt. Das BAS-IP-Team kann Sie beraten, welche Komponenten erforderlich sind, welche Infrastruktur eventuell benötigt wird und wie Sie das SDK erhalten.