Ваш перший віджет Livedeck: від стартового набору до завантаження
Завантажте стартовий набір, змініть його, завантажте як ZIP і протестуйте в редакторі.
Стартовий набір — це готовий віджет «Live Feed»: він показує подарунки, підписки й чат у вигляді карток і рахує вподобайки. На його основі створіть власний.
Що є в пакеті
manifest.json
Назва, версія, розмір, дозволи й налаштування віджета
index.html
Стартова сторінка. Вона завантажує SDK і ваші файли.
style.css
Зовнішній вигляд
app.js
Логіка: реагує на події
README.md
Короткий посібник
| Файл | Призначення |
|---|---|
| manifest.json | Назва, версія, розмір, дозволи й налаштування віджета |
| index.html | Стартова сторінка. Вона завантажує SDK і ваші файли. |
| style.css | Зовнішній вигляд |
| app.js | Логіка: реагує на події |
| README.md | Короткий посібник |
Стартова сторінка
Кожна стартова сторінка завантажує SDK зі шляху /sdk/v1.js. Livedeck віддає його за адресою вашого віджета, додавати його в пакет самостійно не потрібно. Усі інші файли підключайте відносними шляхами.
<!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>Реакція на події
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;
});Віджет отримує лише ті події, які запитує в permissions у manifest.json. Для прикладу вище це events.gift і events.follow.
Запакуйте в ZIP і завантажте
- Збільште version у manifest.json (наприклад, з 1.0.0 до 1.0.1), щоб потім розрізняти свої версії.
- Запакуйте файли в ZIP. manifest.json має лежати в корені ZIP або в єдиній папці, що містить усе. Windows: виділіть файли › правий клік › Надіслати › Стиснута ZIP-папка. Mac: виділіть файли › правий клік › Стиснути.
- У дашборді: Редактор › Мої віджети › «Завантажити власний». Першого разу ви створюєте профіль розробника й приймаєте правила.
- Приблизно за хвилину перевірку буде завершено. Не пройшла? Ви побачите кожну причину з файлом і рядком або з виміряним значенням. Виправте й завантажте новий ZIP.
- Розмістіть віджет на полотні й перевірте його тестовими кнопками в налаштуваннях (подарунок, чат, лайки тощо).
Ця стаття була корисною?