Ваш перший віджет Livedeck: від стартового набору до завантаження

Завантажте стартовий набір, змініть його, завантажте як ZIP і протестуйте в редакторі.

6 хв читання Оновлено 4 лист. 2026 р.

Стартовий набір — це готовий віджет «Live Feed»: він показує подарунки, підписки й чат у вигляді карток і рахує вподобайки. На його основі створіть власний.

Що є в пакеті

manifest.json

Назва, версія, розмір, дозволи й налаштування віджета

index.html

Стартова сторінка. Вона завантажує SDK і ваші файли.

style.css

Зовнішній вигляд

app.js

Логіка: реагує на події

README.md

Короткий посібник

Стартова сторінка

Кожна стартова сторінка завантажує SDK зі шляху /sdk/v1.js. Livedeck віддає його за адресою вашого віджета, додавати його в пакет самостійно не потрібно. Усі інші файли підключайте відносними шляхами.

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>

Реакція на події

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

Віджет отримує лише ті події, які запитує в permissions у manifest.json. Для прикладу вище це events.gift і events.follow.

Запакуйте в ZIP і завантажте

  1. Збільште version у manifest.json (наприклад, з 1.0.0 до 1.0.1), щоб потім розрізняти свої версії.
  2. Запакуйте файли в ZIP. manifest.json має лежати в корені ZIP або в єдиній папці, що містить усе. Windows: виділіть файли › правий клік › Надіслати › Стиснута ZIP-папка. Mac: виділіть файли › правий клік › Стиснути.
  3. У дашборді: Редактор › Мої віджети › «Завантажити власний». Першого разу ви створюєте профіль розробника й приймаєте правила.
  4. Приблизно за хвилину перевірку буде завершено. Не пройшла? Ви побачите кожну причину з файлом і рядком або з виміряним значенням. Виправте й завантажте новий ZIP.
  5. Розмістіть віджет на полотні й перевірте його тестовими кнопками в налаштуваннях (подарунок, чат, лайки тощо).
Порада: Називайте файли лише літерами від a до z, цифрами, дефісом і підкресленням. Livedeck ігнорує системні файли, як-от __MACOSX, .DS_Store або Thumbs.db.
Примітка: Тестові події з редактора й Marketplace надходять із livedeck.context.test = true і вигаданими глядачами. У посиланні для OBS це значення — false.

Ця стаття була корисною?