BAS-IP Mobile SDK : Comment intégrer la vidéophonie à votre propre application mobile

Un ensemble résidentiel, une société de gestion immobilière ou une plateforme PropTech possède déjà sa propre application mobile. Les résidents l’utilisent pour payer leurs factures, réserver des salles de réunion, soumettre des demandes de maintenance et recevoir des notifications. Ensuite, un système d’interphonie vidéo est installé et l’on demande aux résidents de télécharger une application supplémentaire juste pour répondre à un appel provenant de l’entrée.

Le SDK mobile BAS-IP supprime le besoin d’une seconde application. Les appels vidéo, l’ouverture des portes et l’accès mobile peuvent être intégrés directement dans l’application que les résidents utilisent déjà. L’équipe de développement du partenaire travaille avec des composants prêts à l’emploi BAS-IP et adapte l’interface à son propre produit.

Dans notre aperçu de l’intégration de BAS-IP avec les systèmes de bâtiments existants, nous avons abordé les différentes approches disponibles : protocoles standard, Link API, Mobile SDK et Device API. Ici, nous nous concentrons sur l’intégration mobile : ce que le SDK peut faire, ce qui doit être préparé et quelles en sont les limites.

Une journée dans la vie d’un résident

La façon la plus simple d’expliquer le Mobile SDK est d’observer une journée ordinaire d’une personne vivant dans un immeuble équipé de BAS-IP.

Pendant que le résident est au travail, un livreur appelle depuis la platine de rue. Le téléphone affiche la vidéo de la caméra avant même que le résident ne réponde. Il voit le colis, répond à l’appel et déverrouille la porte.

Le soir, le résident rentre chez lui et utilise son smartphone pour ouvrir la porte d’entrée via Bluetooth. Un identifiant mobile UKEY a déjà été activé dans l’application.

Un peu plus tard, la porte d’entrée principale se referme bruyamment, et l’enfant du résident devrait être rentré de l’école. Le résident ouvre lui-même la caméra de l’entrée, sans aucun appel, pour voir qui se trouve à l’entrée.

Tout cela se déroule dans une seule et même application. La même application que le résident a utilisée pour payer une facture ce matin-là.

Le Mobile SDK fournit les composants nécessaires à chacune de ces actions. Voyons comment ils fonctionnent et ce que l’équipe de développement doit préparer.

Que comprend le SDK mobile BAS-IP ?

Le SDK mobile BAS-IP fournit des bibliothèques, de la documentation technique et des exemples de code pour les développeurs mobiles. Il fonctionne avec BAS-IP Link et prend en charge à la fois iOS et Android.

Le SDK permet à une application de :

• enregistrer et authentifier les utilisateurs ;
• récupérer les profils utilisateurs et les listes d’appareils accessibles ;
• recevoir et passer des appels d’interphonie ;
• transmettre l’audio et la vidéo ;
• afficher la vidéo d’une platine de rue avant qu’un appel ne soit répondu ;
• visualiser la caméra d’une platine de rue sans appel entrant ;
• déverrouiller les portes à distance ;
• afficher l’historique des appels entrants et sortants ;
• utiliser un smartphone comme identifiant mobile Bluetooth ;
• appeler un ascenseur lorsque l’équipement requis est installé sur site.

Les partenaires peuvent sélectionner les composants dont ils ont besoin et décider de la manière dont ces fonctions doivent apparaître dans leur application.

Trois composants : Core, Calls et UKEY

Core connecte l’application à BAS-IP Link. Il gère la connexion des résidents, la récupération des mots de passe ainsi que la récupération des profils utilisateurs et des appareils accessibles. Il fournit également les fonctionnalités nécessaires pour initier des appels, déverrouiller des portes, afficher l’historique des appels et appeler les ascenseurs.

Calls gère la communication de l’interphone, y compris les appels entrants et sortants, la transmission audio et vidéo, ainsi que la gestion des appels. Le SDK gère les états des appels, tels que la réception d’un appel entrant, la préparation de l’application à répondre, la fin d’un appel et l’indication de la partie ayant mis fin à la conversation. Sur iOS, CallKit est utilisé pour la gestion des appels au niveau du système.

