İ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.
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
| Dosya | Amaç |
|---|---|
| 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.
<!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
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
- 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).
- 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.
- Panelde: Editör › Widget’larım › "Kendininkini yükle". İlk seferde bir geliştirici profili oluşturur ve kuralları kabul edersin.
- 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.
- Widget’ı tuvale yerleştir ve ayarlarındaki test butonlarıyla dene (hediye, sohbet, beğeni ve dahası).
Bu makale işine yaradı mı?