Kavramlar

Viswoo’da bir işletme (müşteri) ekranlarını panelden yönetir. Eklenti müşterinin paneline ve ekranlarına yeni bir yetenek ekler: bir çekiliş, bir anket, bir sıra numarası ekranı. Eklenti tek bir paket dosyasıdır (.vzp, ZIP).

Parçalar

Parça	Dosya	Nerede çalışır	Köprü
Manifest	viswoo-plugin.json	—	—
Panel sekmesi	panel.entry (ör. panel/index.html)	Müşterinin panelinde, sandbox’lı çerçevede	Viswoo.panel
Ekran görünümü	player.entry (ör. player.html)	TV, tablet, kiosk; oynatıcının içinde	Viswoo.player
Genel sayfa	public.entry (ör. public/index.html)	Ziyaretçinin telefonunda, ekrandaki QR ile	Viswoo.public
Kendi sunucunuz	Sizin alanınızda	—	İmzalı webhook + platform API’si

Hiçbir parça zorunlu değildir; yalnız paneli olan bir rapor eklentisi de, yalnız ekranı olan bir içerik eklentisi de olur.

Sandbox

Her sayfa sandbox’lı bir çerçevede, ayrı ve opak bir kökende açılır: panelin çerezine, depolamasına ve DOM’una ulaşamaz. Platformla yalnız SDK köprüsüyle (postMessage) konuşur. Ekran görünümü ağa hiç çıkamaz (connect-src 'none'); sunucu işi köprüdeki call ile yapılır.

Panelde ne nerede

Panel eklentiye bir menü öğesi ve sekmeler açar. Standart sekmeleri Viswoo çizer:

Sekme	Kim çizer	İçerik
Eklentinin sekmesi (panel.tab)	Eklenti	Kasa, istatistik, liste gibi özel işler
Ayarlar	Viswoo, settings şemasından	Form, zorunlu alanlar, kayıt
Ekranlar	Viswoo	Hangi ekranlarda, nasıl (sürekli, aralıklı, playlist), hangi tarihler arasında
Önizleme	Viswoo	Ekran görünümü TV çerçevesinde, yatay/dikey, dokunmatik

Bu yüzden ayar formu yazmazsınız; ayar şemasını yazarsınız.

Kurulum ve yaşam döngüsü

1. Müşteri eklentiyi mağazadan açar ve istenen izinleri onaylar.
2. Ayarları doldurur. Şemadaki zorunlu alanlar girilmeden kurulum tamamlanmaz: eklenti ekranlarda oynamaz, sunucu işlemleri plugin.setup_incomplete döner, köprü bağlamında setupComplete: false gelir.
3. Ekran görünümü varsa Ekranlar sekmesinde yerleşimi seçer. Seçmeden eklenti hiçbir ekranda oynamaz.
4. Eklenti kapatılırsa ya da tarih aralığı dışındaysa ekranlardan kalkar; sunucu işlemleri plugin.not_live döner.

Yeni sürüm yeni izin isterse müşteri onaylayana kadar eski sürüm çalışır.

Kurulumda istenen izinler

İzin	Ne verir
settings	Ayar şeması ve ayarları okuma/yazma
data	Eklenti verisi (koleksiyon/anahtar → JSON belge)
screens:read	Müşterinin ekranlarının adı ve yönü
events	Olay sayaçları (report, events.summary)
codes	Tek kullanımlık kodlar
draw	Ağırlıklı çekiliş havuzu
public	QR ile açılan genel sayfa
server	Eklentinin kendi sunucusuna imzalı olaylar

İzinleri gerektiği kadar isteyin; müşteri kurulumda listeyi görür.

Protokol ve cihazlar

Ekran görünümü sahadaki en eski oynatıcıda da çalışmalıdır: LG webOS 3.x, yani Chromium 38. Bu yüzden ekran görünümü ES5 yazılır ve tek dosyadır. Ekran görünümü protokol 3 oynatıcı ister; yerleşim (sürekli ve aralıklı gösterim) protokol 4’tedir. Eski oynatıcı eklenti öğesini atlar, panel müşteriye “ekranı güncelleyin” der.