Il tuo primo widget Livedeck: dallo starter kit al caricamento

Scarica lo starter kit, modificalo, caricalo come ZIP e testalo nell’editor.

6 min di lettura Aggiornato il 4 nov 2026

Lo starter kit è un widget già pronto chiamato “Live Feed”: mostra regali, follow e chat come schede e conta i Mi piace. Parti da lì per creare il tuo.

Cosa c’è nel pacchetto

manifest.json

Nome, versione, dimensioni, permessi e impostazioni del widget

index.html

La pagina iniziale. Carica l’SDK e i tuoi file.

style.css

L’aspetto

app.js

La logica: reagisce agli eventi

README.md

Guida rapida

La pagina iniziale

Ogni pagina iniziale carica l’SDK dal percorso /sdk/v1.js. Livedeck lo fornisce all’indirizzo del tuo widget: non devi metterlo tu nel pacchetto. Carica tutti gli altri file con percorsi relativi.

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>

Reagire agli eventi

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

Un widget riceve solo gli eventi che richiede in permissions nel manifest.json. Per l’esempio sopra sono events.gift ed events.follow.

Comprimi e carica

  1. Aumenta la versione nel manifest.json (per esempio da 1.0.0 a 1.0.1), così più avanti potrai distinguere le tue versioni.
  2. Comprimi i file in uno ZIP. Il manifest.json deve trovarsi al primo livello dello ZIP o dentro l’unica cartella che contiene tutto. Windows: seleziona i file › clic destro › Invia a › Cartella compressa. Mac: seleziona i file › clic destro › Comprimi.
  3. Nella dashboard: Editor › I miei widget › "Carica il tuo". La prima volta crei un profilo sviluppatore e accetti le regole.
  4. Dopo circa un minuto il controllo è completato. Non è stato superato? Vedi ogni motivo con file e riga, oppure con il valore misurato. Correggi e carica un nuovo ZIP.
  5. Posiziona il widget sulla canvas e provalo con i pulsanti di test nelle sue impostazioni (regalo, chat, like e altro).
Consiglio: Dai ai file nomi solo con lettere dalla a alla z, cifre, trattino e trattino basso. Livedeck ignora i file di sistema come __MACOSX, .DS_Store o Thumbs.db.
Nota: Gli eventi di test dall’editor e dal Marketplace arrivano con livedeck.context.test = true e spettatori inventati. Nel link per OBS il valore è false.

Questo articolo ti è stato utile?