UKEY transforme un smartphone en clé mobile. Le résident scanne un code QR, ce qui active un identifiant mobile dans l’application. Le téléphone peut ensuite être utilisé pour ouvrir une porte via Bluetooth grâce à un lecteur BAS-IP compatible.

Selon la façon dont l’application est implémentée, l’accès peut être configuré sans avoir à appuyer sur un bouton spécifique. Par exemple, l’ouverture de la porte peut être déclenchée lorsque le résident déverrouille son téléphone près du lecteur. Cependant, le déverrouillage entièrement automatique de la porte par la simple approche avec un téléphone verrouillé n’est pas une fonctionnalité standard du SDK.

Le code QR est utilisé une seule fois pour activer l’identifiant sur le téléphone. Il n’est pas lié au code QR visiteur qu’un livreur pourrait utiliser pour entrer dans le bâtiment.

Comment un appel entrant arrive-t-il sur le téléphone ?

Lorsque l’application mobile s’exécute en arrière-plan ou que le téléphone est verrouillé, des notifications push sont utilisées pour acheminer les appels entrants. Elles permettent d’activer l’application et de la préparer à recevoir un appel, même lorsque le résident ne l’a pas ouverte.

Le processus fonctionne comme suit :

1. Un visiteur appuie sur le bouton d’appel d’une platine de rue BAS-IP.
2. L’appel atteint le serveur BAS-IP Link.
3. Le serveur push envoie une notification au smartphone du résident.
4. L’application est activée et se prépare à recevoir l’appel.
5. Le résident reçoit l’appel entrant et peut y répondre.

La réception des appels entrants nécessite une infrastructure push. Cela comprend un serveur de notifications push qui communique avec Firebase Cloud Messaging (FCM) pour Android et Apple Push Notification service (APNs) pour iOS.

Selon l’architecture du projet, le serveur push peut être déployé par le partenaire ou fourni par BAS-IP. L’arrangement approprié est convenu lors de la planification de l’intégration.

Si l’application ne nécessite pas de fonctionnalité d’appel, aucun serveur push n’est nécessaire. Un serveur BAS-IP Link est requis dans tous les cas, car le SDK ne fonctionne qu’avec Link.

Votre application, votre interface

BAS-IP fournit des exemples d’écrans et d’icônes avec le SDK, mais les partenaires ne sont pas tenus de les utiliser. Les boutons, les écrans d’appel, la navigation et les couleurs peuvent tous être conçus pour correspondre à l’application existante.

Pour les résidents, la vidéophonie devient une partie naturelle de leur application de gestion immobilière plutôt qu’un service distinct aux couleurs d’un autre fournisseur.

Plusieurs téléphones pour un même appartement

Un livreur appuie sur le bouton d’appel d’un appartement, et les téléphones des deux parents sonnent. La première personne qui répond prend l’appel, tandis que l’appel entrant s’arrête de sonner sur l’autre téléphone.

Les appels peuvent atteindre différents téléphones avec quelques instants de décalage, en fonction des conditions du réseau et de l’état de chaque appareil.

La liste des destinataires est déterminée par les paramètres de renvoi d’appel dans BAS-IP Link. Le point important est que le système d’interphonie d’un appartement n’a pas besoin d’être lié au téléphone d’un seul résident.

Vidéo avant de répondre et sans appel entrant

La vidéo provenant de la platine de rue peut être affichée avant que le résident ne réponde à l’appel. Il peut voir qui se trouve à l’entrée, puis décider s’il souhaite répondre.

Il existe également un second scénario : visionner la caméra de l’entrée lorsque personne n’a appelé.

Techniquement, cela implique toujours l’établissement d’une connexion avec la platine. Du point de vue du résident, cependant, cela peut être aussi simple que d’appuyer sur un bouton pour voir qui est à l’entrée.

Qui les résidents peuvent-ils appeler depuis l’application ?

Les résidents peuvent appeler les appareils qui leur sont accessibles via BAS-IP Link. Selon la configuration du site, ceux-ci peuvent inclure une platine de rue, un moniteur intérieur dans leur appartement, un concierge ou l’équipe de sécurité.

