İlk Livedeck widget’ın: starter kit’ten yüklemeye

Starter kit’i indir, değiştir, ZIP olarak yükle ve editörde test et.

6 dk okuma Güncellendi: 4 Kas 2026

Starter kit, “Live Feed” adında hazır bir widget: hediyeleri, takipleri ve sohbeti kart olarak gösterir ve beğenileri sayar. Kendi widget’ını buradan yola çıkarak yap.

Pakette neler var

manifest.json

Widget’ın adı, sürümü, boyutu, izinleri ve ayarları

index.html

Başlangıç sayfası. SDK’yı ve dosyalarını yükler.

style.css

Görünüm

app.js

Mantık: olaylara tepki verir

README.md

Hızlı rehber

Başlangıç sayfası

Her başlangıç sayfası SDK’yı /sdk/v1.js yolundan yükler. Livedeck bunu widget’ının adresinde sunar; pakete kendin eklemezsin. Diğer tüm dosyalarını göreli yollarla yükle.

html
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <link rel="stylesheet" href="style.css">
  <!-- Livedeck serves the SDK. Everything else lives in your package. -->
  <script src="/sdk/v1.js"></script>
</head>
<body>
  <div id="feed"></div>
  <script src="app.js"></script>
</body>
</html>

Olaylara tepki verme

js
function show(text) {
  const line = document.createElement("p");
  line.textContent = text; // textContent, never innerHTML: names are viewer text
  document.getElementById("feed").prepend(line);
}

livedeck.on("gift", (e) => {
  // "@" + e.user.handle (username), e.gift.name, e.count, e.totalDiamonds
  show("@" + e.user.handle + " sent " + e.count + "× " + e.gift.name);
});

livedeck.on("follow", (e) => {
  show("@" + e.user.handle + " followed you");
});

livedeck.ready(() => {
  // The overlay is connected and the settings are here.
  document.body.style.color = livedeck.settings.accent;
});

Bir widget yalnızca manifest.json içinde permissions altında istediği olayları alır. Yukarıdaki örnekte bunlar events.gift ve events.follow.

Sıkıştır ve yükle

  1. Sürümlerini sonradan ayırt edebilmek için manifest.json’daki version değerini artır (örneğin 1.0.0’dan 1.0.1’e).
  2. Dosyaları ZIP’le. manifest.json, ZIP’in en üst düzeyinde ya da her şeyi içeren tek klasörün içinde olmalı. Windows: dosyaları seç › sağ tıkla › Gönder › Sıkıştırılmış (zip) klasör. Mac: dosyaları seç › sağ tıkla › Sıkıştır.
  3. Panelde: Editör › Widget’larım › "Kendininkini yükle". İlk seferde bir geliştirici profili oluşturur ve kuralları kabul edersin.
  4. Yaklaşık bir dakika sonra kontrol biter. Geçmedi mi? Her nedeni dosya ve satırıyla ya da ölçülen değerle görürsün. Düzelt ve yeni bir ZIP yükle.
  5. Widget’ı tuvale yerleştir ve ayarlarındaki test butonlarıyla dene (hediye, sohbet, beğeni ve dahası).
İpucu: Dosyalarını yalnızca a–z harfleri, rakamlar, tire ve alt çizgiyle adlandır. Livedeck __MACOSX, .DS_Store veya Thumbs.db gibi sistem dosyalarını yok sayar.
Not: Editörden ve Marketplace’ten gelen test olayları livedeck.context.test = true ve uydurma izleyicilerle gelir. OBS linkinde bu değer false olur.

Bu makale işine yaradı mı?