จัดการผู้ชม / Viewer Management
หน้า Viewers เป็นศูนย์กลางจัดการชุมชนข้าม platform — รวม chat ทุก source ไว้ที่เดียว, ติดตามผู้ชมที่กลับมาบ่อย, และ merge identities ของคนที่ใช้หลายแพลตฟอร์มได้
มี 2 แท็บหลัก:
- Live Chat — feed สดรวมทุก platform
- Viewer Manager — ตารางผู้ชม, edit nickname/notes, merge / split
สิ่งที่ต้องเตรียม
- เชื่อม source อย่างน้อย 1 ตัวแล้ว
- เคยมี chat / donation เข้ามาบ้าง (ไม่งั้นจะไม่มีข้อมูลแสดง)
ขั้นที่ 1 — Live Chat รวมทุก Platform
- ไปที่ Viewers (sidebar) → แท็บ Live Chat
- Feed รวมข้อความจาก YouTube + Twitch + Streamlabs ในที่เดียว
- แต่ละข้อความมี platform icon, avatar, badges (Super, Sub, Bits, Gift, Member)
ปุ่มควบคุมที่มี:
- Filter by platform — โชว์เฉพาะ YT / Twitch / Streamlabs
- Search — ค้นชื่อหรือข้อความ
- Pause / Resume — หยุด feed ชั่วคราว (โดยที่ข้อความยังเก็บใน buffer 300 ข้อความ)
- Clear — ล้างหน้าจอ
- Auto-scroll toggle
ขั้นที่ 2 — Pop-out Chat Window
ถ้าจะดู chat ตอนเล่นเกมเต็มจอ:
- ในแท็บ Live Chat กดปุ่ม Pop out
- Electron จะเปิดหน้าต่างแยก (
/chat-window) - ใน window นั้นมี toggle Always on Top — ตรึงไว้บนสุดเสมอ
- มี filter / pause / auto-scroll เหมือนใน main window
ขั้นที่ 3 — Viewer Manager
แท็บ Viewer Manager แสดงตารางผู้ชมทั้งหมด:
- ค้นหาด้วยชื่อ
- เรียงตาม Last seen / Message count / Total donated
- คลิกแถวเพื่อ:
- Edit nickname — ตั้งชื่อย่อให้ผู้ชม (ใช้ใน TTS / overlay ได้)
- Edit notes — บันทึกย่อ (เช่น "VIP", "moderator")
- Delete — ลบ viewer record (ไม่ลบ donation/chat history)
ขั้นที่ 4 — Merge ผู้ใช้ที่ซ้ำข้าม Platform
ผู้ชมคนเดียวกันที่มาทั้ง YouTube + Twitch ด้วยชื่อต่างกันสามารถ merge ให้เป็น viewer record เดียวได้:
- แอปจะแนะนำ merge อัตโนมัติใน Suggestions banner ด้านบน Viewer Manager
- คลิกชื่อ suggestion → กด Accept → 2 records จะรวมกัน
- หรือ merge เอง: เลือก viewer 1 → กด Merge → เลือกอีก viewer → ยืนยัน
หลัง merge — chat history + donation count รวมเข้าด้วยกัน
ขั้นที่ 5 — Split Identity
ถ้า merge ผิดหรืออยากแยกคืน:
- คลิกชื่อ viewer → เปิด Detail Modal
- ในแท็บ Identities → กด Split ข้าง identity ที่ต้องการแยกออก
- identity จะกลายเป็น viewer record แยกใหม่
ขั้นที่ 6 — Viewer Detail Modal
คลิกชื่อ viewer ที่ไหนก็ได้ (Live Chat / Viewer Manager / History) → เปิด popup:
- รายการ identities ทุก platform
- Stats: message count, donation count, total donated, first/last seen
- Activity history — chat + donation รวม
- Edit nickname / notes ในที่เดียว
ขั้นที่ 7 — ตั้ง Chat Retention
Chat message เก่าจะถูกลบอัตโนมัติเพื่อไม่ให้ DB บวม (counter จำนวนข้อความยังเก็บถาวร):
- ไปที่ Settings → Backup tab
- ส่วน Chat Retention
- Toggle chatAutoCleanupEnabled
- ตั้ง Retention Days (slider 1–365 — default 30)
- ระบบลบอัตโนมัติทุก 6 ชั่วโมง
:::tip ใช้ค่าเริ่มต้น 30 วัน ก็พอ สำหรับสตรีมเมอร์ส่วนใหญ่ — 30 วันคือ sweet spot ระหว่าง history ที่ใช้งานจริงกับ DB size :::
Tips & Troubleshooting
- ผู้ชมเปลี่ยนชื่อ: ใช้ nickname ใน Viewer Manager — ใช้ใน TTS / overlay ได้แทนชื่อ platform จริง
- Suggestions ไม่ขึ้น: ระบบใช้ similarity ของชื่อ — ถ้าชื่อต่างกันมากจะไม่ suggest, merge เองได้
- Pop-out window หาไม่เจอ: อาจซ่อนหลัง main window — Alt+Tab หรือกด Pop out อีกครั้ง (จะ focus ตัวเดิม)
- Chat ไม่อัปเดต: ตรวจ Pause toggle + ตรวจ source connections เป็นเขียวอยู่