Seu primeiro widget do Livedeck: do starter kit ao upload
Baixe o starter kit, modifique, envie como ZIP e teste no editor.
O starter kit é um widget pronto chamado “Live Feed”: ele mostra presentes, seguidores e chat em cards e conta as curtidas. Crie o seu a partir dele.
O que vem no pacote
manifest.json
Nome, versão, tamanho, permissões e configurações do widget
index.html
A página inicial. Ela carrega o SDK e seus arquivos.
style.css
O visual
app.js
A lógica: reage aos eventos
README.md
Guia rápido
| Arquivo | Função |
|---|---|
| manifest.json | Nome, versão, tamanho, permissões e configurações do widget |
| index.html | A página inicial. Ela carrega o SDK e seus arquivos. |
| style.css | O visual |
| app.js | A lógica: reage aos eventos |
| README.md | Guia rápido |
A página inicial
Toda página inicial carrega o SDK pelo caminho /sdk/v1.js. O Livedeck o disponibiliza no endereço do seu widget; você não precisa colocá-lo no pacote. Carregue todos os outros arquivos com caminhos relativos.
<!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>Reagindo 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;
});Um widget só recebe os eventos que pede em permissions no manifest.json. No exemplo acima, são events.gift e events.follow.
Compactar e enviar
- Aumente a versão no manifest.json (por exemplo, de 1.0.0 para 1.0.1) para conseguir diferenciar suas versões depois.
- Compacte os arquivos em ZIP. O manifest.json precisa estar no nível principal do ZIP ou dentro da única pasta que contém tudo. Windows: selecione os arquivos › clique com o botão direito › Enviar para › Pasta compactada. Mac: selecione os arquivos › clique com o botão direito › Comprimir.
- No painel: Editor › Meus widgets › “Enviar o seu”. Na primeira vez, você cria um perfil de desenvolvedor e aceita as regras.
- Em cerca de um minuto a verificação termina. Não passou? Você vê cada motivo com arquivo e linha, ou com o valor medido. Corrija e envie um novo ZIP.
- Coloque o widget no canvas e teste com os botões de teste nas configurações dele (presente, chat, curtidas e mais).
Este artigo foi útil?