המדריכים האלה ממפים מושגים של תעשייה לאובייקטים שיש בפלטפורמה כיום (באוקטים, קווים, חבילות, חשבונות שותפים, צמתים, ה-API). אלה מיפויים מושגיים, לא יכולות ייעודיות לתעשייה, וחשבון שותף הוא חשבון מואצל, לא tenant מבודד.
מיפוי מושגי
שום דבר בלוח לא נקרא גלריה או חבר. הטבלה אומרת איזה אובייקט ממלא איזה תפקיד; הפרקים שלמטה מגדירים אותם בסדר הזה.
| בתעשייה שלכם | בפלטפורמה | איפה בלוח |
|---|---|---|
| סרט תערוכה וארכיון | קטלוג VOD: סרטים וסדרות עם עונות ופרקים, קטגוריות ומטא-דאטה | Movies ו-Series, או משימת ingest של VOD |
| שידור פתיחה או הרצאה | ערוץ חי: שידור עם המקורות, ה-EPG ופורמטי הפלט שלו | Streams ← הוספת שידור חי (כתובת מקור או דחיפת RTMP) |
| אוסף גלריות או חברים | באוקט: קבוצה בעלת שם של ערוצים, סרטים או סדרות שחבילה מעניקה | Bouquets, מתוך Streams ו-Movies / Series |
| גישת מבקר או חבר | קו: גישה אחת עם החבילה, הבאוקטים, התפוגה, מגבלת החיבורים והפלטים שלה | Lines ← הוספה, או קודי הפעלה, או ה-Reseller API |
| תקופת החברות | תאריך התפוגה של הקו, מתחדש בחבילה, בקרדיט או דרך ה-API | תאריך התפוגה של הקו ומשך החבילה |
| מכשירים לכל חבר | מספר החיבורים המרבי של הקו: כמה מכשירים יכולים לצפות בו-זמנית | מספר החיבורים המרבי של הקו |
דרישות מקדימות
מה צריך שיהיה לפני ההתקנה.
- שרת בבניין (Ubuntu 22.04 או 24.04), המתקין, ורשת הגלריות שהמסכים ומכשירי החברים ישתמשו בה.
- סרט התערוכה, הקלטות הארכיון שיש לכם זכויות עליהן, מקודד לאולם ההרצאות, והמסכים או נגני המדיה לגלריות.
- מפתח הרישיון, ואם אין אינטרנט בבניין, נוהל ההפעלה הלא מקוונת; והחלטה מי בדלפק מוכר חברויות.
פריסת התשתית
השרת בבניין, מופעל במקום.
- הריצו את המתקין על השרת וקבעו את כתובת בסיס הניגון לכתובת שרשת הגלריות מגיעה אליה.
- הפעילו את מפתח הרישיון במצב לא מקוון מהלוח; לאחר ההפעלה השירות פועל ברשת המקומית בלי אינטרנט.
- הוסיפו את סרט התערוכה תחת Movies ואת פיד אולם ההרצאות תחת Streams, ובדקו אותם בנגן האינטרנט.
- לאתר שני או לתוכנית ציבורית גדולה, רשמו צומת מ-Servers; הלוח מתקין אותו דרך SSH ומנתב אליו את צופי האתר.
ארגון התוכן
גלריות, ארכיון ואוספי חברים.
- צרו קטגוריות לכל תערוכה ולכל שנה, וסדרה למחזור הרצאות עם פרק אחד לכל הרצאה.
- צרו באוקט אחד למסכי הגלריות ואחד לספריית החברים של הרצאות וסרטי ארכיון.
- צרו חבילה לגלריות וחבילה לכל סוג חברוּת, כל אחת מעניקה את הבאוקטים שלה; משך חבילת החברוּת הוא תקופת החברוּת.
- הוסיפו פוסטרים ותיאורים קצרים לכל סרט כדי שהספרייה תיקרא היטב בנגן.
הגדרת שותפים (מפיצים)
הדלפק והחנות כחשבונות מואצלים.
- צרו קבוצה עם הרשאות מוגבלות לקווים ולקודי הפעלה, וללא גישה לקטלוג או לשרתים.
- הוסיפו את הדלפק, או את החנות, כמפיץ עם הקבוצה הזו, חבילות החברוּת ויתרת קרדיטים.
- מרכז תרבות שמפעיל כמה אתרים יכול להוסיף מפיץ לכל אתר, וכל אחד מוכר חברויות מהיתרה שלו.
הגדרת גישת מבקרים וחברים
מסכים וחברים על קווים.
- צרו קו אחד לכל מסך גלריה תחת Lines → add עם חבילת הגלריות, וקשרו אותו לכתובת המסך כשהרשת נותנת כתובות קבועות.
- צרו קודי הפעלה בדלפק לכל חברוּת שנמכרת; החבר מזין את הקוד בנגן והקו מתחיל.
- קבעו את מספר החיבורים המרבי לכל חברוּת למספר המכשירים שחבר רשאי להשתמש בהם, בדרך כלל שניים.
- מסרו לחבר את אפליקציית הנגן, רשימת M3U או כתובת נגן האינטרנט, מה שמתאים למכשיר שלו.
סרט תערוכה וארכיון
הספרייה לפי דרישה.
- העלו את סרט התערוכה ואת הארכיון הדיגיטלי כסרטים, או ייבאו אותם עם משימת ייבוא ה-VOD אל שורש המדיה.
- הוסיפו מטא-דאטה מ-TMDB היכן שקיים, וכתבו בעצמכם כותרת ותיאור לשאר.
- שמרו את הארכיון שאינו לציבור באוקט החברים בלבד, ובדקו מה כל חבילה רואה עם קו בדיקה.
פתיחות והרצאות
אירוע כערוץ חי.
- הוסיפו שידור חי למקודד אולם ההרצאות (דחיפת RTMP) והציבו אותו בבאוקט החברים, או בבאוקט הגלריות לפתיחה שמוצגת על המסכים.
- הפעילו צפייה בדיעבד כדי שחבר שמגיע באיחור יוכל לחזור אחורה, והעלו את ההקלטה לספרייה אחר כך.
- בדקו את המקודד ואת השידור לפני האירוע עם קו בדיקה, באותה רשת שהקהל ישתמש בה.
תפוגה וחידוש חברוּת
החברוּת כתוקף הקו.
- קו פוקע בסוף תקופת החבילה שלו; חידוש בדלפק מוסיף תקופה נוספת.
- השביתו קו כשחברוּת מבוטלת; קודי הפעלה שמעולם לא נוצלו נשארים ללא שימוש עד שהם נפדים.
- הירשמו ב-webhooks בחנות או במערכת החברוּת כדי לראות קווים שעומדים לפוג או שכבר פגו.
אינטגרציה עם החנות או מערכת החברוּת
מערכות מוכרות את הגישה; הנגן מנגן.
- צרו מפתח Reseller API לחנות או למערכת החברוּת; היא קוראת ל-create_line, renew_line ו-disable_line, עם מזהה בקשה בכל כתיבה.
- השתמשו במחבר מסחר כשחברויות נמכרות ברשת; כל מערכת אחרת משתמשת ב-Reseller API וב-webhooks.
- אין כניסה אחודה לצופים: חבר נכנס לנגן עם פרטי הקו או קוד ההפעלה.
שיקולי אבטחה
שמרו את האוספים במקומם.
- הפרידו את רשת הגלריות מרשת המבקרים, והגישו כל גישה ציבורית מאחורי reverse proxy עם TLS ו-TRUSTED_PROXIES מוגדר.
- כניסה דו-שלבית לכל חשבון לוח; הדלפק מקבל קבוצת הרשאות המוגבלת לקווים ולקודים.
- קישורי ניגון חתומים ופוקעים, מגבלת חיבורים לכל חברוּת, וקשירה לכתובת למסכי הגלריה.
- הפעילו את הגיבוי המוצפן של מסד הנתונים עם עותק מחוץ לאתר, והשתמשו ביומן הביקורת לסקירת שינויים בקווים ובקטלוג.
פתרון תקלות
הבדיקות הראשונות הרגילות.
- מסך גלריה שחור: בדקו שהקו שלו מופעל ולא פג, את הקשירה לכתובת המסך, ושהשרת נגיש ברשת הגלריות.
- קוד של חבר לא עובד: בדקו שהקוד לא נפדה כבר ושהחבילה שהוא פותח עדיין משויכת לדלפק.
- הפעלת הרישיון נכשלת במצב לא מקוון: בדקו את קובץ ההפעלה מול מפתח הרישיון ואת שעון השרת.
- הפתיחה החיה מגמגמת: בדקו את קצב הסיביות של המקודד מול קו היציאה ואת סטטוס השידור תחת Streams.