أول widget لك على Livedeck: من حزمة البداية إلى الرفع
نزّل حزمة البداية، وعدّلها، وارفعها كملف ZIP، واختبرها في المحرر.
قراءة في 6 دقيقة آخر تحديث 4 نوفمبر 2026
حزمة البداية widget جاهز اسمه «Live Feed»: يعرض الهدايا والمتابعات والدردشة كبطاقات ويحسب الإعجابات. انطلق منه لبناء الـ widget الخاص بك.
محتوى الحزمة
manifest.json
اسم الـ widget وإصداره وحجمه وصلاحياته وإعداداته
index.html
صفحة البداية. تحمّل الـ SDK وملفاتك.
style.css
المظهر
app.js
المنطق: يتفاعل مع الأحداث
README.md
دليل سريع
| الملف | الغرض |
|---|---|
| manifest.json | اسم الـ widget وإصداره وحجمه وصلاحياته وإعداداته |
| index.html | صفحة البداية. تحمّل الـ SDK وملفاتك. |
| style.css | المظهر |
| app.js | المنطق: يتفاعل مع الأحداث |
| README.md | دليل سريع |
صفحة البداية
كل صفحة بداية تحمّل الـ SDK من المسار /sdk/v1.js. يوفّره Livedeck على عنوان الـ widget الخاص بك، فلا تضعه داخل الحزمة بنفسك. حمّل باقي ملفاتك كلها بمسارات نسبية.
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;
});لا يتلقى الـ widget إلا الأحداث التي يطلبها ضمن permissions في manifest.json. في المثال أعلاه هي events.gift وevents.follow.
الضغط والرفع
- ارفع رقم version في manifest.json (مثلًا من 1.0.0 إلى 1.0.1) لتميّز بين إصداراتك لاحقًا.
- اضغط الملفات بصيغة ZIP. يجب أن يكون manifest.json في أعلى ملف الـ ZIP أو داخل المجلد الوحيد الذي يضم كل شيء. Windows: حدّد الملفات › انقر بزر الفأرة الأيمن › إرسال إلى › مجلد مضغوط. Mac: حدّد الملفات › انقر بزر الفأرة الأيمن › ضغط.
- في لوحة التحكم: المحرر › الـ widgets الخاصة بي › "ارفع الخاص بك". في المرة الأولى تنشئ ملف مطوّر وتوافق على القواعد.
- بعد دقيقة تقريبًا ينتهي الفحص. لم ينجح؟ سترى كل سبب مع الملف والسطر، أو مع القيمة المقاسة. أصلحه وارفع ملف ZIP جديدًا.
- ضع الـ widget على اللوحة وجرّبه بأزرار الاختبار في إعداداته (هدية، دردشة، إعجابات والمزيد).
نصيحة: سمِّ ملفاتك باستخدام الحروف من a إلى z والأرقام والشرطة والشرطة السفلية فقط. يتجاهل Livedeck ملفات النظام مثل __MACOSX أو .DS_Store أو Thumbs.db.
ملاحظة: أحداث الاختبار من المحرر ومن Marketplace تصل مع livedeck.context.test = true ومشاهدين وهميين. في رابط OBS تكون القيمة false.
هل كانت هذه المقالة مفيدة؟