Интеграция IP-домофонии BAS-IP с существующими системами здания
На одном объекте управляющая компания работает в платформе управления недвижимостью, служба безопасности — в СКУД, а жильцы — в отдельном мобильном приложении. Если домофония остаётся ещё одной изолированной системой, одних и тех же пользователей, права доступа и события приходится вести сразу в нескольких местах.
BAS-IP можно встроить в цифровую инфраструктуру здания, которая уже используется. Управляющая платформа остаётся основным рабочим интерфейсом для персонала, а существующее приложение для жильцов получает функции домофонии и открытия двери.
Путей для этого четыре: совместимость по стандартным протоколам, BAS-IP Link API, BAS-IP Mobile SDK и BAS-IP Device API. Ниже — что подходит под какую задачу.
Что такое BAS-IP Link
BAS-IP Link — программная платформа, которая управляет подключёнными устройствами BAS-IP, объектами и квартирами, пользователями, идентификаторами доступа, вызовами и конфигурацией оборудования.
Она доступна в двух вариантах: Link Self-Hosted на сервере заказчика и Link Cloud как облачный сервис BAS-IP.
Совместимость по стандартным протоколам
Не для каждой задачи нужны разработчики. Оборудование BAS-IP работает по тем же стандартным протоколам, что и телефония, видеонаблюдение и системы контроля доступа:
- SIP — панель регистрируется как SIP-клиент на АТС заказчика, а вызовы приходят на существующие телефоны и софтфоны;
- RTSP — панель подключается к VMS или NVR как источник видео вместе с остальными камерами объекта;
- Wiegand — считыватель панели передаёт идентификатор в стороннюю систему контроля доступа.
Такие сценарии настраиваются с обеих сторон и не требуют работы с BAS-IP API или SDK.
Примечание. Для SIP-сценария необходимо заранее проверить совместимость аудио- и видеокодеков сторонней системы с конкретным оборудованием BAS-IP. Например, оборудование BAS-IP поддерживает сценарии с PCMA для аудио и H.264 для видео. Актуальный набор кодеков необходимо проверять для конкретной модели и версии прошивки.
Стандартные протоколы позволяют передавать вызовы, видеопотоки и идентификаторы, но сами по себе не обеспечивают синхронизацию пользователей, квартир и прав доступа между системами.
Если требуется автоматизировать управление пользователями, выдачу и отзыв прав доступа или работу с журналами событий, используются API или SDK.
BAS-IP Link API: интеграция с управляющей или серверной платформой
Link API позволяет автоматизировать управление жильцами, правами доступа и событиями BAS-IP через уже используемую платформу управления недвижимостью, СКУД или другую корпоративную систему.
Простой пример — заселение жильца.
Сотрудник создаёт профиль в своей платформе: имя, квартиру и контактные данные. Без интеграции того же пользователя заводят второй раз вручную в системе домофонии.
Через Link API данные передаются автоматически: пользователь появляется в нужном объекте и квартире в BAS-IP Link, а оттуда информация применяется к подключённой инфраструктуре BAS-IP.
Это только один из сценариев.
Через Link API сторонняя система может работать с:
- пользователями и структурой объектов;
- правами доступа;
- постоянными идентификаторами: картами, брелоками, кодами, QR-кодами, Face ID, UKEY и номерами автомобилей;
- временными идентификаторами с ограниченным сроком действия;
- гостевым доступом и посетителями;
- сообщениями для жильцов;
- виртуальными номерами и переадресацией вызовов;
- удалённой конфигурацией устройств;
- событиями и журналами.
Конкретный набор зависит от задачи.
При такой схеме основная платформа заказчика может оставаться рабочим интерфейсом его сотрудников.
В настоящее время сторонние серверные интеграции через Link API поддерживаются в BAS-IP Link Self-Hosted. Для проектов на Link Cloud доступные варианты интеграции необходимо согласовать с BAS-IP.
BAS-IP Mobile SDK: домофония внутри собственного приложения
Второй сценарий — у компании уже есть мобильное приложение для жильцов, арендаторов или сотрудников.
В нём могут быть заявки в управляющую компанию, платежи, бронирование помещений и уведомления. Отдельное приложение только для домофонии в такой ситуации может быть избыточным.
BAS—IP Mobile SDK позволяет встроить в существующее приложение широкий набор функций домофонии и управления доступом через BAS-IP Link. Среди доступных возможностей:
- авторизацию пользователя;
- приём и совершение вызовов с аудио и видео;
- просмотр видео с панели до ответа на вызов;
- push-уведомления;
- открытие двери;
- историю вызовов;
- мобильный доступ по BLE через компонент UKEY;
- вызов лифта на разрешённый этаж при наличии настроенного лифтового модуля BAS-IP.
Поддерживаются iOS и Android.
Жилец принимает вызов с панели прямо в приложении, которым уже пользуется, может увидеть посетителя ещё до ответа и открыть дверь.
Разработчику при этом не нужно строить домофонный модуль с нуля: детали SIP-коммуникации и взаимодействия с BAS-IP Link уже реализованы в готовых компонентах, а задача команды партнёра — встроить их в своё приложение.
Mobile SDK не повторяет весь функционал приложения BAS-IP Link, а даёт определённый набор готовых возможностей.
Некоторые функции, отсутствующие в Mobile SDK, доступны через BAS-IP Link API. Например, создание гостевых QR-кодов и бронирование помещений можно реализовать в приложении партнёра через дополнительную интеграцию с Link API.
Интеграция сторонних мобильных приложений через Mobile SDK сейчас поддерживается в BAS-IP Link Self-Hosted.
BAS-IP Device API: прямая работа с оборудованием
Не каждая интеграция требует BAS-IP Link.
Вызывные панели, внутренние мониторы и другие поддерживаемые устройства BAS-IP, включая лифтовый модуль, имеют собственный локальный API, поэтому сторонняя система может обращаться к оборудованию напрямую.
Разница простая:
Device API связывает вашу систему непосредственно с конкретными устройствами BAS-IP.
Link API связывает вашу систему с BAS-IP Link, который уже управляет подключённым оборудованием.
Прямая работа с устройствами подходит для локального проекта с ограниченным и заранее известным набором моделей.
Интеграция через Link удобнее, когда система охватывает разные модели, большое количество устройств или несколько объектов: Link снижает зависимость интеграции от особенностей отдельных моделей и их прошивок.
Доступ к Device API получить проще: документация открыта, NDA не требуется. Достаточно зарегистрироваться на портале разработчиков BAS-IP — developers.bas-ip.com — и подтвердить email.
Webhooks
Android-панели BAS-IP дополнительно поддерживают webhooks.
Внешняя система получает события в момент, когда они происходят: открытие двери, предоставление или отказ в доступе, обновление устройства и другие события журнала.
Это удобно для сценариев умного здания, где на проход или открытие двери должна реагировать другая система.
Webhooks настраиваются непосредственно на панели через конфигурацию устройства.
На Linux-панелях, мониторах и на уровне BAS-IP Link webhooks не поддерживаются.
Какой способ интеграции выбрать
| Если у вас уже есть | Обычно подходит | Основная задача |
| Телефония, VMS или СКУД | SIP, RTSP, Wiegand | Передать вызов, видеопоток или идентификатор без глубокой программной интеграции |
| Платформа управления недвижимостью, СКУД или другая серверная система | BAS-IP Link API | Связать пользователей, доступ и процессы BAS-IP с существующей платформой |
| Собственное мобильное приложение | BAS-IP Mobile SDK | Добавить вызовы, видео и открытие двери в существующее приложение |
| Локальная система с конкретными устройствами BAS-IP | BAS-IP Device API | Работать с оборудованием напрямую; на Android-панелях — в том числе получать события через webhooks |
| Серверная платформа и собственное мобильное приложение | Link API + Mobile SDK | Закрыть и серверные процессы, и пользовательские функции |
Определять подход заранее необязательно. Чаще всего он становится понятен после того, как описаны существующая система и нужный сценарий.
Что это даёт на объекте
- Быстрее первоначальная настройка: данные о пользователях и связанные с ними параметры можно передавать из системы, где они уже ведутся.
- Меньше повторного ввода: одни и те же данные не нужно заносить в несколько интерфейсов.
- Общие данные объекта: события домофонии и доступа можно собирать вместе с остальной информацией.
- Привычные рабочие процессы: персонал продолжает работать в знакомой системе, а жильцы — в одном приложении.
Чем больше объект, пользователей и связанных систем, тем заметнее эффект.
Как проходит интеграция
Работа начинается с обсуждения задачи. Партнёр рассказывает, какую систему использует и что хочет реализовать. Например, принимать вызовы с домофонов BAS-IP в собственном приложении для жильцов или автоматически передавать данные о новых пользователях из платформы управления недвижимостью. На основе этих требований BAS-IP помогает выбрать подходящий способ интеграции и согласовать, как должно работать готовое решение.
Когда сценарий определён, команда партнёра получает необходимые технические материалы и может приступать к разработке. Для работы с Link API и Mobile SDK предварительно подписывается NDA, а документация по Device API доступна открыто. Условия предоставления тестовой среды, лицензий и оборудования обсуждаются с учётом особенностей проекта.
Саму интеграцию разрабатывает команда партнёра, а специалисты BAS-IP консультируют по работе своих продуктов и помогают разобраться с техническими вопросами, возникающими в процессе. Если для реализации задуманного сценария не хватает существующих возможностей BAS-IP, можно обсудить дополнительную разработку. Сроки таких доработок зависят от объёма работ и текущих приоритетов продуктовой команды.
После завершения разработки партнёр тестирует интеграцию в своей среде, а затем демонстрирует результат BAS-IP или предоставляет описание реализованного решения.
Продолжительность интеграции зависит от сложности проекта, архитектуры сторонней системы и загрузки команды разработчиков. На сроки также влияют подготовка среды разработки и тестирование.
Сколько это стоит
BAS-IP по умолчанию не взимает отдельной платы за доступ к документации и инструментам интеграции.
Лицензирование продуктов BAS-IP при этом осуществляется на обычных условиях, а дополнительные доработки или изменение их приоритета согласовываются отдельно.
Частые вопросы
Чем Link API отличается от Mobile SDK?
Link API связывает BAS-IP с серверной системой — например, платформой управления недвижимостью или СКУД. Mobile SDK добавляет функции домофонии в мобильное приложение. В одном проекте их можно использовать вместе.
Нужен ли BAS-IP Link для интеграции?
Не всегда. Многие устройства BAS-IP имеют собственный локальный API, поэтому сторонняя система может работать с оборудованием напрямую. Link обычно удобнее, когда интеграция охватывает разные модели, много устройств или несколько объектов.
Нужен ли NDA?
NDA требуется для Link API и Mobile SDK. Документация по Device API открыта.
Есть ли webhooks?
Да, на Android-панелях. Внешняя система может получать события устройства в реальном времени. На Linux-панелях, мониторах и на уровне Link webhooks нет.
Можно ли интегрировать стороннюю платформу с BAS-IP Link Cloud?
Внешние интеграции сторонних серверных систем через Link API сейчас реализуются на Link Self-Hosted. Для Link Cloud такая возможность находится в разработке.
Хотите интегрировать BAS-IP со своей системой?
Расскажите, какую платформу, приложение или оборудование вы используете и какой сценарий хотите реализовать.
Команда BAS-IP поможет определить подходящий вариант: совместимость по протоколам, Link API, Mobile SDK, Device API или их комбинацию.