คู่มือเหล่านี้จับคู่แนวคิดของอุตสาหกรรมกับออบเจ็กต์ที่แพลตฟอร์มมีอยู่ในวันนี้ (bouquet ไลน์ แพ็กเกจ บัญชีพาร์ตเนอร์ node และ API) เป็นการจับคู่เชิงแนวคิด ไม่ใช่ฟีเจอร์เฉพาะอุตสาหกรรม และบัญชีพาร์ตเนอร์คือบัญชีที่มอบหมายสิทธิ์ ไม่ใช่ tenant ที่แยกขาด
การจับคู่เชิงแนวคิด
ไม่มีสิ่งใดในแผงควบคุมที่เรียกว่าห้องหรือการเข้าพัก ตารางบอกว่าออบเจ็กต์ใดทำหน้าที่อะไร บทด้านล่างตั้งค่าตามลำดับนั้น
| ในอุตสาหกรรมของคุณ | บนแพลตฟอร์ม | อยู่ที่ไหนในแผงควบคุม |
|---|---|---|
| ผู้ดำเนินการโรงแรมหรือพาร์ตเนอร์ที่ได้รับอนุญาต | บัญชีพาร์ตเนอร์ (รีเซลเลอร์): แดชบอร์ดที่มอบหมายสิทธิ์พร้อมเครดิต สิทธิ์ และไลน์ของตนเอง | Users → เพิ่มรีเซลเลอร์ กลุ่มสิทธิ์ที่ Groups |
| แพ็กเกจช่อง | Bouquet: ชุดช่อง ภาพยนตร์ หรือซีรีส์ที่มีชื่อ ซึ่งแพ็กเกจมอบให้ | Bouquets จาก Streams และ Movies / Series |
| ห้องหรืออุปกรณ์ | ไลน์: สิทธิ์เข้าใช้หนึ่งรายการพร้อมแพ็กเกจ bouquet วันหมดอายุ ขีดจำกัดการเชื่อมต่อ และเอาต์พุต | Lines → เพิ่ม หรือรหัสเปิดใช้งาน หรือ Reseller API |
| วิดีโอข้อมูลของโรงแรม | แคตตาล็อก VOD: ภาพยนตร์และซีรีส์พร้อมซีซันและตอน หมวดหมู่ และข้อมูลเมตา | Movies และ Series หรืองาน ingest VOD |
| ช่องโทรทัศน์ที่ได้รับอนุญาต | ช่องสด: สตรีมพร้อมแหล่งสัญญาณ EPG และรูปแบบเอาต์พุต | Streams → เพิ่มสตรีมสด (URL แหล่งสัญญาณหรือ RTMP push) |
| ระยะเวลาเข้าพัก | วันหมดอายุของไลน์ ต่ออายุด้วยแพ็กเกจ เครดิต หรือ API | วันหมดอายุของไลน์และระยะเวลาของแพ็กเกจ |
| หนึ่ง node ต่ออาคารหรือปีกอาคาร | node สตรีมมิง: เซิร์ฟเวอร์ edge ที่ลงทะเบียนจากแผงควบคุม หนึ่งเครื่องต่อสถานที่หรืออาคาร | Servers → เพิ่ม node ติดตั้งผ่าน SSH |
สิ่งที่ต้องเตรียม
สิ่งที่ควรมีก่อนติดตั้ง
- เซิร์ฟเวอร์บนเครือข่ายของสถานที่ (Ubuntu 22.04 หรือ 24.04) ตัวติดตั้ง และที่อยู่ที่อุปกรณ์ในห้องเข้าถึงได้
- ฟีดช่องที่สถานที่มีสิทธิ์ (URL สำหรับ pull หรือ RTMP) วิดีโอข้อมูลของโรงแรม และอุปกรณ์ในห้อง (กล่อง Android TV กล่อง MAG หรือ Enigma2 สมาร์ททีวีที่มีแอปเพลเยอร์หรือเบราว์เซอร์)
- ความสามารถของ PMS ในการเรียก HTTP API ตอนเช็กอินและเช็กเอาต์ หรือขั้นตอนที่แผนกต้อนรับทำในแผงควบคุม
การติดตั้งโครงสร้างพื้นฐาน
เซิร์ฟเวอร์กลางและ node ต่ออาคาร
- รันตัวติดตั้งบนเซิร์ฟเวอร์กลาง ตั้งฐานการเล่นเป็นที่อยู่ภายในของสถานที่เพื่อให้ห้องอยู่บนเครือข่ายภายใน
- เพิ่มฟีดช่องภายใต้ Streams และวิดีโอข้อมูลภายใต้ Movies ตรวจสอบในเว็บเพลเยอร์
- ลงทะเบียน node ต่อปีกอาคารหรืออาคารจาก Servers แผงควบคุมติดตั้งให้ผ่าน SSH และกระจายห้องของอาคารนั้นไปที่ node
- ตั้งคีย์ใบอนุญาตบนเซิร์ฟเวอร์ การเปิดใช้งานเกิดขึ้นในสถานที่ และบริการทำงานได้โดยไม่ต้องมีอินเทอร์เน็ตขาออก
การจัดระเบียบเนื้อหา
แพ็กเกจช่องและวิดีโอโรงแรม
- สร้างหนึ่ง bouquet ต่อแพ็กเกจช่อง (ห้องมาตรฐาน ห้องสวีท การประชุม) จากช่องของสถานที่
- สร้าง bouquet ของวิดีโอโรงแรม (ต้อนรับ สิ่งอำนวยความสะดวก ความปลอดภัย) และเพิ่มลงในทุกแพ็กเกจ
- สร้างหนึ่งแพ็กเกจต่อประเภทห้อง พร้อม bouquet ที่มอบให้และระยะเวลาหนึ่งวัน: เมื่อเช็คอิน ไลน์ของห้องจะถูกต่ออายุหนึ่งครั้งต่อคืนที่เข้าพัก (การต่ออายุแต่ละครั้งเพิ่มระยะเวลาของแพ็กเกจ) และเมื่อเช็คเอาต์จะถูกปิดใช้งาน (บทที่ 8)
- จัดลำดับช่องและใส่โลโก้ เพื่อให้เมนูบนโทรทัศน์อ่านง่าย
การตั้งค่าพาร์ตเนอร์ (รีเซลเลอร์)
สถานที่ หรือผู้ดำเนินการที่ดูแลหลายสถานที่ ในฐานะบัญชีที่มอบหมายสิทธิ์
- สร้างกลุ่มที่มีสิทธิ์จำกัดเฉพาะไลน์ (ห้อง) และไม่แก้ไขแคตตาล็อก
- เพิ่มแผนกต้อนรับของสถานที่ หรือผู้ดำเนินการ เป็นรีเซลเลอร์พร้อมกลุ่มนั้นและแพ็กเกจห้อง
- ผู้ดำเนินการหลายสถานที่ได้หนึ่งรีเซลเลอร์ต่อสถานที่ แต่ละรายมีห้องและเครดิตของตนเอง
การตั้งค่าห้อง (ไลน์)
หนึ่งไลน์ต่อห้อง ตั้งชื่อตามหมายเลขห้อง
- สร้างหนึ่งไลน์ต่อห้องภายใต้ Lines โดยใช้หมายเลขห้องเป็นชื่อและแพ็กเกจของประเภทห้อง
- ตั้งจำนวนการเชื่อมต่อสูงสุดเป็น 1 (โทรทัศน์หนึ่งเครื่อง) หรือเท่ากับจำนวนจอในห้อง
- ผูกไลน์กับที่อยู่ของอุปกรณ์ในห้องเมื่อเครือข่ายกำหนดที่อยู่คงที่ให้อุปกรณ์
- ตั้งค่าอุปกรณ์ (Xtream Codes API หรือ M3U พร้อมข้อมูลประจำตัวของไลน์ หรือพอร์ทัล MAG / Enigma2) ครั้งเดียว ข้อมูลประจำตัวอยู่กับห้อง
วิดีโอข้อมูลของโรงแรม
วิดีโอของสถานที่เองแบบตามสั่ง
- อัปโหลดวิดีโอต้อนรับและข้อมูลเป็นภาพยนตร์ โดยใช้เวอร์ชันภาษาต่าง ๆ ของสถานที่เป็นรายการแยกหรือแทร็กเสียง
- ใส่ไว้ใน bouquet วิดีโอโรงแรมเพื่อให้ทุกประเภทห้องได้รับ
- อัปเดตจากแผงควบคุมทุกครั้งที่ข้อมูลเปลี่ยน ห้องเห็นเวอร์ชันใหม่ทันที
ช่องโทรทัศน์ที่ได้รับอนุญาต
ช่องของสถานที่เป็นสตรีมสด
- เพิ่มแต่ละช่องที่ได้รับอนุญาตภายใต้ Streams พร้อมฟีดของช่อง เปิด timeshift หรือ catch-up เฉพาะที่ใบอนุญาตอนุญาต
- เพิ่มแหล่ง EPG เพื่อให้ผังรายการบนโทรทัศน์แสดงรายการ
- เก็บช่องที่จำกัดอาณาเขตไว้ใน bouquet ที่เฉพาะแพ็กเกจที่ถูกต้องมอบให้
เช็กอิน เช็กเอาต์ และการหมดอายุ
ช่วงเข้าพักเป็นระยะเวลาใช้งานของไลน์
- เมื่อเช็กอิน เปิดใช้งานไลน์ของห้องและต่ออายุตามความยาวของการเข้าพัก (PMS ผ่าน API หรือแผนกต้อนรับในแผงควบคุม)
- เมื่อเช็กเอาต์ ปิดใช้งานไลน์ การเข้าพักใหม่เปิดใช้งานอีกครั้ง ดังนั้นข้อมูลประจำตัวไม่เคยออกจากห้อง
- สมัครรับ webhook ด้วย PMS หรือแผนกต้อนรับเพื่อดูไลน์ที่เปิดใช้งาน ปิดใช้งาน และหมดอายุ
การเชื่อมต่อกับ PMS
การเช็กอินและเช็กเอาต์ควบคุมห้อง
- สร้าง Reseller API key สำหรับ PMS และเก็บไว้ในการตั้งค่าของ PMS
- เมื่อเช็กอิน PMS เรียก action=enable_line และ action=renew_line สำหรับไลน์ของห้องพร้อมรหัสคำขอ เมื่อเช็กเอาต์เรียก action=disable_line
- แอปบริการแขก (เรียกพนักงาน แม่บ้าน เช็กเอาต์ด่วน รูมเซอร์วิส) และการเชื่อมต่อ back-office เป็นส่วนหนึ่งของแผน Enterprise และกำหนดขอบเขตร่วมกับสถานที่
ข้อควรพิจารณาด้านความปลอดภัย
เก็บช่องไว้ภายในสถานที่
- เก็บฐานการเล่นและ node ไว้บนเครือข่ายของสถานที่ อย่าเปิดสิ่งใดสู่อินเทอร์เน็ตที่ห้องไม่จำเป็นต้องใช้
- หนึ่งการเชื่อมต่อต่อห้อง ผูกกับอุปกรณ์ ลิงก์ที่ลงนามหมดอายุ ดังนั้นลิงก์ที่คัดลอกไปจะใช้ไม่ได้
- เข้าสู่ระบบสองขั้นตอนสำหรับแผงควบคุม แผนกต้อนรับได้กลุ่มสิทธิ์ที่จำกัด
- เปิดการสำรองฐานข้อมูลแบบเข้ารหัส ข้อมูลประจำตัวของห้องอยู่ในนั้น
การแก้ไขปัญหา
สิ่งที่ตรวจสอบก่อนตามปกติ
- ห้องไม่มีโทรทัศน์: ตรวจสอบว่าไลน์เปิดใช้งานและยังไม่หมดอายุ จากนั้นตรวจข้อมูลประจำตัวและที่อยู่ของอุปกรณ์
- ช่องหายไปในห้อง: ตรวจ bouquet ของแพ็กเกจประเภทห้อง
- โทรทัศน์หยุดขณะอินเทอร์เน็ตขัดข้อง: ตรวจสอบว่าฐานการเล่นและแหล่งสัญญาณเป็นที่อยู่ภายใน ฟีดภายนอกขึ้นกับอินเทอร์เน็ตขาออก
- การเรียกจาก PMS ล้มเหลว: ตรวจสอบ API key ว่าการเขียนเป็น POST และรหัสคำขอเมื่อลองซ้ำ