BAS-IP Mobile SDK: Kendi Mobil Uygulamanıza Görüntülü Diafon Özelliğini Nasıl Eklersiniz?
Bir konut projesi, site yönetim şirketi veya PropTech platformu halihazırda kendi mobil uygulamasına sahip olabilir. Sakinler bu uygulamayı fatura ödemek, toplantı odası rezerve etmek, bakım talepleri oluşturmak ve bildirim almak için kullanır. Ardından binaya bir görüntülü diafon (interkom) sistemi kurulur ve sakinlerden sırf bina girişinden gelen çağrıyı yanıtlamak için başka bir uygulama daha indirmeleri istenir.
BAS-IP Mobile SDK, ikinci bir uygulamaya duyulan ihtiyacı ortadan kaldırır. Görüntülü çağrılar, kapı açma ve mobil geçiş kontrolü, sakinlerin zaten kullandığı uygulamaya entegre edilebilir. İş ortağının geliştirici ekibi, hazır BAS-IP bileşenleriyle çalışır ve arayüzü kendi ürününe uyarlar.
BAS-IP’nin mevcut bina sistemleriyle entegrasyonuna ilişkin genel bakış yazımızda mevcut yaklaşımları ele almıştık: standart protokoller, Link API, Mobile SDK ve Device API. Burada ise mobil entegrasyona odaklanıyoruz: SDK’nın neler yapabileceği, nelerin hazırlanması gerektiği ve sınırlarının neler olduğu.
Bir Site Sakininin Hayatından Bir Gün
Mobile SDK’yı açıklamanın en kolay yolu, BAS-IP ile donatılmış bir binada yaşayan birinin sıradan bir gününe bakmaktır.
Site sakini iş yerindeyken, bir kurye bina giriş panelinden zil çalar. Sakin daha çağrıyı yanıtlamadan telefon ekranında kameradan gelen görüntü belirir. Sakin paketi görür, çağrıyı yanıtlar ve kapıyı açar.
Akşam olduğunda sakin eve döner ve bina giriş kapısını Bluetooth üzerinden açmak için akıllı telefonunu kullanır. Uygulamada bir UKEY mobil kimlik kartı önceden etkinleştirilmiştir.
Biraz sonra bina ana giriş kapısı çarparak kapanır; sakinin çocuğunun okuldan eve dönmüş olma vakti gelmiştir. Sakin, herhangi bir çağrı olmaksızın girişte kimin olduğunu görmek için giriş kamerasını kendisi açar.
Tüm bunlar tek bir uygulamada gerçekleşir. Sakinin o sabah fatura ödemek için kullandığı aynı uygulamada.
Mobile SDK, bu işlemlerin her biri için gereken bileşenleri sağlar. Şimdi bunların nasıl çalıştığına ve geliştirici ekibin neleri hazırlaması gerektiğine bakalım.
BAS-IP Mobile SDK Neleri İçerir?
BAS-IP Mobile SDK, mobil geliştiriciler için kütüphaneler, teknik dokümantasyon ve kod örnekleri sunar. BAS-IP Link ile çalışır ve hem iOS hem de Android’i destekler.
SDK, bir uygulamanın şunları yapmasını sağlar:
- kullanıcıları kaydetmek ve kimliklerini doğrulamak;
- kullanıcı profillerini ve erişilebilir cihaz listelerini almak;
- diafon çağrılarını almak ve yapmak;
- ses ve görüntü iletmek;
- bir çağrı yanıtlanmadan önce giriş panelinden gelen görüntüyü göstermek;
- gelen bir çağrı olmadan giriş panelinin kamerasını görüntülemek;
- kapıları uzaktan açmak;
- gelen ve giden çağrı geçmişini görüntülemek;
- akıllı telefonu bir Bluetooth mobil kimlik kartı (anahtar) olarak kullanmak;
- sahada gerekli ekipman kurulu olduğunda asansör çağırmak.
İş ortakları ihtiyaç duydukları bileşenleri seçebilir ve bu işlevlerin kendi uygulamalarında nasıl görüneceğine karar verebilir.
Üç Bileşen: Core, Calls ve UKEY
Core, uygulamayı BAS-IP Link’e bağlar. Sakinlerin oturum açmasını, şifre kurtarmayı, kullanıcı profillerinin ve erişilebilir cihazların alınmasını yönetir. Ayrıca çağrı başlatmak, kapıları açmak, çağrı geçmişini görüntülemek ve asansör çağırmak için gereken işlevselliği sağlar.
Calls, gelen ve giden çağrılar, ses ve görüntü iletimi ile çağrı yönetimi dahil olmak üzere diafon iletişimini yürütür. SDK; gelen bir çağrının alınması, uygulamanın yanıtlamaya hazır hale gelmesi, çağrının sona ermesi ve görüşmeyi hangi tarafın sonlandırdığı gibi çağrı durumlarını yönetir. iOS’te sistem düzeyinde çağrı yönetimi için CallKit kullanılır.
UKEY, bir akıllı telefonu mobil anahtara dönüştürür. Sakin bir QR kodu tarar ve bu işlem uygulamada bir mobil kimlik kartını etkinleştirir. Ardından telefon, uyumlu bir BAS-IP okuyucu aracılığıyla Bluetooth üzerinden kapı açmak için kullanılabilir.
Uygulamanın nasıl kurgulandığına bağlı olarak, ayrı bir düğmeye basmaya gerek kalmadan geçiş sağlanabilir. Örneğin kapı açma işlemi, sakin okuyucunun yakınında telefonunun kilidini açtığında tetiklenebilir. Ancak kilitli bir telefonla sadece okuyucuya yaklaşarak kapının tamamen otomatik olarak açılması standart bir SDK özelliği değildir.
QR kodu, telefondaki kimlik kartını etkinleştirmek için bir kez kullanılır. Bir kuryenin binaya girmek için kullanabileceği ziyaretçi QR koduyla hiçbir ilgisi yoktur.
Gelen Çağrı Telefona Nasıl Ulaşır?
Mobil uygulama arka planda çalışırken veya telefon kilitliyken, gelen çağrıları iletmek için anlık bildirimler (push notifications) kullanılır. Bu bildirimler, sakin uygulamayı açmamış olsa bile uygulamanın etkinleştirilmesini ve çağrıyı almaya hazırlanmasını sağlar.
Süreç şu şekilde işler:
- Bir ziyaretçi BAS-IP giriş panelindeki çağrı düğmesine basar.
- Çağrı BAS-IP Link sunucusuna ulaşır.
- Push sunucusu sakinin akıllı telefonuna bir bildirim gönderir.
- Uygulama etkinleştirilir ve çağrıyı almaya hazırlanır.
- Sakin gelen çağrıyı alır ve yanıtlayabilir.
Gelen çağrıları almak için bir push altyapısı gerekir. Bu altyapı, Android için Firebase Cloud Messaging (FCM) ve iOS için Apple Push Notification service (APNs) ile iletişim kuran bir anlık bildirim sunucusunu içerir.
Proje mimarisine bağlı olarak push sunucusu iş ortağı tarafından kurulabilir veya BAS-IP tarafından sağlanabilir. Uygun düzenleme entegrasyon planlaması sırasında kararlaştırılır.
Uygulama çağrı işlevi gerektirmiyorsa bir push sunucusuna ihtiyaç duyulmaz. Ancak SDK yalnızca Link ile çalıştığından, her durumda bir BAS-IP Link sunucusu gereklidir.
Sizin Uygulamanız, Sizin Arayüzünüz
BAS-IP, SDK ile birlikte örnek ekranlar ve simgeler sunar, ancak iş ortakları bunları kullanmak zorunda değildir. Düğmeler, çağrı ekranları, navigasyon ve renkler mevcut uygulamayla uyumlu olacak şekilde tasarlanabilir.
Sakinler için görüntülü diafon, ayrı bir tedarikçi markalı hizmet olmaktan çıkarak kendi mülk yönetim uygulamalarının doğal bir parçası haline gelir.
Tek Daire İçin Birden Fazla Telefon
Bir kurye bir dairenin zil düğmesine basar ve hem annenin hem de babanın telefonu çalar. İlk yanıtlayan kişi çağrıyı alır, diğer telefondaki gelen çağrı ise çalmayı durdurur.
Çağrılar, ağ koşullarına ve her cihazın durumuna bağlı olarak farklı telefonlara birkaç saniye arayla ulaşabilir.
Alıcı listesi BAS-IP Link’teki çağrı yönlendirme ayarlarıyla belirlenir. Buradaki önemli nokta, bir dairenin diafon sisteminin yalnızca tek bir sakinin telefonuna bağlı olmak zorunda olmamasıdır.
Yanıtlamadan Önce ve Gelen Çağrı Olmadan Görüntü İzleme
Giriş panelinden gelen görüntü, sakin çağrıyı yanıtlamadan önce gösterilebilir. Sakinler girişte kimin olduğunu görebilir ve ardından yanıtlayıp yanıtlamamaya karar verebilir.
İkinci bir senaryo daha vardır: Kimse zili çalmadığında bile giriş kamerasını izlemek.
Teknik olarak bu işlem yine panelle bir bağlantı kurulmasını içerir. Ancak sakinin bakış açısından bu, girişte kimin olduğunu görmek için bir düğmeye dokunmak kadar basit olabilir.
Sakinler Uygulamadan Kimleri Arayabilir?
Sakinler, BAS-IP Link üzerinden kendilerine sunulan cihazları arayabilir. Sahadaki yapılandırmaya bağlı olarak bunlar arasında bir giriş paneli, dairelerindeki bir iç monitör (iç ünite), resepsiyon/danışma veya güvenlik ekibi yer alabilir.
Yapamayacakları şey ise doğrudan başka bir mobil uygulamayı aramaktır. SDK, iki akıllı telefon arasında doğrudan uygulamadan uygulamaya (app-to-app) çağrıları desteklemez.
Uygulamanın kişi listesi ve arama işlevleri tasarlanırken bu sınırlama göz önünde bulundurulmalıdır.
Çağrı Geçmişi ve Kapı Açma
Uygulama; gelen ve giden çağrıları, tarih ve saati, kimin aradığını veya arandığını ve bir çağrının yanıtlanıp yanıtlanmadığını veya cevapsız kaldığını gösteren bir çağrı geçmişi sunabilir.
Örneğin bir sakin, toplu taşıma araçlarında seyahat ederken birinin arayıp aramadığını kontrol edebilir.
İş ortağı, kapı açma düğmesini çağrı ekranında mantıklı gördüğü herhangi bir yere yerleştirebilir. SDK, BAS-IP ekipmanıyla gerekli iletişimi kendisi yönetir; böylece geliştiricilerin kapı açma komutu mekanizmasını sıfırdan yazmasına gerek kalmaz.
Asansör Kontrolü
Asansör çağırma işlevi iki koşul karşılandığında çalışır: sahada bir BAS-IP asansör modülü kurulmuş ve yapılandırılmış olmalı ve sakin gerekli erişim haklarına sahip olmalıdır.
SDK, bir BAS-IP asansör modülü olmadan asansör sistemini doğrudan kontrol edemez. Gerekli ekipman, uyumluluk ve yapılandırma proje tasarımı sırasında teyit edilmelidir.
Diafon İletişimini Sıfırdan Geliştirmek Yerine Neden Mobile SDK Kullanılmalı?
Bir şirket, mobil uygulaması için kendi görüntülü diafon işlevini geliştirebilir. Ancak bu durumda ekibinin; gelen ve giden çağrıları, anlık bildirimleri, arka planda çalışmayı, ses ve görüntü iletimini, çağrı yönetimini, kapı açmayı ve BAS-IP Link ile iletişimi kendisinin geliştirmesi gerekecektir.
Ayrıca iOS ve Android gelişmeye devam ettikçe bu işlevselliğin sürekli bakım ve güncellemeye ihtiyacı olacaktır.
BAS-IP Mobile SDK, bu görevler için hazır bileşenler sunar. İş ortağı; bileşenleri entegre etmekten, uygulama arayüzünü tasarlamaktan, gerekli altyapıyı hazırlamaktan ve çözümü test etmekten sorumlu olmaya devam eder, ancak tüm diafon iletişim sistemini sıfırdan inşa etmek zorunda kalmaz.
Bu durum, özellikle görüntülü diafonun çok daha büyük bir ürünün yalnızca tek bir özelliği olduğu PropTech platformları için oldukça değerlidir. Geliştirici ekip, diafon iletişimi için mevcut BAS-IP bileşenlerini kullanırken kendi ana platformuna odaklanabilir.
Pratik bir örnek için, bir gayrimenkul teknolojisi sağlayıcısının mevcut mobil uygulamasına BAS-IP diafon işlevlerini nasıl eklediğini anlatan Accrete entegrasyonu vaka çalışmasına (case study) göz atabilirsiniz.
Geliştirici Ekip Neler Alır?
Proje üzerinde anlaşmaya varıldıktan ve gizlilik sözleşmesi (NDA) imzalandıktan sonra, iş ortağının geliştirici ekibi gerekli BAS-IP Mobile SDK materyallerine erişim kazanır.
Bunlar arasında yazılım kütüphaneleri, teknik dokümantasyon ve kod örnekleri yer alır. Sağlanan materyallerin tam içeriği ve bunların nasıl sunulacağı, projenin teknik yapılandırmasına ve gereksinimlerine bağlıdır.
Gerekli kütüphane ve dokümantasyon güncellemeleri, entegrasyona yönelik teknik desteğin bir parçası olarak sağlanır. İş ortağının ekibi, kullanılan bileşenleri ne zaman güncelleyeceğine ve uygulamasının yeni bir sürümünü ne zaman yayınlayacağına kendisi karar verir.
İş Ortağının Sorumluluğunda Neler Kalır?
İş ortağı; SDK kütüphanelerini entegre etmekten, kullanıcı arayüzünü ve uygulama mantığını geliştirmekten, test süreçlerinden, uygulamayı App Store ve Google Play’de yayınlamaktan ve sürekli bakım sağlamaktan sorumludur.
Push altyapısı gereksinimleri ve kurulum sorumluluğu her proje için ayrı ayrı kararlaştırılır.
BAS-IP; SDK’yı, dokümantasyonu ve kod örneklerini sağlar ve kendi bileşenleriyle ilgili teknik soruları yanıtlar.
Üçüncü taraf Mobile SDK entegrasyonları şu anda BAS-IP Link Self-Hosted sürümünü kullanmaktadır. Bir projenin Link Cloud üzerinde çalışması planlanıyorsa, önerilen mimari geliştirme başlamadan önce BAS-IP ile görüşülmelidir.
Mobile SDK’ya Neler Dahil Değildir?
Mobile SDK, BAS-IP Link uygulamasının her özelliğini birebir kopyalamaz. Örneğin, standart Link uygulamasında her iki özellik de mevcut olmasına rağmen, misafir QR kodu oluşturma veya sosyal tesis/alan rezervasyonu (amenity booking) özelliklerini içermez.
Misafir QR kodu oluşturma ve sosyal alan rezervasyonu BAS-IP Link API aracılığıyla sunulmaktadır. İş ortağının kendi mobil uygulamasında bu işlevlere ihtiyaç duyulursa, bunlar BAS-IP Link ile yapılacak ek bir entegrasyon üzerinden uygulanabilir.
Her iki araç da aynı proje içinde birlikte kullanılabilir. Platformun arka ucu (back-end) Link API aracılığıyla sakinleri ve erişim izinlerini yönetirken, mobil uygulama diafon çağrılarını almak ve kapıları açmak için Mobile SDK’yı kullanır.
Sunucu taraflı (server-side) entegrasyon senaryoları BAS-IP Link API makalemizde daha ayrıntılı olarak ele alınmaktadır. Geliştirmeye başlamadan önce, gerekli tüm senaryoları listelemek ve her birini hangi entegrasyon aracının yürüteceğine karar vermek faydalı olacaktır.
BAS-IP Mobile SDK’nın Maliyeti Nedir?
Varsayılan olarak BAS-IP; Mobile SDK’ya, dokümantasyonuna veya entegrasyon sırasındaki teknik desteğe erişim için ayrı bir ücret talep etmez.
BAS-IP Link ve diğer ürünler standart koşulları kapsamında lisanslanmaya devam ederken, UKEY mobil kimlik kartları BAS-IP’den veya distribütörlerinden ayrı olarak satın alınır.
Bir projenin BAS-IP tarafından ek geliştirme yapılmasını veya geliştirme önceliklerinde değişiklik yapılmasını gerektirmesi durumunda, ticari koşullar ayrıca kararlaştırılır.
Proje bütçesinde iş ortağının kendi geliştirme çalışmaları, altyapısı, test süreçleri ve devam eden uygulama bakımı da hesaba katılmalıdır.
Sıkça Sorulan Sorular (SSS)
Hangi iOS ve Android Sürümleri Destekleniyor?
Mevcut minimum desteklenen sürümler SDK teknik dokümantasyonunda belirtilmiştir. Mobil işletim sistemleri geliştiğinde gereksinimler de değişir; bu nedenle geliştiriciler entegrasyona başlamadan önce ve kütüphaneler her güncellendiğinde bunları kontrol etmelidir.
Herkese Açık Bir Test Ortamı (Public Sandbox) Var mı?
Paylaşılan herkese açık bir test ortamı (sandbox) bulunmamaktadır. BAS-IP Link Self-Hosted ile iş ortağı, Link’i kendi ortamına kurar ve geliştirme için bu kurulumu kullanır. Test lisansı ve donanım düzenlemeleri her projenin gereksinimlerine göre kararlaştırılır.
SDK Güncellemeleri Nasıl Sağlanır?
Gerekli SDK güncellemeleri, entegrasyona yönelik teknik desteğin bir parçası olarak sağlanır. İş ortağının geliştirici ekibi; güncellemeleri ne zaman uygulayacağını, değişiklikleri ne zaman test edeceğini ve uygulamasının yeni bir sürümünü ne zaman yayınlayacağını kendisi planlar.
Uygulamanıza Görüntülü Diafon Özelliği Eklemek İster misiniz?
[email protected] adresinden BAS-IP entegrasyon ekibine e-posta gönderin veya iletişim formu aracılığıyla bir talep iletin.
İletişime geçmeden önce ayrıntılı bir teknik şartname hazırlamanıza gerek yoktur. Uygulamanızın ve ihtiyaç duyulan işlevlerin kısa bir açıklaması yeterlidir.
Örneğin:
“iOS ve Android için bir site sakini uygulamamız var. Sakinlerin BAS-IP giriş panellerinden görüntülü çağrı almasını ve çağrı sırasında kapıyı açabilmesini istiyoruz.”
Veya:
“Bluetooth mobil geçiş özelliği eklemek istiyoruz. UKEY kimlik kartları satın almayı ve sakinlere aktivasyon QR kodları vermeyi planlıyoruz.”
Ekipman ve BAS-IP Link yapılandırması halihazırda belirlenmişse bu ayrıntıları da ekleyin.
Bu bilgiler, görüşmenin daha hızlı ilerlemesine yardımcı olacaktır. BAS-IP ekibi hangi bileşenlere ihtiyaç duyulduğu, hangi altyapının gerekebileceği ve SDK’nın nasıl temin edileceği konusunda danışmanlık sağlayabilir.