ระบบอัตโนมัติสำหรับการถ่ายทอดสด

PanoPaper สามารถแจ้งเว็บไซต์ ระบบบ้านอัตโนมัติอย่าง Home Assistant บริการแชทอย่าง Slack หรือ Discord หรือคำสั่งลัด เมื่อการถ่ายทอดสดเริ่มและสิ้นสุด พร้อมลิงก์สำหรับรับชม เช่น เพื่อแสดงปุ่ม “ดูสด” บนเว็บไซต์ของคุณเอง หรือเพื่อโพสต์ในช่องของทีมคุณ

ตั้งค่าได้ใน เมื่อเริ่มถ่ายทอดสด ซึ่งเป็นปุ่มรูปเสาอากาศที่ท้ายแถบบริการในการตั้งค่า ▸ ถ่ายทอดสด เมื่อมีการตั้งค่าไว้ เสาอากาศจะแสดงเป็นสี และเมื่อชี้ที่ปุ่มจะบอกว่าเปิดอะไรอยู่

Webhook และคำสั่งลัด

“เรียก Webhook” - PanoPaper จะส่งข้อความไปยังที่อยู่เว็บ เช่น เซิร์ฟเวอร์ของคุณเอง ระบบบ้านอัตโนมัติอย่าง Home Assistant หรือบริการที่รับ Webhook คลิก “ตั้งค่า…” เพื่อพิมพ์หรือวางที่อยู่ และ “แก้ไข…” เพื่อเปลี่ยน ที่อยู่จะเก็บไว้ในพวงกุญแจของคุณ เพราะที่อยู่แบบนี้มักมีข้อมูลลับ “ทดสอบ” จะส่งข้อความตัวอย่างทันทีและแสดงคำตอบของเซิร์ฟเวอร์ หากเซิร์ฟเวอร์ตอบกลับเป็นหน้าเว็บ ที่อยู่นั้นน่าจะเป็นเว็บไซต์ ไม่ใช่ Webhook
“เรียกใช้คำสั่งลัด” (ฉบับเว็บ) - เรียกใช้คำสั่งลัดที่คุณเลือกด้านล่าง โดยใช้ข้อความเดียวกันเป็นอินพุต: ไฟล์ JSON ขนาดเล็กที่คำสั่งลัดอ่านเป็นพจนานุกรมได้

ข้อความจะส่งออกไปเมื่อใด

ข้อความ “live” จะส่งออกไปเมื่อบริการรับสตรีมของคุณแล้ว และส่งอีกครั้งทุกครั้งที่มีบริการเข้าร่วมหรือออกไปในขณะที่บริการอื่นยังออกอากาศอยู่ ส่วน “stopped” จะส่งเมื่อบริการสุดท้ายหยุด การคลิก สิ้นสุดการไลฟ์ ใน YouTube Studio ไม่ได้หยุดสตรีมของ PanoPaper จึงไม่มีการส่งอะไรจนกว่าคุณจะหยุดการถ่ายทอดสดใน PanoPaper

เมื่อเชื่อมต่อ บัญชี YouTube ของคุณแล้ว ข้อความ “live” สำหรับ YouTube จะมีลิงก์ของการถ่ายทอดสดโดยตรงด้วย PanoPaper จะรอให้ YouTube รายงานวิดีโอนานสูงสุดครึ่งนาทีก่อนส่งข้อความ ระหว่างถ่ายทอดสด จะมีการส่งข้อความ “viewers” ด้วยทุกครั้งที่จำนวนผู้ที่กำลังดูบน YouTube เปลี่ยนไป โดย PanoPaper จะตรวจสอบทุกห้านาที

ข้อความ

PanoPaper ส่งข้อความเป็น HTTP POST โดยมีประเภทเนื้อหาเป็น application/json เข้ารหัสแบบ UTF-8 และมี User Agent เป็น PanoPaper/ ตามด้วยเวอร์ชั่นของแอป คำตอบ 2xx ใดๆ ถือว่าได้รับแล้ว และจะไม่อ่านเนื้อหาของคำตอบ การส่งแต่ละครั้งจะรอคำตอบนานสูงสุด 15 วินาที เมื่อเครือข่ายขัดข้อง หรือเซิร์ฟเวอร์ตอบ 408, 429 หรือ 5xx PanoPaper จะลองอีกครั้งหลังจาก 5 วินาที และอีกครั้งหลังจากนั้น 30 วินาที คำตอบอื่นจะไม่ลองซ้ำ และ “ทดสอบ” จะลองเพียงครั้งเดียว ข้อความจะส่งออกไปทีละข้อความตามลำดับที่เกิดขึ้น ดังนั้น “stopped” จะไม่มีทางมาถึงก่อน “live” ของมัน

ตัวอย่างข้อความ “live” สำหรับ YouTube และ Facebook เมื่อเชื่อมต่อบัญชี YouTube ของคุณแล้ว:

{
  "event" : "live",
  "services" : [
    "YouTube",
    "Facebook"
  ],
  "watch" : "https://www.youtube.com/@yourchannel/live",
  "videoId" : "AbCdEfGhIjK",
  "video" : "https://www.youtube.com/watch?v=AbCdEfGhIjK",
  "embed" : "https://www.youtube.com/embed/AbCdEfGhIjK",
  "camera" : "Port Dome",
  "time" : "2026-10-20T14:03:12Z",
  "text" : "Port Dome กำลังถ่ายทอดสดบน YouTube และ Facebook: https://www.youtube.com/watch?v=AbCdEfGhIjK",
  "content" : "Port Dome กำลังถ่ายทอดสดบน YouTube และ Facebook: https://www.youtube.com/watch?v=AbCdEfGhIjK"
}

