Brave Video Search aksiyonu, Brave arama motorunun video arama özelliğini kullanarak kullanıcıların belirli anahtar kelimelerle ilişkili videolara erişmesini sağlar. Arama sonucunda dönen videolar; başlık, açıklama, süre, kaynak ve bağlantı gibi bilgiler içerir. Özellikle medya, eğitim, e-ticaret ve içerik uygulamalarında tercih edilir.
Teknik Özellikler
Arama İşlemi (Search Paneli): Brave Video Search aksiyonu, verilen sorguya uygun videoları listeler. Dönen sonuçlar birden fazla öğe içerir ve liste (Many) formatında kullanılabilir.
Parametreler:
settings (Object – zorunlu): Brave API için gerekli ayarlardır. Configuration Manager üzerinden oluşturulan Brave ayarları bu alanda seçilmelidir.
query (String – zorunlu): Video aramasında kullanılacak anahtar kelime veya ifade. (Ör. “machine learning tutorial”, “football highlights”, “product review”).
count (Int32 – zorunlu): Döndürülecek video sayısını belirtir. 0 verilirse sonuç dönmez, minimum 1 veya daha büyük bir değer girilmelidir.
Veri Kaynağı Uyumluluğu: Tüm parametreler sabit (Fixed) olarak tanımlanabileceği gibi, Symbol Picker aracılığıyla Form Input, Current, Action Result, Method Input gibi dinamik kaynaklardan da alınabilir.
Web & Mobil Destek: Brave Video Search aksiyonu, hem web hem de mobil uygulamalarda sorunsuz şekilde çalışır.
Brave Video Search Uygulama Adımları
1. UI Design’da Aksiyon Tanımlama
Kuika projenizi açın.
UI Design modülünde video sonuçlarının gösterileceği sayfayı seçin.
Bir Text Input (arama kutusu) ve Button (ör. “Video Ara”) elementi ekleyin.
Butona tıklayın ve + ADD ACTION → Brave Search → Brave Video 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 girdiği arama terimini bağlayın.
count: Döndürülecek video sayısını belirleyin (örn. 10).
Kullanım Senaryosu: Eğitim Videoları Çekme
Bir e-öğrenme uygulamasında kullanıcı, “Python Tutorial” yazarak eğitim videolarını görmek ister.
Adımlar:
Text Input ekleyin (örn. “Anahtar Kelime”).
“Video Ara” butonu ekleyin.
OnClick → Brave Video Search aksiyonu tanımlayın.
Query alanına Text Input elementine bağlayın, count değerini 10 yapın.
Dönen video sonuçlarını List veya Card bileşeninde başlık, süre ve link ile görüntüleyin.
Brave Video Search İleri Seviye Özelleştirmeler
Kategoriye Göre Arama: Eğitim, spor, teknoloji gibi alt kategorilere göre filtreleme yapılabilir.
Video Önizlemesi: Dönen sonuçların thumbnail alanı kullanılarak kullanıcıya önizleme sunulabilir.
Sonuçların Kaydedilmesi: Kullanıcı favorilerine video kaydedebilir veya veritabanına aktarabilir.
Dış Link ile Açma: Dönen video URL’si, kullanıcıyı doğrudan video kaynağına yönlendirebilir.
Teknik Riskler ve Kontroller
query boş olmamalıdır. Zorunlu parametre olduğundan boş bırakılırsa sonuç dönmez.
count = 0 verilirse sonuç alınamaz. En az 1 veya daha büyük bir değer girilmelidir.
settings doğru yapılandırılmalıdır. Configuration Manager’da Brave Video Search ayarı yapılmazsa aksiyon çalışmaz.
Sonuç Formatı: Dönen sonuçlarda başlık, açıklama, süre ve URL alanları JSON formatında gelir; bunların doğru bağlanması gerekir.
