BAS-IP Mobile SDK: як додати відеодомофонію у власний мобільний застосунок
Житловий комплекс, керівна компанія або PropTech-платформа вже можуть мати власний мобільний застосунок. Мешканці використовують його для оплати рахунків, бронювання переговорних кімнат, подання заявок на обслуговування та отримання сповіщень. Потім встановлюється система відеодомофонії, і мешканців просять завантажити ще один застосунок лише для того, щоб відповідати на виклики з під’їзду.
BAS-IP Mobile SDK усуває потребу в другому застосунку. Відеовиклики, відкриття дверей та мобільний доступ можна інтегрувати в застосунок, яким мешканці вже користуються. Команда розробників партнера працює з готовими компонентами BAS-IP та адаптує інтерфейс під власний продукт.
У нашому огляді інтеграції BAS-IP із наявними системами будівлі ми розглянули доступні підходи: стандартні протоколи, Link API, Mobile SDK та Device API. Тут ми зосередимося на мобільній інтеграції: що вміє SDK, що потрібно підготувати та де проходять межі його можливостей.
Один день із життя мешканця
Найпростіший спосіб пояснити роботу Mobile SDK — розглянути звичайний день людини, яка живе в будинку, обладнаному системою BAS-IP.
Поки мешканець перебуває на роботі, кур’єр телефонує з викличної панелі. Телефон показує відео з камери ще до того, як мешканець відповість на виклик. Він бачить посилку, відповідає на дзвінок і відчиняє двері.
Увечері мешканець повертається додому і за допомогою смартфона відчиняє вхідні двері через Bluetooth. Мобільний ідентифікатор UKEY вже активовано в застосунку.
Трохи пізніше грюкають вхідні двері під’їзду, а дитина мешканця вже мала б повернутися зі школи. Мешканець самостійно вмикає камеру викличної панелі, без жодного виклику, щоб подивитися, хто перебуває біля входу.
Усе це відбувається в одному застосунку. У тому самому застосунку, через який мешканець вранці оплатив рахунок.
Mobile SDK надає компоненти, необхідні для кожної з цих дій. Розгляньмо, як вони працюють і що потрібно підготувати команді розробників.
Що входить до складу BAS-IP Mobile SDK?
BAS-IP Mobile SDK надає бібліотеки, технічну документацію та приклади коду для мобільних розробників. Він працює з BAS-IP Link і підтримує як iOS, так і Android.
SDK дає змогу застосунку:
- реєструвати та автентифікувати користувачів;
- отримувати профілі користувачів і списки доступних пристроїв;
- приймати та здійснювати домофонні виклики;
- передавати аудіо та відео;
- відображати відео з викличної панелі до відповіді на виклик;
- переглядати камеру викличної панелі без вхідного виклику;
- дистанційно відчиняти двері;
- відображати історію вхідних і вихідних викликів;
- використовувати смартфон як мобільний Bluetooth-ідентифікатор;
- викликати ліфт за наявності встановленого на об’єкті відповідного обладнання.
Партнери можуть обрати потрібні їм компоненти та вирішити, як ці функції виглядатимуть у їхньому застосунку.
Три компоненти: Core, Calls та UKEY
Core з’єднує застосунок із BAS-IP Link. Він відповідає за вхід мешканця в систему, відновлення пароля, а також отримання профілів користувачів і доступних пристроїв. Крім того, він забезпечує функціональність, необхідну для ініціювання викликів, відчинення дверей, відображення історії викликів і виклику ліфтів.
Calls відповідає за домофонний зв’язок, включно з вхідними та вихідними викликами, передаванням аудіо та відео, а також керуванням викликами. SDK керує станами виклику: наприклад, надходженням вхідного дзвінка, готовністю застосунку до відповіді, завершенням виклику та визначенням того, яка зі сторін завершила розмову. На iOS для системної обробки викликів використовується CallKit.
UKEY перетворює смартфон на мобільний ключ. Мешканець сканує QR-код, який активує мобільний ідентифікатор у застосунку. Після цього телефон можна використовувати для відчинення дверей через Bluetooth за допомогою сумісного зчитувача BAS-IP.
Залежно від реалізації застосунку доступ можна налаштувати без натискання окремої кнопки. Наприклад, відчинення дверей може спрацьовувати, коли мешканець розблоковує свій телефон біля зчитувача. Однак повністю автоматичне відчинення дверей просто під час наближення із заблокованим телефоном не є стандартною функцією SDK.
QR-код використовується один раз для активації ідентифікатора на телефоні. Він не пов’язаний із гостьовим QR-кодом, який кур’єр може використовувати для входу в будівлю.
Як вхідний виклик надходить на телефон?
Коли мобільний застосунок працює у фоновому режимі або телефон заблоковано, для доставки вхідних викликів використовуються push-сповіщення. Вони дозволяють активувати застосунок і підготувати його до прийому виклику, навіть якщо мешканець його не відкривав.
Процес працює таким чином:
- Відвідувач натискає кнопку виклику на викличній панелі BAS-IP.
- Виклик надходить на сервер BAS-IP Link.
- Push-сервер надсилає сповіщення на смартфон мешканця.
- Застосунок активується і готується прийняти виклик.
- Мешканець отримує вхідний виклик і може відповісти на нього.
Для прийому вхідних викликів потрібна push-інфраструктура. Вона включає сервер push-сповіщень, який взаємодіє з Firebase Cloud Messaging (FCM) для Android та Apple Push Notification service (APNs) для iOS.
Залежно від архітектури проєкту push-сервер може бути розгорнутий партнером або наданий компанією BAS-IP. Відповідний варіант узгоджується під час планування інтеграції.
Якщо застосунку не потрібна функція викликів, push-сервер не потрібен. Сервер BAS-IP Link необхідний у всіх випадках, оскільки SDK працює лише з Link.
Ваш застосунок, ваш інтерфейс
BAS-IP надає приклади екранів та іконок разом із SDK, але партнери не зобов’язані їх використовувати. Кнопки, екрани виклику, навігацію та кольори можна оформити відповідно до дизайну наявного застосунку.
Для мешканців відеодомофонія стає природною частиною застосунку для керування нерухомістю, а не окремим сервісом під брендом стороннього виробника.
Кілька телефонів для однієї квартири
Кур’єр натискає кнопку виклику квартири, і телефони обох батьків дзвонять одночасно. Перший, хто відповість, приймає виклик, а на іншому телефоні вхідний дзвінок припиняється.
Виклики можуть надходити на різні телефони з різницею в кілька миттєвостей залежно від стану мережі та кожного пристрою.
Список одержувачів визначається налаштуваннями переадресації викликів у BAS-IP Link. Важливо те, що домофонна система квартири не обов’язково має бути прив’язана до телефону лише одного мешканця.
Відео до відповіді та без вхідного виклику
Відео з викличної панелі може відображатися ще до того, як мешканець відповість на дзвінок. Він може побачити, хто стоїть біля входу, а потім вирішити, чи відповідати.
Існує також другий сценарій: перегляд камери біля входу, коли ніхто не дзвонив.
Технічно це все одно передбачає встановлення з’єднання з панеллю. Проте з погляду мешканця це може виглядати як просте натискання кнопки, щоб побачити, хто перебуває біля входу.
Кому мешканці можуть дзвонити із застосунку?
Мешканці можуть телефонувати на пристрої, доступні їм через BAS-IP Link. Залежно від конфігурації об’єкта це може бути виклична панель, внутрішній монітор у квартирі, консьєрж або служба охорони.
Чого вони не можуть зробити, то це зателефонувати напряму в інший мобільний застосунок. SDK не підтримує прямі виклики між двома смартфонами з застосунку в застосунок.
Це обмеження слід враховувати під час проєктування списку контактів і функцій виклику в застосунку.
Історія викликів і відчинення дверей
Застосунок може відображати історію викликів із зазначенням вхідних і вихідних дзвінків, дати й часу, того, хто дзвонив або кому дзвонили, а також статусу виклику — прийнятий чи пропущений.
Наприклад, мешканець може перевірити, чи дзвонив хтось, поки він їхав у громадському транспорті.
Партнер може розмістити кнопку відчинення дверей у будь-якому зручному місці на екрані виклику. SDK бере на себе необхідний обмін даними з обладнанням BAS-IP, тому розробникам не потрібно самостійно реалізовувати механізм команд для відчинення дверей.
Керування ліфтом
Функція виклику ліфта працює за дотримання двох умов: на об’єкті встановлено та налаштовано ліфтовий модуль BAS-IP, а мешканець має відповідні права доступу.
SDK не може керувати ліфтовою системою напряму без ліфтового модуля BAS-IP. Необхідне обладнання, сумісність і конфігурацію потрібно підтвердити на етапі проєктування.
Чому варто використовувати Mobile SDK замість розробки домофонного зв’язку з нуля?
Компанія може розробити власну функціональність відеодомофонії для свого мобільного застосунку. Однак тоді її команді доведеться самостійно реалізовувати вхідні та вихідні виклики, push-сповіщення, роботу у фоновому режимі, передавання аудіо та відео, керування викликами, відчинення дверей і зв’язок із BAS-IP Link.
Ця функціональність також потребуватиме постійної підтримки в міру оновлення iOS та Android.
BAS-IP Mobile SDK надає готові компоненти для виконання цих завдань. Партнер залишається відповідальним за інтеграцію компонентів, розробку інтерфейсу застосунку, підготовку необхідної інфраструктури та тестування рішення, але йому не потрібно створювати всю систему домофонного зв’язку з нуля.
Це особливо цінно для PropTech-платформ, де відеодомофонія є лише однією з функцій значно більшого продукту. Команда розробників може зосередитися на розвитку власної платформи, використовуючи готові компоненти BAS-IP для домофонного зв’язку.
Практичний приклад можна переглянути в кейсі інтеграції Accrete, де описано, як постачальник технологій для нерухомості додав функції домофонії BAS-IP у свій наявний мобільний застосунок.
Що отримує команда розробників?
Після узгодження проєкту та підписання договору про нерозголошення (NDA) команда розробників партнера отримує доступ до необхідних матеріалів BAS-IP Mobile SDK.
До них належать програмні бібліотеки, технічна документація та приклади коду. Точний перелік матеріалів і спосіб їх надання залежать від технічної конфігурації та вимог проєкту.
Необхідні оновлення бібліотек і документації надаються в межах технічної підтримки інтеграції. Команда партнера самостійно вирішує, коли оновлювати використовувані компоненти та випускати нову версію свого застосунку.
За що відповідає партнер?
Партнер відповідає за інтеграцію бібліотек SDK, розробку інтерфейсу користувача та логіки застосунку, тестування, публікацію застосунку в App Store і Google Play, а також за його подальшу підтримку.
Вимоги до push-інфраструктури та відповідальність за її розгортання узгоджуються окремо для кожного проєкту.
BAS-IP надає SDK, документацію та приклади коду, а також відповідає на технічні запитання щодо власних компонентів.
Сторонні інтеграції Mobile SDK наразі використовують BAS-IP Link Self-Hosted. Якщо проєкт планується для Link Cloud, запропоновану архітектуру слід обговорити з BAS-IP до початку розробки.
Що не входить до складу Mobile SDK?
Mobile SDK не дублює всі функції застосунку BAS-IP Link. Наприклад, він не включає генерацію гостьових QR-кодів або бронювання спільних зон (аменітіз), хоча обидві функції доступні в стандартному застосунку Link.
Генерація гостьових QR-кодів і бронювання зон загального користування доступні через BAS-IP Link API. Якщо ці функції потрібні у власному мобільному застосунку партнера, їх можна реалізувати за допомогою додаткової інтеграції з BAS-IP Link.
Обидва інструменти можна використовувати в межах одного проєкту. Бекенд платформи керує мешканцями та їхніми правами доступу через Link API, тоді як мобільний застосунок використовує Mobile SDK для прийому домофонних викликів і відчинення дверей.
Сценарії серверної інтеграції докладніше розглянуто в нашій статті про BAS-IP Link API. Перед початком розробки варто скласти список усіх необхідних сценаріїв і вирішити, який інструмент інтеграції відповідатиме за кожен із них.
Скільки коштує BAS-IP Mobile SDK?
За замовчуванням BAS-IP не стягує окремої плати за доступ до Mobile SDK, його документації або за технічну підтримку під час інтеграції.
BAS-IP Link та інші продукти ліцензуються на стандартних умовах, а мобільні ідентифікатори UKEY купуються окремо у BAS-IP або її дистриб’юторів.
Якщо проєкт потребує додаткової розробки з боку BAS-IP або зміни пріоритетів розробки, комерційні умови узгоджуються окремо.
У бюджеті проєкту також слід враховувати витрати партнера на власну розробку, інфраструктуру, тестування та постійну підтримку застосунку.
Часті запитання (FAQ)
Які версії iOS та Android підтримуються?
Актуальні мінімальні підтримувані версії вказані в технічній документації SDK. Вимоги змінюються з розвитком мобільних операційних систем, тому розробникам слід перевіряти їх перед початком інтеграції та під час кожного оновлення бібліотек.
Чи є публічна пісочниця (sandbox)?
Загальної публічної пісочниці немає. У випадку з BAS-IP Link Self-Hosted партнер розгортає Link у власному середовищі та використовує цю інсталяцію для розробки. Умови надання тестових ліцензій та обладнання узгоджуються відповідно до вимог кожного проєкту.
Як надаються оновлення SDK?
Необхідні оновлення SDK надаються в межах технічної підтримки інтеграції. Команда розробників партнера сама планує, коли застосовувати оновлення, тестувати зміни та випускати нову версію свого застосунку.
Хочете додати відеодомофонію у свій застосунок?
Напишіть команді інтеграцій BAS-IP на адресу [email protected] або надішліть запит через контактну форму.
Вам не потрібно готувати детальне технічне завдання перед зверненням. Достатньо короткого опису вашого застосунку та необхідної функціональності.
Наприклад:
«У нас є застосунок для мешканців на iOS та Android. Ми хочемо, щоб мешканці отримували відеовиклики з викличних панелей BAS-IP і відчиняли двері під час дзвінка».
Або:
«Ми хочемо додати мобільний доступ через Bluetooth. Плануємо придбати ідентифікатори UKEY та видавати мешканцям QR-коди для активації».
Якщо обладнання та конфігурація BAS-IP Link вже визначені, вкажіть ці деталі.
Це допоможе швидше перейти до предметного обговорення. Команда BAS-IP підкаже, які компоненти знадобляться, яка інфраструктура може бути потрібною та як отримати SDK.