คู่มือผู้ใช้ SoftPlayer

แตก SoftPlayer บนเครื่องเป้าหมายและตรวจสอบว่าสภาพแวดล้อมตรงตามข้อกำหนด

1. ยืนยันว่าเครื่องเป้าหมายใช้ Windows 10/11 x64
2. แตกแพ็กเกจ SoftPlayer ไปยังไดเรกทอรีถาวร เช่น C:\SoftPlayer\
3. ตรวจสอบว่าไดเรกทอรีมี SoftPlayer.exe, appsettings.json และโครงสร้างไดเรกทอรีย่อย SoftPlayerMedia\
4. สำหรับการเล่นวิดีโอ 8K ให้ตรวจสอบว่าเครื่องมี GPU รองรับการถอดรหัสฮาร์ดแวร์ (GTX 1060+ หรือเทียบเท่า); 4K และต่ำกว่าใช้การ์ดจอออนบอร์ดได้

• SoftPlayer.exe ปรากฏในไดเรกทอรีที่แตกออก
• ไดเรกทอรี SoftPlayerMedia\ สร้างล่วงหน้าพร้อมไดเรกทอรีย่อย: Video, StandBy, Audio, PPT ฯลฯ

• วาง SoftPlayer ในเส้นทางที่เสถียร — ไฟล์สื่อ ล็อก และสถานะใบอนุญาตล้วนบันทึกสัมพันธ์กับไดเรกทอรีโปรแกรม
• แนะนำพื้นที่เก็บข้อมูล SSD ความเร็วอ่านสูงกว่า 200MB/s สำหรับการเล่นความละเอียดสูงอย่างราบรื่น

ยืนยันว่าโปรแกรมเริ่มต้นถูกต้องและทำการแนะนำครั้งแรกให้เสร็จ

1. ดับเบิลคลิก SoftPlayer.exe เพื่อเปิดใช้งาน (ไม่ต้องใช้สิทธิ์แอดมิน)
2. เมื่อเปิดครั้งแรก โปรแกรมจะเปิดคู่มือเริ่มต้นในเบราว์เซอร์เริ่มต้น (เฉพาะครั้งแรก ครั้งต่อไปข้ามขั้นตอนนี้)
3. หลังอ่านคู่มือ เปิด http://localhost:8766/ ในเบราว์เซอร์เพื่อเปิดคอนโซลจัดการ
4. ในแท็บ Dashboard ยืนยันว่าสถานะเครื่องเล่นปกติ และมองเห็นข้อมูลเวอร์ชัน/ใบอนุญาต

