המדריכים האלה ממפים מושגים של תעשייה לאובייקטים שיש בפלטפורמה כיום (באוקטים, קווים, חבילות, חשבונות שותפים, צמתים, ה-API). אלה מיפויים מושגיים, לא יכולות ייעודיות לתעשייה, וחשבון שותף הוא חשבון מואצל, לא tenant מבודד.
מיפוי מושגי
שום דבר בלוח אינו נקרא חדר או שהות. הטבלה אומרת איזה אובייקט ממלא איזה תפקיד; הפרקים שלהלן מגדירים אותם בסדר הזה.
| בתעשייה שלכם | בפלטפורמה | איפה בלוח |
|---|---|---|
| מפעיל מלון או שותף מורשה | חשבון שותף (מפיץ): לוח מואצל עם קרדיטים, הרשאות וקווים משלו | Users ← הוספת מפיץ; Groups להרשאותיו |
| חבילת ערוצים | באוקט: קבוצה בעלת שם של ערוצים, סרטים או סדרות שחבילה מעניקה | Bouquets, מתוך Streams ו-Movies / Series |
| חדר או מכשיר | קו: גישה אחת עם החבילה, הבאוקטים, התפוגה, מגבלת החיבורים והפלטים שלה | Lines ← הוספה, או קודי הפעלה, או ה-Reseller API |
| סרטוני מידע של המלון | קטלוג VOD: סרטים וסדרות עם עונות ופרקים, קטגוריות ומטא-דאטה | Movies ו-Series, או משימת ingest של VOD |
| ערוצי טלוויזיה מורשים | ערוץ חי: שידור עם המקורות, ה-EPG ופורמטי הפלט שלו | Streams ← הוספת שידור חי (כתובת מקור או דחיפת RTMP) |
| משך השהות | תאריך התפוגה של הקו, מתחדש בחבילה, בקרדיט או דרך ה-API | תאריך התפוגה של הקו ומשך החבילה |
| צומת אחד לכל בניין או אגף | צמתי הזרמה: שרתי קצה שנרשמו מהלוח, אחד לכל אתר או בניין | Servers ← הוספת צומת, מותקן דרך SSH |
דרישות מקדימות
מה צריך שיהיה לפני ההתקנה.
- שרת ברשת הנכס (Ubuntu 22.04 או 24.04), המתקין, וכתובת שמכשירי החדרים יכולים להגיע אליה.
- פידי הערוצים שיש לנכס זכויות עליהם (כתובות משיכה או RTMP), סרטוני המידע של המלון ומכשירי החדרים (ממירי Android TV, מכשירי MAG או Enigma2, טלוויזיות חכמות עם אפליקציית נגן או דפדפן).
- היכולת של ה-PMS לקרוא ל-API מעל HTTP בצ'ק-אין ובצ'ק-אאוט, או נוהל בקבלה לביצוע זה בלוח.
פריסת התשתית
השרת המרכזי וצומת לכל בניין.
- הריצו את המתקין על השרת המרכזי; קבעו את בסיס הניגון לכתובת הפנימית של הנכס כדי שהחדרים יישארו ברשת המקומית.
- הוסיפו את פידי הערוצים תחת Streams ואת סרטוני המידע תחת Movies; בדקו אותם בנגן האינטרנט.
- רשמו צומת לכל אגף או בניין דרך Servers; הלוח מתקין אותו דרך SSH ומנתב אליו את חדרי הבניין.
- הגדירו את מפתח הרישיון בשרת; ההפעלה מתבצעת במקום והשירות פועל בלי הקו החיצוני.
ארגון התוכן
חבילות ערוצים וסרטוני מלון.
- צרו באוקט אחד לכל חבילת ערוצים (חדרים רגילים, סוויטות, כנסים) מערוצי הנכס.
- צרו באוקט של סרטוני המלון (ברוכים הבאים, מתקנים, בטיחות) והוסיפו אותו לכל חבילה.
- צרו חבילה אחת לכל קטגוריית חדר עם הבאוקטים שהיא מעניקה ומשך של יום אחד: בצ'ק-אין קו החדר מתחדש פעם אחת לכל לילה של השהות (כל חידוש מוסיף את משך החבילה), ובצ'ק-אאוט הוא מושבת (פרק 8).
- סדרו את הערוצים ותנו להם לוגואים כדי שהתפריט בטלוויזיה יהיה קריא.
הגדרת שותפים (מפיצים)
הנכס, או מפעיל של כמה נכסים, כחשבון מואצל.
- צרו קבוצה עם הרשאות מוגבלות לקווים (חדרים) וללא שינויים בקטלוג.
- הוסיפו את הקבלה של הנכס, או את המפעיל, כמפיץ עם הקבוצה הזו וחבילות החדרים.
- מפעיל של כמה נכסים מקבל מפיץ אחד לכל נכס, כל אחד עם החדרים והקרדיטים שלו.
הגדרת חדר (קו)
קו אחד לכל חדר, בשם מספר החדר.
- צרו קו אחד לכל חדר תחת Lines עם מספר החדר כשם וחבילת קטגוריית החדר.
- הגדירו את מספר החיבורים המרבי ל-1 (טלוויזיה אחת) או למספר המסכים בחדר.
- קשרו את הקו לכתובת מכשיר החדר כשהרשת נותנת למכשירים כתובות קבועות.
- הגדירו את המכשיר פעם אחת (Xtream Codes API או M3U עם פרטי הקו, או פורטל MAG / Enigma2); הפרטים נשארים בחדר.
סרטוני מידע של המלון
הסרטונים של הנכס עצמו לפי דרישה.
- העלו את סרטוני ברוכים הבאים והמידע כסרטים, עם גרסאות השפה של הנכס כערכים נפרדים או כרצועות שמע.
- הכניסו אותם לבאוקט סרטוני המלון כדי שכל קטגוריית חדר תקבל אותם.
- עדכנו אותם מהלוח בכל פעם שהמידע משתנה; החדרים רואים את הגרסה החדשה מיד.
ערוצי טלוויזיה מורשים
ערוצי הנכס כשידורים חיים.
- הוסיפו כל ערוץ מורשה תחת Streams עם הפיד שלו; הפעילו timeshift או catch-up רק במקום שהרישיון מאפשר.
- הוסיפו מקור EPG כדי שהמדריך בטלוויזיה יציג את התוכניות.
- שמרו ערוצים מוגבלים טריטוריאלית בבאוקטים שרק החבילות הנכונות מעניקות.
צ'ק-אין, צ'ק-אאוט ותפוגה
השהות כתוקף הקו.
- בצ'ק-אין הפעילו את קו החדר וחדשו אותו לאורך השהות (ה-PMS דרך ה-API, או הקבלה בלוח).
- בצ'ק-אאוט השביתו את הקו; שהות חדשה מפעילה אותו שוב, כך שהפרטים לעולם לא עוזבים את החדר.
- הירשמו מה-PMS או מהקבלה ל-webhooks כדי לראות קווים שהופעלו, הושבתו ופגו.
אינטגרציה עם ה-PMS
צ'ק-אין וצ'ק-אאוט מפעילים את החדרים.
- צרו מפתח Reseller API ל-PMS ושמרו אותו בהגדרות ה-PMS.
- בצ'ק-אין ה-PMS קורא ל-action=enable_line ול-action=renew_line עבור קו החדר עם מזהה בקשה; בצ'ק-אאוט ל-action=disable_line.
- אפליקציית שירותי האורחים (קריאה לצוות, משק בית, צ'ק-אאוט מהיר, שירות חדרים) והחיבור שלה ל-back-office הם חלק מתוכנית Enterprise ומוגדרים יחד עם הנכס.
שיקולי אבטחה
שמרו את הערוצים בתוך הנכס.
- השאירו את בסיס הניגון והצמתים ברשת הנכס; אל תחשפו לאינטרנט דבר שהחדרים לא צריכים.
- חיבור אחד לכל חדר, הקשור למכשיר; קישורים חתומים פגים, ולכן קישור שהועתק מפסיק לעבוד.
- התחברות דו-שלבית ללוח; הקבלה מקבלת קבוצת הרשאות מוגבלת.
- הפעילו את גיבוי מסד הנתונים המוצפן; פרטי החדרים נמצאים בו.
פתרון תקלות
הבדיקות הראשונות הרגילות.
- בחדר אין טלוויזיה: בדקו שהקו שלו מופעל ולא פג, ואז את הפרטים והכתובת של המכשיר.
- ערוץ חסר בחדר: בדקו את הבאוקט של החבילה של קטגוריית החדר.
- הטלוויזיה נעצרת בהפסקת אינטרנט: בדקו שבסיס הניגון והמקורות הם כתובות פנימיות; פידים חיצוניים תלויים בקו החיצוני.
- קריאת ה-PMS נכשלת: בדקו את מפתח ה-API, שכתיבות הן POST, ואת מזהה הבקשה בניסיונות חוזרים.