widget Livedeck แรกของคุณ: จาก starter kit ถึงการอัปโหลด
ดาวน์โหลด starter kit แก้ไข อัปโหลดเป็น ZIP แล้วทดสอบในเอดิเตอร์
อ่าน 6 นาที อัปเดตเมื่อ 4 พ.ย. 2569
starter kit คือ widget สำเร็จรูปชื่อ “Live Feed”: แสดงของขวัญ ผู้ติดตาม และแชทเป็นการ์ด พร้อมนับยอดไลก์ ต่อยอดสร้างของคุณเองจากตรงนี้ได้เลย
ในแพ็กเกจมีอะไรบ้าง
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 ให้บริการไฟล์นี้ที่ที่อยู่ของวิดเจ็ตคุณ ไม่ต้องใส่ไว้ในแพ็กเกจเอง ส่วนไฟล์อื่นทั้งหมดให้โหลดด้วยพาธแบบสัมพัทธ์
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
บีบอัดและอัปโหลด
- เพิ่ม version ใน manifest.json (เช่น จาก 1.0.0 เป็น 1.0.1) เพื่อให้แยกเวอร์ชันได้ในภายหลัง
- บีบอัดไฟล์เป็น ZIP โดย manifest.json ต้องอยู่ชั้นบนสุดของ ZIP หรืออยู่ในโฟลเดอร์เดียวที่เก็บทุกอย่างไว้ Windows: เลือกไฟล์ › คลิกขวา › Send to › Compressed (zipped) folder Mac: เลือกไฟล์ › คลิกขวา › Compress
- ในแดชบอร์ด: Editor › วิดเจ็ตของฉัน › “อัปโหลดของคุณเอง” ครั้งแรกจะต้องสร้างโปรไฟล์นักพัฒนาและยอมรับกฎก่อน
- การตรวจสอบจะเสร็จในประมาณหนึ่งนาที ถ้าไม่ผ่าน จะเห็นทุกเหตุผลพร้อมไฟล์และบรรทัด หรือค่าที่วัดได้ แก้ไขแล้วอัปโหลด ZIP ใหม่
- วางวิดเจ็ตบนแคนวาส แล้วลองใช้ปุ่มทดสอบในการตั้งค่า (ของขวัญ แชท ไลก์ และอื่นๆ)
เคล็ดลับ: ตั้งชื่อไฟล์โดยใช้เฉพาะ a ถึง z ตัวเลข ขีดกลาง และขีดล่าง Livedeck จะข้ามไฟล์ระบบอย่าง __MACOSX, .DS_Store หรือ Thumbs.db
หมายเหตุ: อีเวนต์ทดสอบจาก Editor และ Marketplace จะมาพร้อม livedeck.context.test = true และผู้ชมสมมติ ส่วนในลิงก์ OBS ค่านี้จะเป็น false
บทความนี้มีประโยชน์ไหม?