ฟิลด์	ประเภท	เนื้อหา
`event`	สตริง	`live`, `stopped`, `viewers` หรือ `test` ให้ใช้ฟิลด์นี้ ไม่ใช่ `text` เพื่อดูว่าเกิดอะไรขึ้น
`services`	อาร์เรย์ของสตริง	บริการ: `YouTube`, `Facebook` และสำหรับบริการอื่นคือชื่อเซิร์ฟเวอร์ของบริการนั้น เช่น `live.twitch.tv` (ชื่อที่ยาวเกิน 20 ตัวอักษรจะส่งเป็น “เซิร์ฟเวอร์ที่กำหนดเอง” ในภาษาของ PanoPaper) ใน “live” และ “viewers” คือทุกบริการที่กำลังออกอากาศในขณะนั้น ใน “stopped” คือบริการที่เคยออกอากาศอยู่ ใน “test” คือบริการที่พร้อมเริ่มถ่ายทอดสด
`watch`	สตริง (URL)	ลิงก์สำหรับรับชม: หน้าถ่ายทอดสดของช่องคุณ `https://www.youtube.com/@<channel>/live` หรือเมื่อเชื่อมต่อบัญชีไว้และปิดใช้ “ตั้งการถ่ายทอดเป็นสาธารณะ” อยู่ จะเป็นหน้าของการถ่ายทอดสดนั้นเอง เนื่องจากการถ่ายทอดสดที่ไม่เป็นสาธารณะจะไม่ปรากฏในหน้าถ่ายทอดสดของคุณ มีเฉพาะเมื่อ YouTube อยู่ในบริการและระบุ ช่อง ของคุณไว้แล้ว และใน “test” ทุกครั้งที่ระบุช่องไว้
`videoId`	สตริง	รหัสวิดีโอของการถ่ายทอดสดบน YouTube มีเฉพาะเมื่อเชื่อมต่อบัญชี YouTube ของคุณแล้ว และหลังจาก YouTube รายงานวิดีโอแล้ว: ใน “live”, “viewers” และ “test” ไม่มีใน “stopped”
`video`	สตริง (URL)	หน้าของการถ่ายทอดสดโดยตรง `https://www.youtube.com/watch?v=<videoId>` ส่งพร้อมกับ `videoId`
`embed`	สตริง (URL)	การถ่ายทอดสดสำหรับแสดงในหน้าเว็บ `https://www.youtube.com/embed/<videoId>` ใช้เป็นที่อยู่ของ `<iframe>` ส่งพร้อมกับ `videoId`
`viewers`	จำนวนเต็ม	จำนวนผู้ที่กำลังดูบน YouTube ตามที่ YouTube นับ มีเฉพาะเมื่อเชื่อมต่อบัญชี YouTube ของคุณแล้ว และหลังจาก PanoPaper ตรวจสอบแล้ว ประมาณหนึ่งนาทีหลังจากเริ่มถ่ายทอดสด: ใน “viewers” และใน “live” กับ “test” เมื่อทราบจำนวนแล้ว ไม่มีใน “stopped”
`camera`	สตริง	ชื่อกล้องตามที่ PanoPaper แสดง: กล้องที่กำลังออกอากาศ ส่วนใน “stopped” คือกล้องสุดท้ายที่ออกอากาศ เมื่อกล้องผลัดกันถ่ายทอดสด คือกล้องที่ออกอากาศอยู่ตอนที่ส่งข้อความ - การสลับไปยังกล้องถัดไปจะไม่ส่งข้อความ
`time`	สตริง	เวลาที่สร้างข้อความ ในรูปแบบ ISO 8601 และ UTC ละเอียดถึงวินาที: `2026-10-20T14:03:12Z`
`text`, `content`	สตริง	ประโยคเดียวกันสองครั้ง ในภาษาของ PanoPaper - ใน “live” จะมีลิงก์ของการถ่ายทอดสดโดยตรงหากทราบแล้ว มิฉะนั้นจะเป็นหน้าถ่ายทอดสดของช่องคุณ: `text` คือสิ่งที่ Slack แสดงเป็นข้อความ และ `content` คือสิ่งที่ Discord แสดง ประโยคนี้มีไว้ให้คนอ่าน และถ้อยคำอาจเปลี่ยนได้ จึงไม่ควรดึงข้อมูลใดๆ จากประโยคนี้

ฟิลด์ที่ไม่มีค่าจะถูกละไว้ ไม่มีการส่งเป็นค่าว่างหรือ null ฟิลด์อาจมาในลำดับใดก็ได้ และ PanoPaper เวอร์ชั่นต่อๆ ไปอาจเพิ่มฟิลด์ใหม่ ให้ข้ามฟิลด์ที่คุณไม่รู้จัก

การเก็บที่อยู่เป็นความลับ

PanoPaper ไม่ได้ลงนามข้อความหรือเพิ่มรหัสผ่านของตัวเอง หากต้องการให้แน่ใจว่ามีเพียง PanoPaper ที่ส่งไปยังเซิร์ฟเวอร์ของคุณได้ ให้ใส่ข้อมูลลับไว้ในที่อยู่เลย เช่น พาธแบบสุ่มที่ยาว หรือโทเค็นในสตริงคิวรี - ที่อยู่ Webhook ของ Home Assistant ก็ทำงานแบบนี้อยู่แล้ว นี่คือเหตุผลที่ที่อยู่ถูกเก็บไว้ในพวงกุญแจของคุณ

ในคำสั่งลัด

คำสั่งลัดจะได้รับ JSON เดียวกันเป็นไฟล์ที่ตั้งชื่อตามเหตุการณ์ เช่น “PanoPaper live.json”

คำสั่งลัดและ Siri ยังเริ่มและหยุดการถ่ายทอดสดได้ด้วย