Ce qu’ils ne peuvent pas faire, c’est appeler directement une autre application mobile. Le SDK ne prend pas en charge les appels directs d’une application à l’autre entre deux smartphones.

Cette limitation doit être prise en compte lors de la conception de la liste de contacts et des fonctions d’appel de l’application.

Historique des appels et déverrouillage des portes

L’application peut afficher un historique des appels indiquant les appels entrants et sortants, la date et l’heure, la personne qui a appelé ou a été appelée, ainsi que le statut de l’appel (répondu ou manqué).

Par exemple, un résident peut vérifier si quelqu’un a appelé pendant qu’il voyageait dans les transports en commun.

Le partenaire peut placer le bouton de déverrouillage de la porte là où cela a du sens sur l’écran d’appel. Le SDK gère la communication nécessaire avec l’équipement BAS-IP, de sorte que les développeurs n’ont pas à implémenter eux-mêmes le mécanisme de commande de déverrouillage.

Contrôle des ascenseurs

La fonction d’appel d’ascenseur fonctionne lorsque deux conditions sont réunies : un module d’ascenseur BAS-IP a été installé et configuré sur site, et le résident dispose des droits d’accès nécessaires.

Le SDK ne peut pas contrôler un système d’ascenseur directement sans module d’ascenseur BAS-IP. L’équipement requis, la compatibilité et la configuration doivent être confirmés lors de la conception du projet.

Pourquoi utiliser le Mobile SDK plutôt que de développer la communication d’interphonie à partir de zéro ?

Une entreprise peut développer sa propre fonctionnalité de vidéophonie pour son application mobile. Cependant, son équipe devrait alors mettre en œuvre les appels entrants et sortants, les notifications push, le fonctionnement en arrière-plan, la transmission audio et vidéo, la gestion des appels, le déverrouillage des portes et la communication avec BAS-IP Link.

Cette fonctionnalité nécessiterait également une maintenance continue à mesure qu’iOS et Android évoluent.

Le SDK mobile BAS-IP fournit des composants prêts à l’emploi pour ces tâches. Le partenaire reste responsable de l’intégration des composants, de la conception de l’interface utilisateur, de la préparation de l’infrastructure nécessaire et des tests de la solution, mais n’a pas besoin de construire l’ensemble du système de communication d’interphonie à partir de zéro.

Ceci est particulièrement précieux pour les plateformes PropTech où la vidéophonie n’est qu’une fonctionnalité parmi d’autres d’un produit beaucoup plus vaste. L’équipe de développement peut se concentrer sur sa propre plateforme tout en utilisant les composants BAS-IP existants pour la communication d’interphonie.

Pour un exemple pratique, consultez l’étude de cas sur l’intégration d’Accrete, qui décrit comment un fournisseur de technologies immobilières a ajouté des fonctions d’interphone BAS-IP à son application mobile existante.

Que reçoit l’équipe de développement ?

Une fois le projet convenu et un accord de non-divulgation (NDA) signé, l’équipe de développement du partenaire reçoit l’accès aux matériels nécessaires du SDK mobile BAS-IP.

Ceux-ci comprennent des bibliothèques logicielles, de la documentation technique et des exemples de code. Les matériels exacts fournis et la manière dont ils sont mis à disposition dépendent de la configuration technique et des exigences du projet.

Les mises à jour nécessaires des bibliothèques et de la documentation sont fournies dans le cadre du support technique pour l’intégration. L’équipe du partenaire décide quand mettre à jour les composants utilisés et publier une nouvelle version de son application.

Qu’est-ce qui reste de la responsabilité du partenaire ?

Le partenaire est responsable de l’intégration des bibliothèques du SDK, du développement de l’interface utilisateur et de la logique applicative, des tests, de la publication de l’application sur l’App Store et Google Play, ainsi que de la maintenance continue.

Les exigences relatives à l’infrastructure push et la responsabilité de son déploiement sont convenues séparément pour chaque projet.

BAS-IP fournit le SDK, la documentation et les exemples de code, et répond aux questions techniques relatives à ses propres composants.

