Tu primer widget de Livedeck: del starter kit a la subida
Descarga el starter kit, modifícalo, súbelo como ZIP y pruébalo en el editor.
El starter kit es un widget terminado llamado "Live Feed": muestra regalos, seguidores y chat como tarjetas y cuenta los Me gusta. Crea el tuyo a partir de ahí.
Qué incluye el paquete
manifest.json
Nombre, versión, tamaño, permisos y ajustes del widget
index.html
La página de inicio. Carga el SDK y tus archivos.
style.css
El aspecto
app.js
La lógica: reacciona a los eventos
README.md
Guía rápida
| Archivo | Función |
|---|---|
| manifest.json | Nombre, versión, tamaño, permisos y ajustes del widget |
| index.html | La página de inicio. Carga el SDK y tus archivos. |
| style.css | El aspecto |
| app.js | La lógica: reacciona a los eventos |
| README.md | Guía rápida |
La página de inicio
Cada página de inicio carga el SDK desde la ruta /sdk/v1.js. Livedeck lo sirve en la dirección de tu widget; no tienes que meterlo tú en el paquete. Carga todos tus demás archivos con rutas relativas.
<!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>Reaccionar a eventos
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 solo recibe los eventos que pide en permissions dentro de manifest.json. En el ejemplo de arriba son events.gift y events.follow.
Comprimir y subir
- Sube la versión en manifest.json (por ejemplo, de 1.0.0 a 1.0.1) para poder distinguir tus versiones más adelante.
- Comprime los archivos en ZIP. manifest.json tiene que estar en el nivel superior del ZIP o dentro de la única carpeta que lo contiene todo. Windows: selecciona los archivos › clic derecho › Enviar a › Carpeta comprimida (en zip). Mac: selecciona los archivos › clic derecho › Comprimir.
- En el dashboard: Editor › Mis widgets › “Subir el tuyo”. La primera vez creas un perfil de desarrollador y aceptas las normas.
- En más o menos un minuto termina la revisión. ¿No la pasó? Verás cada motivo con archivo y línea, o con el valor medido. Corrígelo y sube un ZIP nuevo.
- Coloca el widget en el lienzo y pruébalo con los botones de prueba de sus ajustes (regalo, chat, Me gusta y más).
¿Te resultó útil este artículo?