Widget Livedeck pertamamu: dari starter kit sampai upload

Download starter kit, ubah, upload sebagai ZIP, dan uji di editor.

6 menit baca Diperbarui 4 Nov 2026

Starter kit adalah widget jadi bernama "Live Feed": menampilkan gift, follow, dan chat sebagai kartu serta menghitung like. Bangun widget kamu sendiri dari situ.

Isi paketnya

manifest.json

Nama, versi, ukuran, izin, dan pengaturan widget

index.html

Halaman awal. Memuat SDK dan file-file kamu.

style.css

Tampilan

app.js

Logika: bereaksi terhadap event

README.md

Panduan singkat

Halaman awal

Setiap halaman awal memuat SDK dari path /sdk/v1.js. Livedeck menyediakannya di alamat widget kamu, jadi kamu nggak perlu memasukkannya ke paket sendiri. Muat semua file lain dengan path relatif.

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>

Merespons event

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;
});

Widget hanya menerima event yang diminta di permissions pada manifest.json. Untuk contoh di atas, itu events.gift dan events.follow.

Zip dan upload

  1. Naikkan version di manifest.json (misalnya dari 1.0.0 ke 1.0.1) supaya nanti kamu bisa membedakan versinya.
  2. Zip file-filenya. manifest.json harus berada di level teratas ZIP atau di dalam satu folder yang berisi semuanya. Windows: pilih file › klik kanan › Send to › Compressed (zipped) folder. Mac: pilih file › klik kanan › Compress.
  3. Di dashboard: Editor › My widgets › "Upload your own". Saat pertama kali, kamu membuat profil developer dan menyetujui aturannya.
  4. Setelah sekitar satu menit, pemeriksaan selesai. Nggak lolos? Kamu akan lihat setiap alasannya beserta file dan barisnya, atau nilai yang terukur. Perbaiki lalu upload ZIP baru.
  5. Taruh widget di canvas dan coba dengan tombol tes di pengaturannya (gift, chat, like, dan lainnya).
Tips: Beri nama file hanya dengan huruf a sampai z, angka, tanda hubung, dan underscore. Livedeck mengabaikan file sistem seperti __MACOSX, .DS_Store, atau Thumbs.db.
Catatan: Event tes dari editor dan Marketplace masuk dengan livedeck.context.test = true dan penonton fiktif. Di link OBS, nilainya false.

Apakah artikel ini membantu?