הווידג׳ט הראשון שלכם ב-Livedeck: מערכת הפתיחה ועד ההעלאה
הורידו את ערכת הפתיחה, שנו אותה, העלו אותה כ-ZIP ובדקו אותה בעורך.
6 דק׳ קריאה עודכן ב-4 בנוב׳ 2026
ערכת הפתיחה היא ווידג׳ט מוכן בשם „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 מגיש אותו בכתובת של הווידג׳ט שלך; אין צורך להכניס אותו לחבילה בעצמך. את כל שאר הקבצים יש לטעון בנתיבים יחסיים.
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.
דחיסה והעלאה
- העלו את הגרסה ב-manifest.json (למשל מ-1.0.0 ל-1.0.1) כדי שתוכלו להבדיל בין הגרסאות בהמשך.
- דחסו את הקבצים ל-ZIP. manifest.json חייב להיות ברמה העליונה של ה-ZIP או בתוך התיקייה היחידה שמכילה הכול. Windows: בחרו את הקבצים › קליק ימני › שלח אל › תיקייה דחוסה (zipped). Mac: בחרו את הקבצים › קליק ימני › דחס.
- בדשבורד: עורך › הווידג׳טים שלי › ”העלאת ווידג׳ט משלך“. בפעם הראשונה יוצרים פרופיל מפתח ומאשרים את הכללים.
- אחרי כדקה הבדיקה מסתיימת. לא עבר? תראו כל סיבה עם קובץ ושורה, או עם הערך שנמדד. תקנו והעלו ZIP חדש.
- מקמו את הווידג׳ט על הקנבס ונסו אותו עם כפתורי הבדיקה בהגדרות שלו (מתנה, צ׳אט, לייקים ועוד).
טיפ: תנו לקבצים שמות עם האותיות a עד z, ספרות, מקף וקו תחתון בלבד. Livedeck מתעלם מקבצי מערכת כמו __MACOSX, .DS_Store או Thumbs.db.
הערה: אירועי בדיקה מהעורך ומה-Marketplace מגיעים עם livedeck.context.test = true וצופים מומצאים. בקישור ל-OBS הערך הוא false.
המאמר הזה עזר לך?