BAS-IP Mobile SDK: Cách Tích Hợp Chuông Cửa Có Hình Vào Ứng Dụng Di Động Của Riêng Bạn
Một khu dân cư, công ty quản lý bất động sản hoặc nền tảng PropTech có thể đã sở hữu ứng dụng di động riêng. Cư dân sử dụng ứng dụng đó để thanh toán hóa đơn, đặt phòng họp, gửi yêu cầu bảo trì và nhận thông báo. Sau đó, hệ thống chuông cửa có hình (video intercom) được lắp đặt và cư dân lại được yêu cầu tải thêm một ứng dụng khác chỉ để trả lời cuộc gọi từ sảnh vào.
BAS-IP Mobile SDK loại bỏ sự cần thiết của ứng dụng thứ hai. Các tính năng gọi video, mở cửa và truy cập bằng điện thoại di động có thể được tích hợp ngay vào ứng dụng mà cư dân đang sử dụng. Đội ngũ phát triển của đối tác làm việc với các thành phần BAS-IP có sẵn và tùy chỉnh giao diện cho phù hợp với sản phẩm của mình.
Trong bài tổng quan về việc tích hợp BAS-IP với các hệ thống tòa nhà hiện có, chúng tôi đã đề cập đến các phương pháp hiện hành: giao thức tiêu chuẩn, Link API, Mobile SDK và Device API. Tại đây, chúng tôi tập trung vào tích hợp di động: SDK có thể làm được gì, cần chuẩn bị những gì và các giới hạn của nó nằm ở đâu.
Một Ngày Trong Cuộc Sống Của Cư Dân
Cách dễ nhất để giải thích về Mobile SDK là hình dung một ngày bình thường của một người sống trong tòa nhà được trang bị hệ thống BAS-IP.
Khi cư dân đang ở nơi làm việc, nhân viên giao hàng bấm gọi từ bảng gọi cửa ở sảnh. Điện thoại hiển thị video từ camera ngay cả trước khi cư dân bắt máy. Họ nhìn thấy kiện hàng, trả lời cuộc gọi và mở cửa.
Buổi tối, cư dân trở về nhà và dùng điện thoại thông minh để mở cửa sảnh qua Bluetooth. Thẻ định danh di động UKEY đã được kích hoạt sẵn trong ứng dụng.
Một lát sau, cửa chính đóng sập lại, và lẽ ra giờ này con của cư dân đã phải đi học về. Cư dân tự mở camera sảnh mà không cần có cuộc gọi nào để xem ai đang ở lối vào.
Tất cả những việc này đều diễn ra trong cùng một ứng dụng. Chính là ứng dụng mà cư dân đã dùng để thanh toán hóa đơn vào sáng hôm đó.
Mobile SDK cung cấp các thành phần cần thiết cho từng thao tác kể trên. Hãy cùng xem cách chúng hoạt động và những gì đội ngũ phát triển cần chuẩn bị.
BAS-IP Mobile SDK Bao Gồm Những Gì?
BAS-IP Mobile SDK cung cấp các thư viện, tài liệu kỹ thuật và ví dụ mã nguồn (code examples) cho các nhà phát triển di động. Bộ công cụ này hoạt động với BAS-IP Link và hỗ trợ cả iOS lẫn Android.
SDK cho phép ứng dụng:
- đăng ký và xác thực người dùng;
- truy xuất hồ sơ người dùng và danh sách các thiết bị được phép truy cập;
- nhận và thực hiện các cuộc gọi chuông cửa;
- truyền tải âm thanh và video;
- hiển thị video từ bảng gọi cửa trước khi trả lời cuộc gọi;
- xem camera của bảng gọi cửa mà không cần có cuộc gọi đến;
- mở cửa từ xa;
- hiển thị lịch sử cuộc gọi đến và đi;
- sử dụng điện thoại thông minh làm thẻ định danh di động qua Bluetooth;
- gọi thang máy khi thiết bị cần thiết được lắp đặt tại công trình.
Các đối tác có thể lựa chọn những thành phần họ cần và quyết định cách các chức năng đó hiển thị trong ứng dụng của mình.
Ba Thành Phần: Core, Calls và UKEY
Core kết nối ứng dụng với BAS-IP Link. Thành phần này xử lý việc đăng nhập của cư dân, khôi phục mật khẩu cũng như truy xuất hồ sơ người dùng và các thiết bị khả dụng. Nó cũng cung cấp chức năng cần thiết để khởi tạo cuộc gọi, mở cửa, hiển thị lịch sử cuộc gọi và gọi thang máy.
Calls xử lý giao tiếp chuông cửa, bao gồm các cuộc gọi đến và đi, truyền tải âm thanh và video, cũng như quản lý cuộc gọi. SDK quản lý các trạng thái cuộc gọi, chẳng hạn như khi nhận được cuộc gọi đến, khi ứng dụng sẵn sàng trả lời, khi cuộc gọi kết thúc và bên nào đã ngắt cuộc trò chuyện. Trên iOS, CallKit được sử dụng để xử lý cuộc gọi ở cấp độ hệ thống.
UKEY biến điện thoại thông minh thành chìa khóa di động. Cư dân quét mã QR để kích hoạt thẻ định danh di động trong ứng dụng. Sau đó, điện thoại có thể được sử dụng để mở cửa qua Bluetooth thông qua đầu đọc BAS-IP tương thích.
Tùy thuộc vào cách triển khai ứng dụng, việc mở cửa có thể được thiết lập mà không cần nhấn nút riêng biệt. Ví dụ: tính năng mở cửa có thể được kích hoạt khi cư dân mở khóa điện thoại ở gần đầu đọc. Tuy nhiên, việc tự động mở khóa cửa hoàn toàn chỉ bằng cách tiến lại gần với một chiếc điện thoại đang khóa màn hình không phải là tính năng tiêu chuẩn của SDK.
Mã QR chỉ được sử dụng một lần để kích hoạt thẻ định danh trên điện thoại. Mã này không liên quan đến mã QR dành cho khách mà nhân viên giao hàng có thể dùng để vào tòa nhà.
Cuộc Gọi Đến Được Chuyển Tới Điện Thoại Như Thế Nào?
Khi ứng dụng di động đang chạy ngầm hoặc điện thoại bị khóa, thông báo đẩy (push notifications) sẽ được sử dụng để chuyển các cuộc gọi đến. Chúng cho phép kích hoạt ứng dụng và chuẩn bị nhận cuộc gọi ngay cả khi cư dân chưa mở ứng dụng.
Quy trình hoạt động như sau:
- Khách nhấn nút gọi trên bảng gọi cửa BAS-IP.
- Cuộc gọi được chuyển đến máy chủ BAS-IP Link.
- Máy chủ push gửi thông báo đến điện thoại thông minh của cư dân.
- Ứng dụng được kích hoạt và chuẩn bị nhận cuộc gọi.
- Cư dân nhận cuộc gọi đến và có thể trả lời.
Việc nhận cuộc gọi đến đòi hỏi phải có hạ tầng push. Hạ tầng này bao gồm một máy chủ thông báo đẩy giao tiếp với Firebase Cloud Messaging (FCM) cho Android và Apple Push Notification service (APNs) cho iOS.
Tùy thuộc vào kiến trúc dự án, máy chủ push có thể do đối tác tự triển khai hoặc do BAS-IP cung cấp. Phương án phù hợp sẽ được thống nhất trong quá trình lập kế hoạch tích hợp.
Nếu ứng dụng không yêu cầu tính năng gọi điện, thì không cần đến máy chủ push. Máy chủ BAS-IP Link luôn bắt buộc phải có trong mọi trường hợp, vì SDK chỉ hoạt động với Link.
Ứng Dụng Của Bạn, Giao Diện Của Bạn
BAS-IP cung cấp các màn hình mẫu và biểu tượng kèm theo SDK, nhưng đối tác không bắt buộc phải sử dụng chúng. Các nút bấm, màn hình cuộc gọi, thanh điều hướng và màu sắc đều có thể được thiết kế để đồng bộ với ứng dụng hiện có.
Đối với cư dân, tính năng chuông cửa có hình trở thành một phần tự nhiên trong ứng dụng quản lý tòa nhà của họ chứ không phải là một dịch vụ riêng lẻ mang thương hiệu của nhà cung cấp khác.
Nhiều Điện Thoại Cho Một Căn Hộ
Nhân viên giao hàng nhấn nút gọi cho một căn hộ, và điện thoại của cả bố lẫn mẹ đều đổ chuông. Người đầu tiên bắt máy sẽ nhận cuộc gọi, trong khi điện thoại kia sẽ ngừng đổ chuông.
Cuộc gọi có thể đến các điện thoại khác nhau lệch nhau vài giây, tùy thuộc vào điều kiện mạng và trạng thái của từng thiết bị.
Danh sách người nhận được xác định bởi cài đặt chuyển tiếp cuộc gọi trong BAS-IP Link. Điểm quan trọng là hệ thống chuông cửa của một căn hộ không nhất thiết phải gắn cố định với điện thoại của một cư dân duy nhất.
Xem Video Trước Khi Trả Lời Và Khi Không Có Cuộc Gọi Đến
Video từ bảng gọi cửa có thể được hiển thị trước khi cư dân trả lời cuộc gọi. Họ có thể nhìn xem ai đang ở cửa rồi mới quyết định có bắt máy hay không.
Ngoài ra còn có kịch bản thứ hai: xem camera sảnh vào ngay cả khi không có ai gọi.
Về mặt kỹ thuật, thao tác này vẫn bao gồm việc thiết lập kết nối với bảng gọi cửa. Tuy nhiên, từ góc độ của cư dân, việc này có thể đơn giản chỉ là chạm vào một nút bấm để xem ai đang ở lối vào.
Cư Dân Có Thể Gọi Cho Ai Từ Ứng Dụng?
Cư dân có thể gọi đến các thiết bị khả dụng với họ thông qua BAS-IP Link. Tùy thuộc vào cấu hình tại công trình, các thiết bị này có thể bao gồm bảng gọi cửa, màn hình trong căn hộ, quầy lễ tân hoặc đội ngũ an ninh.
Điều họ không thể làm là gọi trực tiếp đến một ứng dụng di động khác. SDK không hỗ trợ các cuộc gọi trực tiếp từ ứng dụng sang ứng dụng (app-to-app) giữa hai điện thoại thông minh.
Cần lưu ý giới hạn này khi thiết kế danh bạ và các chức năng gọi điện của ứng dụng.
Lịch Sử Cuộc Gọi Và Mở Cửa
Ứng dụng có thể hiển thị lịch sử cuộc gọi bao gồm các cuộc gọi đến và đi, ngày giờ, người gọi hoặc người nhận cuộc gọi, cũng như trạng thái cuộc gọi đã được trả lời hay bị nhỡ.
Ví dụ: cư dân có thể kiểm tra xem có ai gọi trong lúc họ đang di chuyển trên phương tiện giao thông công cộng hay không.
Đối tác có thể đặt nút mở cửa ở bất kỳ vị trí nào hợp lý trên màn hình cuộc gọi. SDK sẽ xử lý việc giao tiếp cần thiết với thiết bị BAS-IP, vì vậy các nhà phát triển không phải tự xây dựng cơ chế lệnh mở cửa.
Điều Khiển Thang Máy
Chức năng gọi thang máy hoạt động khi đáp ứng đủ hai điều kiện: mô-đun thang máy BAS-IP đã được lắp đặt và cấu hình tại công trình, đồng thời cư dân có quyền truy cập cần thiết.
SDK không thể điều khiển trực tiếp hệ thống thang máy nếu không có mô-đun thang máy BAS-IP. Thiết bị cần thiết, khả năng tương thích và cấu hình phải được xác nhận trong giai đoạn thiết kế dự án.
Tại Sao Nên Sử Dụng Mobile SDK Thay Vì Tự Phát Triển Hệ Thống Giao Tiếp Chuông Cửa Từ Đầu?
Một công ty có thể tự phát triển tính năng chuông cửa có hình cho ứng dụng di động của mình. Tuy nhiên, khi đó đội ngũ của họ sẽ phải tự triển khai các cuộc gọi đến và đi, thông báo đẩy, chế độ chạy ngầm, truyền tải âm thanh và video, quản lý cuộc gọi, mở cửa cũng như giao tiếp với BAS-IP Link.
Chức năng đó cũng sẽ cần được bảo trì liên tục khi iOS và Android cập nhật phiên bản mới.
BAS-IP Mobile SDK cung cấp các thành phần dựng sẵn cho những tác vụ này. Đối tác vẫn chịu trách nhiệm tích hợp các thành phần, thiết kế giao diện ứng dụng, chuẩn bị hạ tầng cần thiết và kiểm thử giải pháp, nhưng không cần phải xây dựng toàn bộ hệ thống giao tiếp chuông cửa từ con số không.
Điều này đặc biệt có giá trị đối với các nền tảng PropTech, nơi tính năng chuông cửa có hình chỉ là một phần nhỏ trong một sản phẩm lớn hơn rất nhiều. Đội ngũ phát triển có thể tập trung vào nền tảng cốt lõi của mình trong khi sử dụng các thành phần BAS-IP sẵn có cho việc giao tiếp chuông cửa.
Để xem ví dụ thực tế, hãy tham khảo nghiên cứu tình huống (case study) tích hợp của Accrete, mô tả cách một nhà cung cấp công nghệ bất động sản đã bổ sung các chức năng chuông cửa BAS-IP vào ứng dụng di động hiện có của họ.
Đội Ngũ Phát Triển Nhận Được Gì?
Sau khi dự án được thống nhất và thỏa thuận bảo mật (NDA) được ký kết, đội ngũ phát triển của đối tác sẽ nhận được quyền truy cập vào các tài liệu BAS-IP Mobile SDK cần thiết.
Các tài liệu này bao gồm thư viện phần mềm, tài liệu kỹ thuật và các ví dụ mã nguồn. Những tài liệu cụ thể được cung cấp và phương thức cung cấp sẽ phụ thuộc vào cấu hình kỹ thuật và yêu cầu của dự án.
Các bản cập nhật thư viện và tài liệu cần thiết được cung cấp như một phần của gói hỗ trợ kỹ thuật cho việc tích hợp. Đội ngũ của đối tác tự quyết định thời điểm cập nhật các thành phần đang sử dụng và phát hành phiên bản mới cho ứng dụng của mình.
Trách Nhiệm Của Đối Tác Là Gì?
Đối tác chịu trách nhiệm tích hợp các thư viện SDK, phát triển giao diện người dùng và logic ứng dụng, kiểm thử, phát hành ứng dụng lên App Store và Google Play, cũng như bảo trì định kỳ.
Các yêu cầu về hạ tầng push và trách nhiệm triển khai sẽ được thỏa thuận riêng cho từng dự án.
BAS-IP cung cấp SDK, tài liệu và ví dụ mã nguồn, đồng thời giải đáp các câu hỏi kỹ thuật liên quan đến các thành phần của mình.
Các dự án tích hợp Mobile SDK của bên thứ ba hiện đang sử dụng BAS-IP Link Self-Hosted. Nếu một dự án được lên kế hoạch cho Link Cloud, kiến trúc đề xuất cần được thảo luận với BAS-IP trước khi bắt đầu phát triển.
Những Gì Không Có Trong Mobile SDK?
Mobile SDK không sao chép toàn bộ mọi tính năng của ứng dụng BAS-IP Link. Ví dụ: nó không bao gồm tính năng tạo mã QR cho khách hoặc đặt chỗ tiện ích (amenity booking), mặc dù cả hai tính năng này đều có sẵn trong ứng dụng Link tiêu chuẩn.
Tính năng tạo mã QR cho khách và đặt chỗ tiện ích được cung cấp thông qua BAS-IP Link API. Nếu cần có các chức năng này trong ứng dụng di động riêng của đối tác, chúng có thể được triển khai thông qua việc tích hợp bổ sung với BAS-IP Link.
Cả hai công cụ có thể được sử dụng trong cùng một dự án. Hệ thống back-end của nền tảng quản lý cư dân và quyền truy cập của họ thông qua Link API, trong khi ứng dụng di động sử dụng Mobile SDK để nhận cuộc gọi chuông cửa và mở cửa.
Các kịch bản tích hợp phía máy chủ (server-side) được trình bày chi tiết hơn trong bài viết về BAS-IP Link API của chúng tôi. Trước khi bắt đầu phát triển, nên liệt kê tất cả các kịch bản cần thiết và quyết định công cụ tích hợp nào sẽ xử lý từng kịch bản đó.
Chi Phí Của BAS-IP Mobile SDK Là Bao Nhiêu?
Theo mặc định, BAS-IP không thu phí riêng cho việc truy cập vào Mobile SDK, tài liệu hoặc hỗ trợ kỹ thuật trong quá trình tích hợp.
BAS-IP Link và các sản phẩm khác vẫn được cấp phép theo các điều khoản tiêu chuẩn, trong khi thẻ định danh di động UKEY được mua riêng từ BAS-IP hoặc các nhà phân phối của hãng.
Nếu một dự án yêu cầu BAS-IP phát triển bổ sung hoặc thay đổi mức độ ưu tiên phát triển, các điều khoản thương mại sẽ được thỏa thuận riêng.
Ngân sách dự án cũng cần tính đến công việc phát triển, cơ sở hạ tầng, kiểm thử và bảo trì ứng dụng lâu dài của chính đối tác.
Câu Hỏi Thường Gặp (FAQ)
Những Phiên Bản iOS Và Android Nào Được Hỗ Trợ?
Các phiên bản tối thiểu được hỗ trợ hiện tại được quy định rõ trong tài liệu kỹ thuật của SDK. Các yêu cầu sẽ thay đổi khi hệ điều hành di động phát triển, vì vậy các nhà phát triển nên kiểm tra thông tin này trước khi bắt đầu tích hợp và mỗi khi cập nhật thư viện.
Có Môi Trường Thử Nghiệm Công Khai (Public Sandbox) Không?
Không có môi trường sandbox công khai dùng chung. Với BAS-IP Link Self-Hosted, đối tác triển khai Link trong môi trường riêng của mình và sử dụng bản cài đặt đó để phát triển. Việc sắp xếp giấy phép thử nghiệm và phần cứng được thống nhất theo yêu cầu của từng dự án.
Các Bản Cập Nhật SDK Được Cung Cấp Như Thế Nào?
Các bản cập nhật SDK cần thiết được cung cấp như một phần của dịch vụ hỗ trợ kỹ thuật cho việc tích hợp. Đội ngũ phát triển của đối tác tự lên kế hoạch về thời điểm áp dụng các bản cập nhật, kiểm thử các thay đổi và phát hành phiên bản mới cho ứng dụng của mình.
Bạn Muốn Thêm Tính Năng Chuông Cửa Có Hình Vào Ứng Dụng Của Mình?
Hãy gửi email cho đội ngũ tích hợp của BAS-IP theo địa chỉ [email protected] hoặc gửi yêu cầu qua biểu mẫu liên hệ.
Bạn không cần phải chuẩn bị bản đặc tả kỹ thuật chi tiết trước khi liên hệ. Chỉ cần mô tả ngắn gọn về ứng dụng của bạn và các chức năng mong muốn là đủ.
Ví dụ:
“Chúng tôi có một ứng dụng dành cho cư dân trên iOS và Android. Chúng tôi muốn cư dân nhận được các cuộc gọi video từ bảng gọi cửa BAS-IP và mở cửa trong khi gọi.”
Hoặc:
“Chúng tôi muốn thêm tính năng mở cửa di động qua Bluetooth. Chúng tôi dự định mua thẻ định danh UKEY và cấp mã QR kích hoạt cho cư dân.”
Nếu thiết bị và cấu hình BAS-IP Link đã được xác định, hãy đính kèm những thông tin chi tiết đó.
Điều này sẽ giúp quá trình trao đổi diễn ra nhanh chóng hơn. Đội ngũ BAS-IP có thể tư vấn những thành phần nào là cần thiết, cơ sở hạ tầng nào có thể được yêu cầu và làm thế nào để nhận được bộ SDK.