• เบราว์เซอร์เปิดคอนโซลจัดการ (http://localhost:8766/) ได้สำเร็จและแสดง Dashboard
• หมายเลขเวอร์ชันและสถานะใบอนุญาตปรากฏในส่วนหัวคอนโซล

หากต้องการปิดการใช้งานคู่มือครั้งแรก ให้ตั้งค่า System.ShowQuickStartOnFirstRun เป็น false ใน appsettings.json

ควบคุมเครื่องเล่นผ่าน UDP ได้สำเร็จและยืนยันว่าช่องทางควบคุมทำงาน

1. วางไฟล์วิดีโอ (เช่น test.mp4) ในไดเรกทอรี SoftPlayerMedia\Video\
2. เปิด PowerShell และรันคำสั่งต่อไปนี้:
3. $udp = New-Object System.Net.Sockets.UdpClient
4. $data = [System.Text.Encoding]::UTF8.GetBytes("video:test.mp4")
5. $udp.Send($data, $data.Length, "127.0.0.1", 7600)
6. $udp.Close()
7. สังเกตว่าหน้าต่าง SoftPlayer เริ่มเล่นวิดีโอที่ระบุหรือไม่

• หน้าต่าง SoftPlayer เริ่มเล่นไฟล์วิดีโอที่ระบุ
• แท็บ Log ในคอนโซลจัดการแสดงว่าได้รับคำสั่งแล้ว

• วางไฟล์วิดีโอในไดเรกทอรีผิด (ต้องอยู่ใน SoftPlayerMedia\Video\ ไม่ใช่รากโปรแกรม)
• พอร์ตผิด (ค่าเริ่มต้นคือ 7600 ไม่ใช่พอร์ตคอนโซลจัดการ 8766)

เชี่ยวชาญรูปแบบคำสั่งและเข้าใจการตอบสนองสำเร็จและล้มเหลว

1. รูปแบบคำสั่ง: คำสั่ง:อาร์กิวเมนต์ เช่น video:show.mp4 หรือ volume:80
2. คำสั่งที่ไม่มีอาร์กิวเมนต์ส่งได้เพียงชื่อคำสั่ง (โคลอนเป็นตัวเลือก) เช่น play
3. รูปแบบการตอบสนองสำเร็จ: OK:คำสั่งเดิม เช่น OK:video:show.mp4
4. รูปแบบการตอบสนองล้มเหลว: ERR:คำสั่งเดิม:ข้อความผิดพลาด
5. สำหรับเส้นทางไฟล์สื่อ ต้องการเฉพาะชื่อไฟล์ — เครื่องเล่นค้นหาในไดเรกทอรีย่อยที่สอดคล้องกันโดยอัตโนมัติ: video: ค้นใน SoftPlayerMedia/Video/

• การตอบสนองที่มีคำนำหน้า OK หลังส่งคำสั่งยืนยันรูปแบบและการดำเนินการถูกต้อง
• การตอบสนอง ERR มีเหตุผลเฉพาะ (ไม่พบไฟล์ ข้อผิดพลาดรูปแบบ ฯลฯ)

หากต้องการระบุไดเรกทอรีย่อย ใช้เครื่องหมายสแลช: video:subfolder/video.mp4 ค้นใน SoftPlayerMedia/Video/subfolder/

เชี่ยวชาญคำสั่งที่เกี่ยวข้องกับการเล่นวิดีโอทั้งหมด

1. เล่นวิดีโอภายในเครื่อง: video:ชื่อไฟล์.mp4 (ค้นใน Video directory)
2. เล่นสตรีมวิดีโอเครือข่าย: webvideo:URL (รองรับ HTTP/HTTPS/RTSP/RTMP/UDP streams)
3. เล่น/ดำเนินต่อ: play: (ดำเนินต่อสื่อที่หยุดชั่วคราว)
4. หยุดชั่วคราว: pause: (หยุดสื่อปัจจุบันชั่วคราว)
5. หยุดและกลับสแตนด์บาย: stop: (กลับหน้าต้อนรับ / ลูปสแตนด์บาย)
6. หยุดสมบูรณ์ / หน้าจอดำ: stoped: (ประหยัดพลังงานหน้าจอดำ)
7. เล่นซ้ำสื่อปัจจุบัน: replay:
8. ควบคุมตำแหน่ง: seek:มิลลิวินาที (ข้ามไปตำแหน่ง), forward: (ข้ามไปข้างหน้า 10 วินาที), backward: (ย้อนกลับ 10 วินาที)
9. ความเร็วการเล่น: speed:1.5 (รองรับ 1.5x, 2.0x ฯลฯ)

• หลังคำสั่ง video: เครื่องเล่นเริ่มเล่นไฟล์ที่ระบุ
• หลังคำสั่ง stop: กลับหน้าจอสแตนด์บาย (ถ้ากำหนดค่าไฟล์สแตนด์บาย)

• สำหรับสแตนด์บายระยะยาวในนิทรรศการ ใช้ standby: เพื่อลูปไฟล์สแตนด์บายแทน stoped: หน้าจอดำ (หน้าจอดำอาจทำให้ผู้เข้าชมคิดว่าอุปกรณ์เสีย)
• stop และ stoped มีความหมายต่างกัน: stop กลับหน้าต้อนรับ; stoped แสดงหน้าจอดำล้วน

เชี่ยวชาญคำสั่งปรับระดับเสียงและควบคุมการเล่นเสียง

1. ตั้งระดับเสียง (0-100): volume:80 (ตั้งเป็นค่าที่แน่นอน)
2. เพิ่มระดับเสียง 10%: volup: (เพิ่ม 10% ต่อการเรียก)
3. ลดระดับเสียง 10%: voldown: (ลด 10% ต่อการเรียก)
4. สลับปิดเสียง: mute: (สลับระหว่างปิดและเปิดเสียง)
5. ปิดเสียงชัดเจน: muteon:
6. เปิดเสียงชัดเจน: muteoff:
7. เล่นไฟล์เสียง: audio:ชื่อไฟล์.mp3 (ค้นใน SoftPlayerMedia/Audio/)
8. หยุดเสียง: audiostoped:

• หลัง volume:50 ระดับเสียงเครื่องเล่นลดลงเหลือ 50%
• mute: สลับระหว่างมีเสียงและเงียบ

เชี่ยวชาญคำสั่งรายการลูป การแบ่งหน้า PPT และการโหลดเว็บ

1. ลูปเพลย์ลิสต์: listloop:ไฟล์1.mp4;ไฟล์2.mp4;ไฟล์3.mp4 (คั่นไฟล์ด้วยเครื่องหมายเซมิโคลอน)
2. เล่นตามลำดับ (หยุดเมื่อจบ): liststop:ชื่อไฟล์
3. แทร็กถัดไป: next: แทร็กก่อนหน้า: prev:
4. เปิด PPT แบบเต็มจอ: ppt:ชื่อไฟล์.pptx (ค้นใน SoftPlayerMedia/PPT/)
5. นำทาง PPT: ppt:next (สไลด์ถัดไป), ppt:prev (ก่อนหน้า), ppt:home (แรก), ppt:end (สุดท้าย)
6. ข้ามไปสไลด์: ppt:goto-5 (ข้ามไปหน้า 5)
7. เลื่อน PPT อัตโนมัติ: ppt:auto-5-ชื่อไฟล์.pptx (เลื่อนอัตโนมัติทุก 5 วินาที)
8. โหลดหน้าเว็บ: web:URL (แสดง URL ที่ระบุแบบเต็มจอ)

• หลังคำสั่ง listloop: เครื่องเล่นวนซ้ำไฟล์ที่ระบุ
• ppt:next เลื่อน PPT ไปสไลด์ถัดไป

• ไฟล์ PPT ต้องวางใน SoftPlayerMedia/PPT/ ก่อนส่งคำสั่ง
• สำหรับไฟล์ PDF คำสั่งจะใช้หน้าต่างผู้ดูพร้อมการแบ่งหน้าด้วยการกดแป้นจำลอง
• ใช้ listloop สำหรับสถานการณ์ลูปนิทรรศการแทนการส่งคำสั่งแต่ละรายการด้วยตนเอง

เข้าใจคำสั่งมาสก์และระดับระบบ

1. แสดงเลเยอร์มาสก์: openmask: (วางเลเยอร์มาสก์บนวิดีโอ)
2. ซ่อนเลเยอร์มาสก์: closemask:
3. ตั้งพฤติกรรมสิ้นสุดการเล่น: endbehavior:Stop / Loop / Standby
4. รับเวอร์ชัน: version: (การตอบสนองมีข้อมูลเวอร์ชันปัจจุบัน)
5. รีสตาร์ทเครื่องเล่น: restart: (รีสตาร์ทกระบวนการเครื่องเล่นจากระยะไกล)

• หลัง openmask: เลเยอร์มาสก์ปรากฏบนวิดีโอ
• หลัง version: ได้รับการตอบสนองพร้อมข้อมูลเวอร์ชัน

รู้ตำแหน่งที่ถูกต้องสำหรับไฟล์สื่อแต่ละประเภท

1. SoftPlayerMedia/Video/ — ไฟล์วิดีโอ (.mp4/.mkv/.avi ฯลฯ) ใช้โดยคำสั่ง video:
2. SoftPlayerMedia/StandBy/ — ไฟล์สแตนด์บาย ใช้โดยคำสั่ง standby: และลูปเริ่มต้น
3. SoftPlayerMedia/Audio/ — ไฟล์เสียง (.mp3/.wav/.flac ฯลฯ) ใช้โดยคำสั่ง audio:
4. SoftPlayerMedia/BackgroundAudio/ — เสียงพื้นหลัง ลูปอัตโนมัติเมื่อเปิดใช้งาน
5. SoftPlayerMedia/PPT/ — ไฟล์ PPT/PDF ใช้โดยคำสั่ง ppt:
6. SoftPlayerMedia/Mask/ — ภาพมาสก์ ใช้โดยคำสั่ง openmask:
7. SoftPlayerMedia/Thumbnail/ — ไดเรกทอรีแคชรูปขนาดเล็ก (สร้างอัตโนมัติ ไม่ต้องเพิ่มไฟล์ด้วยตนเอง)

• หลังวางวิดีโอใน Video/ คำสั่ง video:ชื่อไฟล์ เล่นได้ถูกต้อง
• โครงสร้างไดเรกทอรีสร้างอัตโนมัติเมื่อเปิดครั้งแรก — ไม่ต้องตั้งค่าด้วยตนเอง

จัดการไฟล์สื่อประจำวันผ่านคอนโซลจัดการเบราว์เซอร์

1. เปิด http://IP-เครื่องเล่น:8766/ ในเบราว์เซอร์เพื่อเข้าคอนโซลจัดการ
2. คลิกนำทางด้านบนเพื่อสลับไปแท็บ Files
3. เลือกไดเรกทอรีเป้าหมาย (Video / StandBy / Audio / PPT ฯลฯ)
4. คลิก Upload เพื่อเลือกไฟล์ หรือลากไฟล์ไปยังพื้นที่อัปโหลด
5. รองรับการสร้างโฟลเดอร์ เปลี่ยนชื่อ ลบไฟล์/โฟลเดอร์ และดาวน์โหลดไฟล์
6. ไฟล์รองรับสูงสุด 3 ระดับไดเรกทอรีย่อย เลือกไดเรกทอรีปัจจุบันเมื่ออัปโหลด

• ไฟล์ที่อัปโหลดใหม่ปรากฏในรายการไฟล์หลังอัปโหลด
• คำสั่ง video:ชื่อไฟล์ เล่นไฟล์ที่เพิ่งอัปโหลดได้สำเร็จ

• คอนโซลใช้ Basic Auth — กำหนดค่าชื่อผู้ใช้/รหัสผ่านใน appsettings.json
• ขีดจำกัดการอัปโหลดไฟล์เดียวเริ่มต้น 500MB กำหนดค่าได้ในไฟล์คอนฟิก
• เจ้าหน้าที่บำรุงรักษาหน้างานสามารถอัปโหลดเนื้อหาทดแทนผ่านคอนโซลโดยไม่ต้องใช้ RDP

เข้าใจกฎทดลองและวางแผนเวลาใบอนุญาตอย่างเหมาะสม

1. ทดลอง 30 วันเริ่มอัตโนมัติเมื่อเปิด SoftPlayer ครั้งแรก
2. ฟีเจอร์ครบในช่วงทดลอง รวมถึงการเล่นความละเอียดสูงและคำสั่ง UDP ทั้งหมด
3. ตรวจสอบวันทดลองที่เหลือในแท็บ Dashboard ของคอนโซลจัดการ
4. หลังทดลอง ต้องนำเข้ารหัสใบอนุญาตเพื่อใช้งานต่อ

• แท็บ Dashboard ของคอนโซลจัดการแสดงสถานะทดลองปัจจุบันและวันที่เหลือ
• คำสั่งตอบสนองปกติในช่วงทดลองโดยไม่มีข้อจำกัดฟีเจอร์

• ใช้ช่วงทดลองเพื่อทดสอบและรับมอบงานก่อนส่งมอบโครงการจริง
• ซื้อใบอนุญาตก่อนทดลองหมดเพื่อหลีกเลี่ยงการหยุดชะงักของนิทรรศการ

เลือกระดับใบอนุญาตที่เหมาะสมตามความต้องการความละเอียดนิทรรศการจริง

1. ใบอนุญาต Standard: รองรับสูงสุด 4K (3840×2160)
2. ใบอนุญาต Professional: รองรับสูงสุด 16K (15360×8640)
3. ข้อกำหนดฮาร์ดแวร์ 4K: Intel i3+, RAM 8GB, การ์ดจอออนบอร์ด (ไม่ต้องใช้ GPU แยก)
4. ข้อกำหนดฮาร์ดแวร์ 8K: Intel i5 gen 8+, RAM 16GB, GTX 1060+
5. ข้อกำหนดฮาร์ดแวร์ 16K: Intel i7+, RAM 32GB, RTX 3070+
6. หากไม่แน่ใจว่าต้องการระดับใด ใช้ทดลองเพื่อยืนยันข้อกำหนดความละเอียดจริงก่อนซื้อ

• ระดับใบอนุญาตตรงกับความละเอียดสูงสุดของอุปกรณ์แสดงผลในโครงการ
• ฮาร์ดแวร์เซิร์ฟเวอร์ตรงตามข้อกำหนดขั้นต่ำสำหรับความละเอียดเป้าหมาย

คอมพิวเตอร์ที่ไม่มี GPU แยกสามารถเล่น 4K และต่ำกว่าได้ (โปรแกรมใช้การถอดรหัสซอฟต์แวร์โดยอัตโนมัติ) แต่ 8K/16K ต้องใช้ GPU แยกที่รองรับ

นำเข้ารหัสใบอนุญาตเพื่ออัปเกรดจากทดลองเป็นเวอร์ชันเต็ม

1. ค้นหาฟิลด์ Device ID ในแท็บ Dashboard ของคอนโซลจัดการและคัดลอก
2. ให้ ID อุปกรณ์แก่ผู้จำหน่าย โดยระบุระดับที่ต้องการ (Standard/Professional)
3. หลังได้รับรหัสใบอนุญาต ไปที่แท็บ Configuration ในคอนโซลและค้นหาส่วน License Management
4. วางรหัสใบอนุญาตในช่องป้อนข้อมูลและคลิก Import License
5. หลังนำเข้าสำเร็จ สถานะใบอนุญาตใน Dashboard เปลี่ยนจาก Trial เป็น Standard หรือ Professional

• แท็บ Dashboard ของคอนโซลจัดการแสดงสถานะเวอร์ชันเต็ม (Standard หรือ Professional)
• การเล่นวิดีโอความละเอียดสูงไม่ถูกจำกัดอีกต่อไป

• ใช้รหัสใบอนุญาตกับอุปกรณ์ผิด (รหัสผูกกับอุปกรณ์ เครื่องใหม่ต้องมีรหัสใหม่)
• รอจนทดลองหมดอายุก่อนขอใบอนุญาต ทำให้นิทรรศการหยุดชะงัก

กู้คืนช่องทางควบคุมคำสั่ง UDP

1. ยืนยันว่า SoftPlayer กำลังทำงาน (มองเห็นในแถบงานหรือ Task Manager)
2. ตรวจสอบว่าพอร์ตในคำสั่งตรงกับการตั้งค่า UdpPort ใน appsettings.json (ค่าเริ่มต้น 7600)
3. ตรวจสอบว่า Windows Firewall อนุญาตการรับส่งข้อมูล UDP ขาเข้าบนพอร์ต 7600
4. หากเปิดใช้ IP whitelist (IpWhitelistEnabled: true) ยืนยันว่า IP ผู้ส่งอยู่ใน AllowedIps
5. ตรวจสอบแท็บ Log ของคอนโซลจัดการเพื่อดูบันทึกการรับคำสั่งเพื่อยืนยันว่าคำสั่งถึงเครื่องเล่น

• ล็อกคอนโซลจัดการแสดงบันทึกการรับคำสั่ง ยืนยันว่าช่อง UDP ทำงาน
• การส่ง volume:50 เปลี่ยนระดับเสียงเครื่องเล่น

• ทดสอบด้วย 127.0.0.1 (localhost) ก่อนเพื่อตัดปัญหาเครือข่ายก่อนใช้ IP จริง
• เมื่อส่งจาก SoftControl ให้ตรวจสอบว่าโปรโตคอลคำสั่ง UDP และพอร์ตของ SoftControl ตรงกับการกำหนดค่าของ SoftPlayer

วินิจฉัยและแก้ไขความล้มเหลวในการเล่นไฟล์สื่อ

1. ยืนยันว่าไฟล์วิดีโออยู่ใน SoftPlayerMedia\Video\ (ไม่ใช่ไดเรกทอรีรากโปรแกรม)
2. ชื่อไฟล์คำนึงถึงตัวพิมพ์ใหญ่-เล็ก — ยืนยันว่าชื่อในคำสั่งตรงกับชื่อไฟล์จริงรวมถึงนามสกุล
3. สำหรับไฟล์ในไดเรกทอรีย่อย ใส่เส้นทางสัมพัทธ์: video:subfolder/video.mp4
4. เรียกดูแท็บ Files ในคอนโซลจัดการเพื่อยืนยันว่าไฟล์มีอยู่จริง
5. สำหรับรูปแบบไฟล์ผิดปกติ ตรวจสอบล็อกคอนโซลจัดการเพื่อดูข้อความข้อผิดพลาด VLC
6. ลองเปิดไฟล์เดียวกันด้วย VLC Player บนเครื่องโดยตรงเพื่อตัดไฟล์เสียหาย

• ไฟล์เป้าหมายมองเห็นได้ในรายการไฟล์คอนโซลจัดการ
• ชื่อไฟล์ในคำสั่งตรงกับที่แสดงในรายการไฟล์

• ชื่อไฟล์ในคำสั่งมีช่องว่างหรืออักขระแบบ full-width ทำให้ไม่พบไฟล์
• นามสกุลไฟล์ตัวพิมพ์ไม่ตรงกัน (เช่น คำสั่งใช้ .MP4 แต่ไฟล์จริงเป็น .mp4)

แก้ไขปัญหาประสิทธิภาพการเล่นวิดีโอความละเอียดสูง

1. ยืนยันระดับใบอนุญาตปัจจุบันก่อน: Standard รองรับเฉพาะ 4K; Professional รองรับ 16K
2. ตรวจสอบว่า GPU รองรับการถอดรหัสฮาร์ดแวร์ (GTX 1060+ หรือเทียบเท่าจำเป็นสำหรับ 8K)
3. ในแท็บ Performance ของ Task Manager ตรวจสอบการใช้งานการถอดรหัส GPU — ใกล้ 100% หมายถึงคอขวด GPU
4. ตรวจสอบข้อกำหนดความเร็วอ่านดิสก์: 4K ต้องการ 25-50 Mbps, 8K ต้องการ 80-100 Mbps, 16K ต้องการ 200+ Mbps
5. จัดเก็บไฟล์วิดีโอความละเอียดสูงบน SSD เพื่อหลีกเลี่ยงคอขวดการอ่าน HDD
6. สำหรับการปรับพารามิเตอร์ VLC ดูเอกสารในตัว (docs\User Manual.html) ในไดเรกทอรีโปรแกรม

• ระดับใบอนุญาตตรงกับความละเอียดการเล่นที่ต้องการ
• ฮาร์ดแวร์ตรงตามข้อกำหนดขั้นต่ำสำหรับความละเอียดเป้าหมาย

กู้คืนการเข้าถึงคอนโซลจัดการเบราว์เซอร์

1. ยืนยันว่า SoftPlayer กำลังทำงาน
2. ลอง http://localhost:8766/ ในเครื่องเองก่อนเพื่อตัดปัญหาเครือข่าย
3. ตรวจสอบ appsettings.json เพื่อยืนยันว่า HttpMonitor.Enabled เป็น true และพอร์ตคือ 8766
4. ตรวจสอบว่า Windows Firewall อนุญาตการรับส่งข้อมูล TCP บนพอร์ต 8766
5. หากพอร์ตถูกครอบครองโดยโปรแกรมอื่น เปลี่ยน HttpMonitor.Port ใน appsettings.json และรีสตาร์ท

• เบราว์เซอร์เข้าถึง http://localhost:8766/ ได้และแสดงคอนโซลจัดการ
• แท็บ Dashboard ของคอนโซลจัดการแสดงสถานะรันไทม์ของเครื่องเล่น