BAS-IP Mobile SDK: Como Adicionar Videoporteiro à Sua Própria Aplicação Móvel
Um condomínio residencial, uma empresa de gestão de propriedades ou uma plataforma PropTech já pode ter a sua própria aplicação móvel. Os moradores utilizam-na para pagar contas, reservar salas de reuniões, enviar pedidos de manutenção e receber notificações. Depois, é instalado um sistema de videoporteiro e pede-se aos moradores que descarreguem outra aplicação apenas para atender uma chamada da entrada.
O BAS-IP Mobile SDK elimina a necessidade de uma segunda aplicação. As videochamadas, a abertura de portas e o acesso móvel podem ser integrados na aplicação que os moradores já utilizam. A equipa de desenvolvimento do parceiro trabalha com componentes prontos da BAS-IP e adapta a interface ao seu próprio produto.
Na nossa visão geral sobre a integração da BAS-IP com sistemas de edifícios existentes, abordámos os métodos disponíveis: protocolos padrão, Link API, Mobile SDK e Device API. Aqui, focamo-nos na integração móvel: o que o SDK pode fazer, o que precisa de ser preparado e onde estão as suas limitações.
Um Dia na Vida de um Morador
A maneira mais fácil de explicar o Mobile SDK é observar um dia comum de alguém que vive num edifício equipado com BAS-IP.
Enquanto o morador está no trabalho, um estafeta liga a partir do painel de entrada. O telemóvel exibe o vídeo da câmara mesmo antes de o morador atender. Ele vê a encomenda, atende a chamada e abre a porta.
À noite, o morador regressa a casa e usa o seu smartphone para abrir a porta de entrada via Bluetooth. Uma credencial móvel UKEY já foi ativada na aplicação.
Um pouco mais tarde, a porta de entrada principal bate e o filho do morador já deveria ter chegado da escola. O próprio morador abre a câmara da entrada, sem qualquer chamada, para ver quem está na porta.
Tudo isto acontece numa única aplicação. A mesma aplicação que o morador usou para pagar uma conta naquela manhã.
O Mobile SDK fornece os componentes necessários para cada uma destas ações. Vamos ver como funcionam e o que a equipa de desenvolvimento precisa de preparar.
O Que Está Incluído no BAS-IP Mobile SDK?
O BAS-IP Mobile SDK fornece bibliotecas, documentação técnica e exemplos de código para programadores móveis. Funciona com o BAS-IP Link e suporta tanto iOS como Android.
O SDK permite que uma aplicação:
- registe e autentique utilizadores;
- obtenha perfis de utilizadores e listas de dispositivos acessíveis;
- receba e faça chamadas de videoporteiro;
- transmita áudio e vídeo;
- exiba vídeo de um painel de entrada antes de uma chamada ser atendida;
- visualize a câmara de um painel de entrada sem uma chamada recebida;
- abra portas remotamente;
- exiba o histórico de chamadas recebidas e efetuadas;
- utilize um smartphone como credencial móvel Bluetooth;
- chame um elevador quando o equipamento necessário estiver instalado no local.
Os parceiros podem selecionar os componentes de que necessitam e decidir como essas funções devem aparecer na sua aplicação.
Três Componentes: Core, Calls e UKEY
O Core liga a aplicação ao BAS-IP Link. Gere o início de sessão do morador, a recuperação de palavras-passe e a obtenção de perfis de utilizadores e dispositivos acessíveis. Também fornece a funcionalidade necessária para iniciar chamadas, abrir portas, exibir o histórico de chamadas e chamar elevadores.
O Calls gere a comunicação do videoporteiro, incluindo chamadas recebidas e efetuadas, transmissão de áudio e vídeo e gestão de chamadas. O SDK gere os estados da chamada, como a receção de uma chamada, a preparação da aplicação para atender, o fim de uma chamada e qual das partes terminou a conversa. No iOS, o CallKit é utilizado para a gestão de chamadas ao nível do sistema.
O UKEY transforma um smartphone numa chave móvel. O morador lê um código QR, o que ativa uma credencial móvel na aplicação. O telemóvel pode então ser usado para abrir uma porta via Bluetooth através de um leitor BAS-IP compatível.
Dependendo de como a aplicação é implementada, o acesso pode ser configurado sem a necessidade de premir um botão separado. Por exemplo, a abertura da porta pode ser acionada quando o morador desbloqueia o telemóvel perto do leitor. No entanto, o desbloqueio totalmente automático da porta apenas por se aproximar com o telemóvel bloqueado não é uma funcionalidade padrão do SDK.
O código QR é utilizado uma única vez para ativar a credencial no telemóvel. Não tem relação com o código QR de visitante que um estafeta possa usar para entrar no edifício.
Como é Que uma Chamada Recebida Chega ao Telemóvel?
Quando a aplicação móvel está a ser executada em segundo plano ou o telemóvel está bloqueado, são utilizadas notificações push para entregar as chamadas recebidas. Elas permitem que a aplicação seja ativada e preparada para receber uma chamada, mesmo quando o morador não a abriu.
O processo funciona da seguinte forma:
- Um visitante prime o botão de chamada num painel de entrada BAS-IP.
- A chamada chega ao servidor BAS-IP Link.
- O servidor push envia uma notificação para o smartphone do morador.
- A aplicação é ativada e prepara-se para receber a chamada.
- O morador recebe a chamada e pode atendê-la.
A receção de chamadas requer uma infraestrutura push. Isto inclui um servidor de notificações push que comunica com o Firebase Cloud Messaging (FCM) para Android e com o Apple Push Notification service (APNs) para iOS.
Dependendo da arquitetura do projeto, o servidor push pode ser implementado pelo parceiro ou fornecido pela BAS-IP. O modelo adequado é acordado durante o planeamento da integração.
Se a aplicação não necessitar de funcionalidade de chamadas, não é necessário um servidor push. Um servidor BAS-IP Link é obrigatório em todos os casos, uma vez que o SDK funciona apenas com o Link.
A Sua Aplicação, a Sua Interface
A BAS-IP fornece ecrãs de exemplo e ícones com o SDK, mas os parceiros não são obrigados a utilizá-los. Botões, ecrãs de chamada, navegação e cores podem ser desenhados para combinar com a aplicação existente.
Para os moradores, o videoporteiro torna-se uma parte natural da sua aplicação de gestão do condomínio, em vez de um serviço separado com a marca de outro fornecedor.
Vários Telemóveis para um Apartamento
Um estafeta prime o botão de chamada de um apartamento e os telemóveis de ambos os pais tocam. A primeira pessoa a atender fica com a chamada, enquanto a chamada recebida deixa de tocar no outro telemóvel.
As chamadas podem chegar a diferentes telemóveis com alguns momentos de diferença, dependendo das condições da rede e do estado de cada dispositivo.
A lista de destinatários é determinada pelas definições de reencaminhamento de chamadas no BAS-IP Link. O ponto importante é que o sistema de videoporteiro de um apartamento não tem de estar vinculado ao telemóvel de um único morador.
Vídeo Antes de Atender e Sem Chamada Recebida
O vídeo do painel de entrada pode ser exibido antes de o morador atender a chamada. Ele pode ver quem está na entrada e depois decidir se quer atender.
Existe também um segundo cenário: ver a câmara da entrada quando ninguém ligou.
Tecnicamente, isto ainda envolve o estabelecimento de uma ligação com o painel. Contudo, na perspetiva do morador, pode ser tão simples como tocar num botão para ver quem está na entrada.
Para Quem Podem os Moradores Ligar a Partir da Aplicação?
Os moradores podem ligar para os dispositivos que lhes estão disponíveis através do BAS-IP Link. Dependendo da configuração do local, estes podem incluir um painel de entrada, um monitor interno no seu apartamento, a portaria (concierge) ou a equipa de segurança.
O que não podem fazer é ligar diretamente para outra aplicação móvel. O SDK não suporta chamadas diretas entre aplicações (app-to-app) entre dois smartphones.
Esta limitação deve ser considerada ao desenhar a lista de contactos e as funções de chamada da aplicação.
Histórico de Chamadas e Abertura de Portas
A aplicação pode exibir um histórico de chamadas mostrando as chamadas recebidas e efetuadas, a data e a hora, quem ligou ou para quem se ligou, e se a chamada foi atendida ou perdida.
Por exemplo, um morador pode verificar se alguém ligou enquanto viajava nos transportes públicos.
O parceiro pode colocar o botão de abertura da porta onde fizer mais sentido no ecrã de chamada. O SDK trata da comunicação necessária com o equipamento BAS-IP, pelo que os programadores não têm de implementar eles próprios o mecanismo de comando de abertura da porta.
Controlo de Elevadores
A função de chamada de elevador funciona quando duas condições são cumpridas: um módulo de elevador BAS-IP foi instalado e configurado no local, e o morador possui os direitos de acesso necessários.
O SDK não pode controlar um sistema de elevador diretamente sem um módulo de elevador BAS-IP. O equipamento necessário, a compatibilidade e a configuração devem ser confirmados durante a conceção do projeto.
Porquê Usar o Mobile SDK em Vez de Desenvolver a Comunicação de Videoporteiro do Zero?
Uma empresa pode desenvolver a sua própria funcionalidade de videoporteiro para a sua aplicação móvel. No entanto, a sua equipa precisaria então de implementar chamadas recebidas e efetuadas, notificações push, funcionamento em segundo plano, transmissão de áudio e vídeo, gestão de chamadas, abertura de portas e comunicação com o BAS-IP Link.
Essa funcionalidade também precisaria de manutenção contínua à medida que o iOS e o Android evoluem.
O BAS-IP Mobile SDK fornece componentes prontos para estas tarefas. O parceiro continua responsável por integrar os componentes, desenhar a interface da aplicação, preparar a infraestrutura necessária e testar a solução, mas não precisa de construir todo o sistema de comunicação de videoporteiro a partir do zero.
Isto é particularmente valioso para plataformas PropTech, em que o videoporteiro é apenas uma funcionalidade de um produto muito maior. A equipa de desenvolvimento pode concentrar-se na sua própria plataforma enquanto utiliza os componentes BAS-IP existentes para a comunicação de videoporteiro.
Para um exemplo prático, consulte o estudo de caso da integração da Accrete, que descreve como um fornecedor de tecnologia imobiliária adicionou funções de videoporteiro BAS-IP à sua aplicação móvel existente.
O Que Recebe a Equipa de Desenvolvimento?
Uma vez acordado o projeto e assinado um acordo de confidencialidade (NDA), a equipa de desenvolvimento do parceiro recebe acesso aos materiais necessários do BAS-IP Mobile SDK.
Estes incluem bibliotecas de software, documentação técnica e exemplos de código. Os materiais exatos fornecidos e a forma como são disponibilizados dependem da configuração técnica e dos requisitos do projeto.
As atualizações necessárias das bibliotecas e da documentação são fornecidas como parte do suporte técnico para a integração. A equipa do parceiro decide quando atualizar os componentes em uso e lançar uma nova versão da sua aplicação.
O Que Permanece sob a Responsabilidade do Parceiro?
O parceiro é responsável por integrar as bibliotecas do SDK, desenvolver a interface de utilizador e a lógica da aplicação, testar, publicar a aplicação na App Store e no Google Play e fornecer manutenção contínua.
Os requisitos da infraestrutura push e a responsabilidade pela implementação são acordados separadamente para cada projeto.
A BAS-IP fornece o SDK, a documentação e os exemplos de código, e responde a questões técnicas relacionadas com os seus próprios componentes.
As integrações de terceiros do Mobile SDK utilizam atualmente o BAS-IP Link Self-Hosted. Se um projeto for planeado para o Link Cloud, a arquitetura proposta deve ser discutida com a BAS-IP antes do início do desenvolvimento.
O Que Não Está Incluído no Mobile SDK?
O Mobile SDK não replica todas as funcionalidades da aplicação BAS-IP Link. Por exemplo, não inclui a geração de códigos QR para convidados nem a reserva de espaços comuns (amenities), embora ambas as funcionalidades estejam disponíveis na aplicação Link padrão.
A geração de códigos QR para convidados e a reserva de espaços comuns estão disponíveis através da BAS-IP Link API. Se estas funções forem necessárias na aplicação móvel do próprio parceiro, podem ser implementadas através de uma integração adicional com o BAS-IP Link.
Ambas as ferramentas podem ser utilizadas no mesmo projeto. O back-end da plataforma gere os moradores e as suas permissões de acesso através da Link API, enquanto a aplicação móvel utiliza o Mobile SDK para receber chamadas de videoporteiro e abrir portas.
Os cenários de integração do lado do servidor (server-side) são abordados com mais detalhe no nosso artigo sobre a BAS-IP Link API. Antes do início do desenvolvimento, vale a pena listar todos os cenários necessários e decidir qual a ferramenta de integração que irá tratar de cada um.
Quanto Custa o BAS-IP Mobile SDK?
Por padrão, a BAS-IP não cobra uma taxa separada pelo acesso ao Mobile SDK, à sua documentação ou ao suporte técnico durante a integração.
O BAS-IP Link e outros produtos continuam a ser licenciados sob os seus termos padrão, enquanto as credenciais móveis UKEY são adquiridas separadamente à BAS-IP ou aos seus distribuidores.
Se um projeto exigir desenvolvimento adicional por parte da BAS-IP ou uma alteração nas prioridades de desenvolvimento, os termos comerciais são acordados separadamente.
O orçamento do projeto também deve contemplar o próprio trabalho de desenvolvimento do parceiro, a infraestrutura, os testes e a manutenção contínua da aplicação.
Perguntas Frequentes (FAQ)
Quais são as Versões de iOS e Android Suportadas?
As versões mínimas atualmente suportadas estão especificadas na documentação técnica do SDK. Os requisitos mudam à medida que os sistemas operativos móveis evoluem, pelo que os programadores devem verificá-los antes de iniciar a integração e sempre que as bibliotecas forem atualizadas.
Existe uma Sandbox Pública?
Não existe uma sandbox pública partilhada. Com o BAS-IP Link Self-Hosted, o parceiro implementa o Link no seu próprio ambiente e utiliza essa instalação para o desenvolvimento. Os acordos sobre licenças de teste e hardware são definidos de acordo com os requisitos de cada projeto.
Como São Fornecidas as Atualizações do SDK?
As atualizações necessárias do SDK são fornecidas como parte do suporte técnico para a integração. A equipa de desenvolvimento do parceiro planeia quando aplicar as atualizações, testar as alterações e lançar uma nova versão da sua aplicação.
Quer Adicionar Videoporteiro à Sua Aplicação?
Envie um e-mail para a equipa de integrações da BAS-IP para [email protected] ou envie um pedido através do formulário de contacto.
Não precisa de preparar uma especificação técnica detalhada antes de entrar em contacto. Uma breve descrição da sua aplicação e da funcionalidade necessária é suficiente.
Por exemplo:
“Temos uma aplicação para moradores para iOS e Android. Queremos que os moradores recebam videochamadas dos painéis de entrada BAS-IP e abram a porta durante uma chamada.”
Ou:
“Queremos adicionar acesso móvel via Bluetooth. Planeamos adquirir credenciais UKEY e emitir códigos QR de ativação para os moradores.”
Se o equipamento e a configuração do BAS-IP Link já tiverem sido definidos, inclua esses detalhes.
Isto ajudará a discussão a avançar mais rapidamente. A equipa da BAS-IP pode aconselhar sobre quais os componentes necessários, que infraestrutura pode ser exigida e como obter o SDK.