Scan Devices aksiyonu, Kuika ile geliştirilen bir mobil uygulamada cihazın yakınındaki Bluetooth cihazlarını taramak ve bu cihazların listesini almak için kullanılır. Bu sayede kullanıcı, yakındaki eşleşmeye açık cihazları görebilir ve istediği cihaza kolayca bağlanabilir.

Teknik Özellikler

Yakın Cihaz Tespiti: Bluetooth açık durumdayken çevredeki eşleşmeye uygun cihazları listeler.
Hizmet Bazlı Filtreleme: Belirli Service ID bilgisine sahip cihazlar için filtreleme yapılabilir.
Cihaz Seçimi ve Bağlantı Akışı: Kullanıcılar tarama sonucu gelen cihaz listesinden bir cihaz seçerek doğrudan bağlantı kurabilir.
Kullanıcı Bildirimi: Bağlantı esnasında kullanıcıya bilgi mesajı gösterilebilir.
Mobil Uyumluluk: Aksiyon sadece Android ve iOS tabanlı Kuika mobil projelerinde çalışır.

Scan Devices Aksiyonu Uygulama Adımları

1. Bluetooth Veri Kaynağı Ekleme

Kuika platformuna giriş yapın.
Apps ekranından mobil projenizi açın.
Datasources modülüne gidin.
Solda yer alan + ikonu aracılığıyla yeni veri kaynağı ekleme ekranını açın. Ardından Datasource Tipi olarak Bluetooth seçimini yapın.

Gerekli alanları girin:

Device Name (zorunlu)
Device ID, Device Address (opsiyonel)

CREATE butonuna tıklayın.

2. Bluetooth Metodu Tanımlama

Oluşturduğunuz veri kaynağını açın → ADD NEW METHOD butonuna tıklayın.
Gerekli alanları girin:
- Name
- Characteristic ID
- Service ID
- Characteristic Type: Read, Write, Notify, Indicate
SAVE ile kaydedin.

3. Scan Devices Aksiyonunu Ekleme

Oluşturduğunuz metoda tıklayın.
Sağ panelde +ADD ACTION → Custom → Kuika → ScanDevices_bluetooth seçin.

Parametre Tanımları

Zorunlu Parametre:

executePageInitActionAfterClose (Boolean):
- true olarak ayarlandığında, cihaz tarama penceresi kapatıldıktan sonra sayfa init aksiyonları otomatik olarak yeniden tetiklenir.

Opsiyonel Parametreler:

serviceIds (Array of UUIDs):
- Yalnızca belirli Service ID’lere sahip Bluetooth cihazlarını tarar. Örn: ["0000180d-0000-1000-8000-00805f9b34fb"] (Heart Rate Service)
connectingMessage (String):
- Bağlantı sırasında gösterilecek bilgi mesajı. Örn: "Cihaza bağlanılıyor, lütfen bekleyin..."

Kullanım Senaryosu: Cihaz Tarama Ekranı

Bir kullanıcı, uygulamadaki “Cihaz Ekle” ekranına geldiğinde, sistem çevredeki Bluetooth cihazlarını tarayarak kullanıcıya bir liste sunar. Kullanıcı, bu listeden bir cihaz seçerek bağlantı işlemini başlatabilir.

1. UI Design modülüne geçin.

“Cihaz Ara” ekranına bir Button elementi ekleyin.
Properties panelinden butonun adını “Tarama Başlat” olarak belirleyin.

2. Buton aksiyonu için + ADD ACTION menüsünden:

OnClick → Custom → Kuika → ScanDevices_bluetooth aksiyonunu ekleyin.

3. Aksiyon Parametrelerini ayarlayın:

executePageInitActionAfterClose = true
connectingMessage = "Bluetooth cihazları aranıyor..."
serviceIds = ["12345678-1234-1234-1234-1234567890ab"] (İlgili servis UUID’si)

4. (İsteğe bağlı) Cihaz seçildikten sonra bağlantı kurmak için:

ScanDevices aksiyonunun ardından gelen listede kullanıcı bir cihaz seçtiğinde:
→ Custom → Kuika → Connect_bluetooth aksiyonu tetiklenebilir.

Bu senaryo ile kullanıcı, tarama başlatıldığında cihazları liste şeklinde görebilir ve istediği cihazla kolayca bağlantı kurabilir. Kullanıcı deneyimini artırmak için seçilen cihaz adı gösterilebilir ya da bağlantı başarılı bildirimi eklenebilir.

Scan Devices Aksiyonu İleri Seviye Özelleştirmeler

Service Bazlı Cihaz Listesi: Farklı cihaz türlerini temsil eden Service ID’ler ile kullanıcıya yalnızca belirli türde cihazlar gösterilebilir.
Otomatik Seçim: Daha önce bağlanılmış cihaz SavedDeviceAvailable ile tespit edilir ve eğer yakındaysa Scan Devices yerine doğrudan bağlantı denenebilir.
İşlem Sonrası Sayfa Yenileme: executePageInitActionAfterClose = true parametresi ile tarama sonrası sayfa verileri otomatik yenilenebilir.
Tarama Zamanlayıcısı: Kullanıcı belirli süre içinde cihaz bulamazsa otomatik olarak yeniden tarama başlatılabilir.

Teknik Riskler ve Önlemler

Bluetooth Kapalıysa: Tarama yapılmaz, Bluetooth Is Open aksiyonu ile ön kontrol yapılmalıdır.
İzin Sorunu: Bluetooth Permission Is Given ile kullanıcıdan izin alınmadıysa tarama yapılamaz.
Cihaz Yoğunluğu: Aynı anda çok sayıda cihaz listelenirse, performans etkilenebilir. Listeye sınırlama getirilebilir.
Kullanıcı Etkileşimi: Kullanıcı cihaz seçmeden tarama penceresinden çıkarsa sonraki adımlar kontrol edilmelidir.
UUID Uyumsuzluğu: serviceIds UUID'leri doğru formatta tanımlanmazsa tarama başarısız olur.

Scan Devices, kullanıcıların yakındaki Bluetooth cihazlarını hızlı bir şekilde tespit etmelerini ve uygun cihaza bağlantı kurmalarını sağlayan güçlü bir aksiyondur. Özellikle tıbbi cihazlar, akıllı ev uygulamaları ve IoT projelerinde kullanıcı deneyimini ciddi anlamda kolaylaştırmak için kullanılabilir. Gelişmiş özelleştirme ve entegrasyon seçenekleriyle sisteminize tam uyum sağlar.