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

คู่มือฉบับย่อ

หน้าเริ่มต้น

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

บทความนี้มีประโยชน์ไหม?