BAS-IP Mobile SDK: Cómo Añadir Videoportero a su Propia Aplicación Móvil
Un complejo residencial, una empresa de administración de fincas o una plataforma PropTech puede que ya tenga su propia aplicación móvil. Los residentes la utilizan para pagar facturas, reservar salas de reuniones, enviar solicitudes de mantenimiento y recibir notificaciones. Luego se instala un sistema de videoportero y se pide a los residentes que descarguen otra aplicación solo para responder a una llamada desde la entrada.
BAS-IP Mobile SDK elimina la necesidad de una segunda aplicación. Las videollamadas, la apertura de puertas y el acceso móvil pueden integrarse en la aplicación que los residentes ya utilizan. El equipo de desarrollo del socio trabaja con componentes listos para usar de BAS-IP y adapta la interfaz a su propio producto.
En nuestro resumen sobre la integración de BAS-IP con los sistemas existentes del edificio, cubrimos los enfoques disponibles: protocolos estándar, Link API, Mobile SDK y Device API. Aquí nos centramos en la integración móvil: qué puede hacer el SDK, qué hay que preparar y dónde están sus limitaciones.
Un Día en la Vida de un Residente
La forma más sencilla de explicar Mobile SDK es observar un día normal de alguien que vive en un edificio equipado con BAS-IP.
Mientras el residente está en el trabajo, un mensajero llama desde la placa de calle. El teléfono muestra el vídeo de la cámara incluso antes de que el residente conteste. Ve el paquete, responde a la llamada y abre la puerta.
Por la tarde, el residente vuelve a casa y utiliza su smartphone para abrir la puerta de entrada mediante Bluetooth. En la aplicación ya se ha activado una credencial móvil UKEY.
Un poco más tarde, la puerta de entrada principal se cierra de golpe, y el hijo del residente ya debería haber vuelto del colegio. El residente abre él mismo la cámara de la entrada, sin que haya ninguna llamada, para ver quién está en la puerta.
Todo esto ocurre en una sola aplicación. La misma aplicación que el residente utilizó esa mañana para pagar una factura.
Mobile SDK proporciona los componentes necesarios para cada una de estas acciones. Veamos cómo funcionan y qué debe preparar el equipo de desarrollo.
¿Qué Incluye BAS-IP Mobile SDK?
BAS-IP Mobile SDK proporciona bibliotecas, documentación técnica y ejemplos de código para desarrolladores móviles. Funciona con BAS-IP Link y es compatible tanto con iOS como con Android.
El SDK permite que una aplicación:
- registre y autentique a los usuarios;
- recupere perfiles de usuario y listas de dispositivos accesibles;
- reciba y realice llamadas de videoportero;
- transmita audio y vídeo;
- muestre el vídeo de una placa de calle antes de responder a una llamada;
- visualice la cámara de una placa de calle sin que haya una llamada entrante;
- abra puertas de forma remota;
- muestre el historial de llamadas entrantes y salientes;
- utilice un smartphone como credencial móvil Bluetooth;
- llame a un ascensor cuando el equipo necesario esté instalado en el edificio.
Los socios pueden seleccionar los componentes que necesiten y decidir cómo deben mostrarse esas funciones dentro de su aplicación.
Tres Componentes: Core, Calls y UKEY
Core conecta la aplicación con BAS-IP Link. Gestiona el inicio de sesión del residente, la recuperación de contraseñas y la obtención de perfiles de usuario y dispositivos accesibles. También proporciona la funcionalidad necesaria para iniciar llamadas, abrir puertas, mostrar el historial de llamadas y llamar a los ascensores.
Calls gestiona la comunicación del videoportero, incluidas las llamadas entrantes y salientes, la transmisión de audio y vídeo, y la gestión de llamadas. El SDK gestiona los estados de la llamada, como la recepción de una llamada entrante, la preparación de la aplicación para responder, la finalización de una llamada y qué parte terminó la conversación. En iOS, se utiliza CallKit para la gestión de llamadas a nivel de sistema.
UKEY convierte un smartphone en una llave móvil. El residente escanea un código QR, lo que activa una credencial móvil en la aplicación. A partir de ese momento, el teléfono puede utilizarse para abrir una puerta por Bluetooth a través de un lector BAS-IP compatible.
Dependiendo de cómo se implemente la aplicación, el acceso puede configurarse sin necesidad de pulsar un botón específico. Por ejemplo, la apertura de la puerta puede activarse cuando el residente desbloquea su teléfono cerca del lector. Sin embargo, el desbloqueo totalmente automático de la puerta simplemente acercándose con el teléfono bloqueado no es una función estándar del SDK.
El código QR se utiliza una sola vez para activar la credencial en el teléfono. No tiene relación con el código QR de visitante que un mensajero podría utilizar para entrar en el edificio.
¿Cómo Llega una Llamada Entrante al Teléfono?
Cuando la aplicación móvil se ejecuta en segundo plano o el teléfono está bloqueado, se utilizan notificaciones push para entregar las llamadas entrantes. Estas permiten activar la aplicación y prepararla para recibir una llamada, incluso cuando el residente no la ha abierto.
El proceso funciona de la siguiente manera:
- Un visitante pulsa el botón de llamada en una placa de calle BAS-IP.
- La llamada llega al servidor BAS-IP Link.
- El servidor push envía una notificación al smartphone del residente.
- La aplicación se activa y se prepara para recibir la llamada.
- El residente recibe la llamada entrante y puede contestarla.
Para recibir llamadas entrantes se requiere una infraestructura push. Esto incluye un servidor de notificaciones push que se comunica con Firebase Cloud Messaging (FCM) para Android y con Apple Push Notification service (APNs) para iOS.
Dependiendo de la arquitectura del proyecto, el servidor push puede ser desplegado por el socio o proporcionado por BAS-IP. La configuración adecuada se acuerda durante la planificación de la integración.
Si la aplicación no requiere funcionalidad de llamadas, no se necesita un servidor push. En todos los casos se requiere un servidor BAS-IP Link, ya que el SDK solo funciona con Link.
Su Aplicación, Su Interfaz
BAS-IP proporciona pantallas de muestra e iconos con el SDK, pero los socios no están obligados a utilizarlos. Los botones, las pantallas de llamada, la navegación y los colores pueden diseñarse para que coincidan con la aplicación existente.
Para los residentes, el videoportero se convierte en una parte natural de su aplicación de gestión de la propiedad, en lugar de ser un servicio independiente con la marca de otro proveedor.
Varios Teléfonos para un Mismo Apartamento
Un mensajero pulsa el botón de llamada de un apartamento y suenan los teléfonos de ambos padres. La primera persona en contestar atiende la llamada, mientras que la llamada entrante deja de sonar en el otro teléfono.
Las llamadas pueden llegar a diferentes teléfonos con unos instantes de diferencia, dependiendo de las condiciones de la red y del estado de cada dispositivo.
La lista de destinatarios viene determinada por los ajustes de desvío de llamadas en BAS-IP Link. Lo importante es que el sistema de videoportero de un apartamento no tiene por qué estar vinculado al teléfono de un único residente.
Vídeo Antes de Responder y Sin Llamada Entrante
El vídeo de la placa de calle puede mostrarse antes de que el residente responda a la llamada. Así puede ver quién está en la entrada y decidir si contesta o no.
También existe un segundo escenario: ver la cámara de la entrada cuando nadie ha llamado.
Técnicamente, esto sigue implicando establecer una conexión con la placa. Sin embargo, desde la perspectiva del residente, puede ser tan sencillo como tocar un botón para ver quién hay en la entrada.
¿A Quién Pueden Llamar los Residentes desde la Aplicación?
Los residentes pueden llamar a los dispositivos que tengan disponibles a través de BAS-IP Link. Dependiendo de la configuración del complejo, estos pueden incluir una placa de calle, un monitor interior en su apartamento, conserjería o el equipo de seguridad.
Lo que no pueden hacer es llamar directamente a otra aplicación móvil. El SDK no admite llamadas directas de aplicación a aplicación (app-to-app) entre dos smartphones.
Esta limitación debe tenerse en cuenta al diseñar la lista de contactos y las funciones de llamada de la aplicación.
Historial de Llamadas y Apertura de Puertas
La aplicación puede mostrar un historial de llamadas con las llamadas entrantes y salientes, la fecha y la hora, quién llamó o a quién se llamó, y si la llamada fue contestada o perdida.
Por ejemplo, un residente puede comprobar si alguien llamó mientras viajaba en transporte público.
El socio puede colocar el botón de apertura de puerta donde tenga más sentido dentro de la pantalla de llamada. El SDK se encarga de la comunicación necesaria con los equipos BAS-IP, por lo que los desarrolladores no tienen que implementar por sí mismos el mecanismo de comandos para abrir la puerta.
Control de Ascensores
La función de llamada de ascensor funciona cuando se cumplen dos condiciones: que se haya instalado y configurado un módulo de ascensor BAS-IP en el edificio, y que el residente tenga los permisos de acceso necesarios.
El SDK no puede controlar un sistema de ascensores directamente sin un módulo de ascensor BAS-IP. El equipamiento necesario, la compatibilidad y la configuración deben confirmarse durante el diseño del proyecto.
¿Por Qué Utilizar Mobile SDK en Lugar de Desarrollar la Comunicación de Videoportero desde Cero?
Una empresa puede desarrollar su propia funcionalidad de videoportero para su aplicación móvil. Sin embargo, su equipo tendría entonces que implementar las llamadas entrantes y salientes, las notificaciones push, el funcionamiento en segundo plano, la transmisión de audio y vídeo, la gestión de llamadas, la apertura de puertas y la comunicación con BAS-IP Link.
Esa funcionalidad también requeriría un mantenimiento continuo a medida que iOS y Android evolucionan.
BAS-IP Mobile SDK ofrece componentes listos para usar para estas tareas. El socio sigue siendo responsable de integrar los componentes, diseñar la interfaz de la aplicación, preparar la infraestructura necesaria y probar la solución, pero no necesita construir todo el sistema de comunicación de videoportero desde cero.
Esto resulta especialmente valioso para las plataformas PropTech en las que el videoportero es solo una función más dentro de un producto mucho más amplio. El equipo de desarrollo puede centrarse en su propia plataforma mientras utiliza los componentes existentes de BAS-IP para la comunicación del videoportero.
Para ver un ejemplo práctico, consulte el caso de estudio de integración de Accrete, donde se describe cómo un proveedor de tecnología inmobiliaria añadió funciones de videoportero BAS-IP a su aplicación móvil existente.
¿Qué Recibe el Equipo de Desarrollo?
Una vez acordado el proyecto y firmado un acuerdo de confidencialidad (NDA), el equipo de desarrollo del socio recibe acceso a los materiales necesarios de BAS-IP Mobile SDK.
Estos incluyen bibliotecas de software, documentación técnica y ejemplos de código. Los materiales exactos suministrados y la forma en que se ponen a disposición dependen de la configuración técnica y de los requisitos del proyecto.
Las actualizaciones necesarias de las bibliotecas y de la documentación se proporcionan como parte del soporte técnico para la integración. El equipo del socio decide cuándo actualizar los componentes en uso y lanzar una nueva versión de su aplicación.
¿Qué Sigue Siendo Responsabilidad del Socio?
El socio es responsable de integrar las bibliotecas del SDK, desarrollar la interfaz de usuario y la lógica de la aplicación, realizar las pruebas, publicar la aplicación en App Store y Google Play, y proporcionar el mantenimiento continuo.
Los requisitos de la infraestructura push y la responsabilidad de su despliegue se acuerdan por separado para cada proyecto.
BAS-IP proporciona el SDK, la documentación y los ejemplos de código, y responde a las consultas técnicas relacionadas con sus propios componentes.
Actualmente, las integraciones de Mobile SDK de terceros utilizan BAS-IP Link Self-Hosted. Si se planifica un proyecto para Link Cloud, la arquitectura propuesta debe analizarse con BAS-IP antes de que comience el desarrollo.
¿Qué No Está Incluido en Mobile SDK?
Mobile SDK no replica todas las funciones de la aplicación BAS-IP Link. Por ejemplo, no incluye la generación de códigos QR para invitados ni la reserva de zonas comunes (amenities), aunque ambas funciones están disponibles en la aplicación estándar Link.
La generación de códigos QR para invitados y la reserva de zonas comunes están disponibles a través de BAS-IP Link API. Si se requieren estas funciones en la aplicación móvil propia del socio, pueden implementarse mediante una integración adicional con BAS-IP Link.
Ambas herramientas pueden utilizarse dentro del mismo proyecto. El back-end de la plataforma gestiona a los residentes y sus permisos de acceso a través de Link API, mientras que la aplicación móvil utiliza Mobile SDK para recibir llamadas del videoportero y abrir puertas.
Los escenarios de integración del lado del servidor (server-side) se tratan con más detalle en nuestro artículo sobre BAS-IP Link API. Antes de comenzar el desarrollo, conviene hacer una lista de todos los escenarios necesarios y decidir qué herramienta de integración se encargará de cada uno.
¿Cuánto Cuesta BAS-IP Mobile SDK?
Por defecto, BAS-IP no cobra una tarifa adicional por el acceso a Mobile SDK, su documentación o el soporte técnico durante la integración.
BAS-IP Link y otros productos siguen licenciándose bajo sus condiciones estándar, mientras que las credenciales móviles UKEY se adquieren por separado a través de BAS-IP o sus distribuidores.
Si un proyecto requiere un desarrollo adicional por parte de BAS-IP o un cambio en las prioridades de desarrollo, las condiciones comerciales se acuerdan por separado.
El presupuesto del proyecto también debe tener en cuenta el trabajo de desarrollo propio del socio, la infraestructura, las pruebas y el mantenimiento continuo de la aplicación.
Preguntas Frecuentes (FAQ)
¿Qué Versiones de iOS y Android Son Compatibles?
Las versiones mínimas compatibles actualmente se especifican en la documentación técnica del SDK. Los requisitos cambian a medida que evolucionan los sistemas operativos móviles, por lo que los desarrolladores deben comprobarlos antes de iniciar la integración y cada vez que se actualicen las bibliotecas.
¿Existe un Entorno de Pruebas (Sandbox) Público?
No existe un entorno sandbox público compartido. Con BAS-IP Link Self-Hosted, el socio despliega Link en su propio entorno y utiliza esa instalación para el desarrollo. Los acuerdos sobre licencias de prueba y hardware se definen según los requisitos de cada proyecto.
¿Cómo se Proporcionan las Actualizaciones del SDK?
Las actualizaciones necesarias del SDK se proporcionan como parte del soporte técnico para la integración. El equipo de desarrollo del socio planifica cuándo aplicar las actualizaciones, probar los cambios y lanzar una nueva versión de su aplicación.
¿Quiere Añadir Videoportero a su Aplicación?
Envíe un correo electrónico al equipo de integraciones de BAS-IP a [email protected] o envíe una consulta a través del formulario de contacto.
No necesita preparar una especificación técnica detallada antes de ponerse en contacto. Basta con una breve descripción de su aplicación y de la funcionalidad requerida.
Por ejemplo:
“Tenemos una aplicación para residentes en iOS y Android. Queremos que los residentes reciban videollamadas de las placas de calle BAS-IP y abran la puerta durante una llamada.”
O bien:
“Queremos añadir acceso móvil por Bluetooth. Planeamos adquirir credenciales UKEY y emitir códigos QR de activación para los residentes.”
Si ya se han definido el equipamiento y la configuración de BAS-IP Link, incluya esos detalles.
Esto ayudará a que la conversación avance más rápidamente. El equipo de BAS-IP puede asesorarle sobre qué componentes se necesitan, qué infraestructura puede ser necesaria y cómo obtener el SDK.