Brave Image Search aksiyonu, Brave arama motoru üzerinden görselleri sorgulamak için kullanılır. Kullanıcıların belirledikleri arama terimlerine uygun görselleri çekerek uygulama içinde listelemeye veya görselleştirmeye imkân tanır. Özellikle medya, içerik üretimi, e-ticaret ve bilgi tabanlı uygulamalarda tercih edilir.

Teknik Özellikler

Arama İşlemi (Search Paneli): Brave Image Search aksiyonu, verilen sorguya uygun görselleri getirir. Dönen sonuçlar genellikle birden fazla görsel içerir ve liste şeklinde (Many) kullanılabilir.

Parametreler:

• settings (Object – zorunlu): Aramanın yapılacağı Brave API ayarlarıdır. Configuration Manager üzerinden tanımlanan Brave ayarları buradan seçilmelidir.
• query (String – zorunlu): Aranacak kelime veya ifade. (Ör. “sunset beach”, “modern office design”)
• count (Int32 – zorunlu): Kaç adet sonuç döndürüleceğini belirtir. Varsayılan olarak 0 verilirse sonuç dönmez, bu nedenle pozitif bir değer girilmelidir.

Veri Kaynağı Uyumluluğu: Tüm parametreler sabit (Fixed) değer olarak girilebileceği gibi, Symbol Picker aracılığıyla Form Input, Current, Action Result, Method Input gibi dinamik kaynaklardan da alınabilir.

Web & Mobil Destek: Brave Image Search aksiyonu hem web hem de mobil uygulamalarda çalışır.

Brave Image Search Uygulama Adımları

1. UI Design’da Aksiyon Tanımlama

• Kuika platformunda projenizi açın.
• UI Design modülüne geçin ve görsel aramanın yapılacağı ekranı seçin.
• Bir Text Input ve bir Button (ör. “Ara”) elementi ekleyin.
• Butona tıklayın, + ADD ACTION menüsünden OnClick → Brave Search → Brave Image Search aksiyonunu seçin.

2. Parametreleri Yapılandırma

• settings: Configuration Manager’da oluşturduğunuz Brave API ayarını seçin.
• query: Kullanıcının Text Input’a yazdığı değeri bağlayın (Symbol Picker → Components → Text Input).
• count: Döndürülecek sonuç sayısını belirleyin (örn. 10).

Kullanım Senaryosu: Görsel Arama Uygulaması

Bir içerik üretim uygulamasında, kullanıcı anahtar kelime yazar ve uygulama ona uygun görselleri listeler.

Adımlar:

1. UI Design’da:
   
   • “Arama Terimi” için bir Text Input.
   • “Ara” butonu.
   • Görsellerin listeleneceği bir GalleryView elementi. 
2. “Ara” butonuna OnClick → Brave Image Search aksiyonu ekleyin.
3. query parametresine Text Input bağlayın.
4. count parametresine 10 girin.
5. Dönen sonuçları GalleryView elementinde görüntüleyin. 

Brave Image Search İleri Seviye Özelleştirmeler

• Dinamik Sayı Belirleme: Kullanıcıya bir Number Input vererek kaç sonuç görmek istediğini seçtirebilirsiniz.
• Sonuçları Filtreleme: Dönen görsel URL’leri belirli formatlara göre filtrelenebilir (örn. sadece .jpg).
• Sonuçları Başka Aksiyonlara Aktarma: Elde edilen görseller Set Value aksiyonu ile başka ekranlara veya veritabanına kaydedilebilir.
• Koşullu Gösterim: Eğer sonuç bulunamazsa, kullanıcıya “Sonuç bulunamadı” mesajı gösterebilirsiniz.

Teknik Riskler ve Kontroller

• query boş olamaz. Zorunlu parametredir, boş bırakılırsa sonuç dönmez.
• count = 0 verilirse sonuç gelmez. 1 veya daha büyük bir sayı girilmelidir.
• settings doğru yapılandırılmalıdır. Configuration Manager’da Brave API ayarı yapılmadan aksiyon çalışmaz.
• Sonuç Formatı: Dönen sonuçlar JSON formatındadır, bu nedenle görüntülemek için URL alanlarının doğru bağlanması gerekir.