Les intégrations tierces du Mobile SDK utilisent actuellement BAS-IP Link Self-Hosted. Si un projet est prévu pour Link Cloud, l’architecture proposée doit être discutée avec BAS-IP avant le début du développement.

Qu’est-ce qui n’est pas inclus dans le Mobile SDK ?

Le Mobile SDK ne reproduit pas toutes les fonctionnalités de l’application BAS-IP Link. Par exemple, il n’inclut pas la génération de codes QR pour les invités ou la réservation d’équipements communs (amenity booking), bien que ces deux fonctionnalités soient disponibles dans l’application Link standard.

La génération de codes QR pour les invités et la réservation d’équipements communs sont disponibles via l’API BAS-IP Link. Si ces fonctions sont requises dans la propre application mobile du partenaire, elles peuvent être implémentées via une intégration supplémentaire avec BAS-IP Link.

Les deux outils peuvent être utilisés au sein du même projet. Le back-end de la plateforme gère les résidents et leurs droits d’accès via l’API Link, tandis que l’application mobile utilise le Mobile SDK pour recevoir les appels d’interphonie et ouvrir les portes.

Les scénarios d’intégration côté serveur sont traités plus en détail dans notre article sur l’API BAS-IP Link. Avant de commencer le développement, il est utile de lister tous les scénarios requis et de décider quel outil d’intégration gérera chacun d’eux.

Combien coûte le SDK mobile BAS-IP ?

Par défaut, BAS-IP ne facture pas de frais distincts pour l’accès au Mobile SDK, à sa documentation ou au support technique pendant l’intégration.

BAS-IP Link et les autres produits restent concédés sous licence selon leurs conditions standard, tandis que les identifiants mobiles UKEY sont achetés séparément auprès de BAS-IP ou de ses distributeurs.

Si un projet nécessite un développement supplémentaire de la part de BAS-IP ou une modification des priorités de développement, les conditions commerciales sont convenues séparément.

Le budget du projet doit également prendre en compte le travail de développement propre au partenaire, l’infrastructure, les tests et la maintenance continue de l’application.

Foire aux questions (FAQ)

Quelles versions d’iOS et d’Android sont prises en charge ?

Les versions minimales prises en charge actuellement sont spécifiées dans la documentation technique du SDK. Les exigences changent à mesure que les systèmes d’exploitation mobiles évoluent ; les développeurs doivent donc les vérifier avant de commencer l’intégration et à chaque mise à jour des bibliothèques.

Existe-t-il un bac à sable (sandbox) public ?

Il n’y a pas de bac à sable public partagé. Avec BAS-IP Link Self-Hosted, le partenaire déploie Link dans son propre environnement et utilise cette installation pour le développement. Les dispositions relatives aux licences de test et au matériel sont convenues en fonction des exigences de chaque projet.

Comment les mises à jour du SDK sont-elles fournies ?

Les mises à jour nécessaires du SDK sont fournies dans le cadre du support technique pour l’intégration. L’équipe de développement du partenaire planifie le moment d’appliquer les mises à jour, de tester les modifications et de publier une nouvelle version de son application.

Vous souhaitez ajouter la vidéophonie à votre application ?

Envoyez un e-mail à l’équipe d’intégration de BAS-IP à [email protected] ou soumettez une demande via le formulaire de contact.

Il n’est pas nécessaire de préparer un cahier des charges technique détaillé avant de prendre contact. Une brève description de votre application et de la fonctionnalité requise suffit.

Par exemple :

« Nous avons une application pour résidents sur iOS et Android. Nous voulons que les résidents reçoivent des appels vidéo des platines de rue BAS-IP et ouvrent la porte pendant un appel. »

Ou :

« Nous voulons ajouter l’accès mobile via Bluetooth. Nous prévoyons d’acheter des identifiants UKEY et d’émettre des codes QR d’activation aux résidents. »

Si l’équipement et la configuration de BAS-IP Link ont déjà été définis, veuillez inclure ces détails.

Cela aidera la discussion à progresser plus rapidement. L’équipe BAS-IP peut vous conseiller sur les composants nécessaires, l’infrastructure requise et la manière d’obtenir le SDK.