Il tuo primo widget Livedeck: dallo starter kit al caricamento
Scarica lo starter kit, modificalo, caricalo come ZIP e testalo nell’editor.
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
| File | Scopo |
|---|---|
| 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.
<!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
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
- Aumenta la versione nel manifest.json (per esempio da 1.0.0 a 1.0.1), così più avanti potrai distinguere le tue versioni.
- 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.
- Nella dashboard: Editor › I miei widget › "Carica il tuo". La prima volta crei un profilo sviluppatore e accetti le regole.
- 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.
- Posiziona il widget sulla canvas e provalo con i pulsanti di test nelle sue impostazioni (regalo, chat, like e altro).
Questo articolo ti è stato utile?