הווידג׳ט הראשון שלכם ב-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.

דחיסה והעלאה

  1. העלו את הגרסה ב-manifest.json (למשל מ-1.0.0 ל-1.0.1) כדי שתוכלו להבדיל בין הגרסאות בהמשך.
  2. דחסו את הקבצים ל-ZIP. ‏manifest.json חייב להיות ברמה העליונה של ה-ZIP או בתוך התיקייה היחידה שמכילה הכול. Windows: בחרו את הקבצים › קליק ימני › שלח אל › תיקייה דחוסה (zipped). Mac: בחרו את הקבצים › קליק ימני › דחס.
  3. בדשבורד: עורך › הווידג׳טים שלי › ”העלאת ווידג׳ט משלך“. בפעם הראשונה יוצרים פרופיל מפתח ומאשרים את הכללים.
  4. אחרי כדקה הבדיקה מסתיימת. לא עבר? תראו כל סיבה עם קובץ ושורה, או עם הערך שנמדד. תקנו והעלו ZIP חדש.
  5. מקמו את הווידג׳ט על הקנבס ונסו אותו עם כפתורי הבדיקה בהגדרות שלו (מתנה, צ׳אט, לייקים ועוד).
טיפ: תנו לקבצים שמות עם האותיות a עד z, ספרות, מקף וקו תחתון בלבד. Livedeck מתעלם מקבצי מערכת כמו __MACOSX, ‏.DS_Store או Thumbs.db.
הערה: אירועי בדיקה מהעורך ומה-Marketplace מגיעים עם livedeck.context.test = true וצופים מומצאים. בקישור ל-OBS הערך הוא false.

המאמר הזה עזר לך?