המדריכים האלה ממפים מושגים של תעשייה לאובייקטים שיש בפלטפורמה כיום (באוקטים, קווים, חבילות, חשבונות שותפים, צמתים, ה-API). אלה מיפויים מושגיים, לא יכולות ייעודיות לתעשייה, וחשבון שותף הוא חשבון מואצל, לא tenant מבודד.
מיפוי מושגי
שום דבר בלוח אינו נקרא קורס או סטודנט. הטבלה אומרת איזה אובייקט ממלא איזה תפקיד; הפרקים שלהלן מגדירים אותם בסדר הזה.
| בתעשייה שלכם | בפלטפורמה | איפה בלוח |
|---|---|---|
| מרכז הדרכה או שותף הפצה | חשבון שותף (מפיץ): לוח מואצל עם קרדיטים, הרשאות וקווים משלו | Users ← הוספת מפיץ; Groups להרשאותיו |
| אוסף קורסים | באוקט: קבוצה בעלת שם של ערוצים, סרטים או סדרות שחבילה מעניקה | Bouquets, מתוך Streams ו-Movies / Series |
| שיעורים מוקלטים | קטלוג VOD: סרטים וסדרות עם עונות ופרקים, קטגוריות ומטא-דאטה | Movies ו-Series, או משימת ingest של VOD |
| שיעור חי | ערוץ חי: שידור עם המקורות, ה-EPG ופורמטי הפלט שלו | Streams ← הוספת שידור חי (כתובת מקור או דחיפת RTMP) |
| גישת סטודנט | קו: גישה אחת עם החבילה, הבאוקטים, התפוגה, מגבלת החיבורים והפלטים שלה | Lines ← הוספה, או קודי הפעלה, או ה-Reseller API |
| תקופת הגישה לקורס | תאריך התפוגה של הקו, מתחדש בחבילה, בקרדיט או דרך ה-API | תאריך התפוגה של הקו ומשך החבילה |
| מגבלת סשנים בו-זמניים | מספר החיבורים המרבי של הקו: כמה מכשירים יכולים לצפות בו-זמנית | מספר החיבורים המרבי של הקו |
| אינטגרציה עם LMS או מסחר | Reseller API ו-webhooks: פעולות הלוח מהמערכת שלכם | מפתחות Reseller API ו-webhooks בלוח של המפיץ |
דרישות מקדימות
מה צריך שיהיה לפני ההתקנה.
- שרת Linux (Ubuntu 22.04 או 24.04) ברשת הקמפוס, שהמתקין מתקין עליו Postgres, Redis ו-ffmpeg, ודומיין או כתובת פנימית ללוח ולנגן.
- ההקלטות שתפרסמו (קבצים או מערכת הקלטה שיכולה לדחוף RTMP) ולשיעורים חיים, מקודד בכל חדר שישדר.
- מפתח רישיון: תוכנית Free לא צריכה כזה; מוסדות זכאים מבקשים את מפתח Professional החינמי בדוא"ל מהדומיין האקדמי שלהם.
פריסת התשתית
התקינו את שרת הניהול, ואז צומת לכל בניין.
- הריצו את המתקין על שרת הניהול; הוא מתקין את הלוח, ה-API, ה-worker והמקור כיחידות systemd ויוצר את המנהל הראשון.
- הגדירו את הכתובת הציבורית של ה-API (API_PUBLIC_URL) ואת בסיס הניגון כדי שקישורי הנגן יצביעו על כתובת הקמפוס.
- רשמו צומת דרך Servers ← הוספת צומת לכל בניין שהאולמות שלו יצפו; הלוח מתקין אותו דרך SSH מחבילת הצומת.
- בדקו את עמוד Servers: הצומת מדווח heartbeat ותעבורה, והצופים בבניין הזה מנותבים אליו.
ארגון התוכן
קורסים כסדרות, תוכניות כבאוקטים וחבילות.
- צרו קטגוריה אחת לכל פקולטה או נושא תחת Movies / Series.
- הוסיפו כל קורס כסדרה: עונה אחת לכל מודול, פרק אחד לכל שיעור, כשההקלטה היא המקור (העלאה או משימת ingest של VOD).
- צרו באוקט אחד לכל אוסף קורסים (למשל הקורסים של תוכנית לסמסטר) מהסדרות שהוספתם.
- צרו חבילה אחת לכל תוכנית לימודים: הבאוקטים שהיא מעניקה, תקופת הגישה כמשך, ומגבלת הסשנים הבו-זמניים.
הגדרת שותפים (מפיצים)
מרכז הדרכה או פקולטה כחשבון מואצל.
- צרו ב-Groups קבוצה עם ההרשאות שהמרכז צריך (קווים משלו, בלי שינויים בקטלוג).
- הוסיפו את המרכז ב-Users כמפיץ עם הקבוצה הזו, יתרת קרדיטים והחבילות שהוא רשאי להעניק.
- תנו לו את כתובת הלוח; הוא מנהל משם את הסטודנטים שלו, והלוח שומר את יומן הביקורת.
הגדרת גישה לסטודנטים
קו אחד לכל סטודנט, נוצר בהרשמה.
- לקבוצות קטנות, הוסיפו קווים דרך Lines ← הוספה עם חבילת התוכנית; התפוגה נגזרת ממשך החבילה.
- ליום ההרשמה, צרו קודי הפעלה לחבילה; סטודנט מממש קוד בנגן ומקבל קו.
- למערכת סטודנטים או ל-LMS, צרו מפתח Reseller API ואפשרו למערכת ליצור קווים עם action=create_line ומזהה בקשה לכל סטודנט.
- הגדירו את מספר החיבורים המרבי למספר המכשירים שסטודנט רשאי להשתמש בהם בו-זמנית; הנגן דוחה את החיבור הבא מעבר לכך.
הגדרת VOD
שיעורים מוקלטים לפי דרישה.
- העלו כל הקלטה כמקור של פרק, או הפנו את משימת ingest של VOD לקובץ ואפשרו ל-worker להוריד ולקודד אותו אל שורש המדיה.
- מלאו את המטא-דאטה (כותרת, תיאור, פוסטר) ידנית או מ-TMDB לחומר ציבורי; לשיעורים בדרך כלל מספיקים כותרת ותיאור.
- בדקו את הניגון בנגן האינטרנט עם קו בדיקה; הקישור חתום ופג אחרי הזמן שהוגדר.
שידור חי של שיעורים
הרצאה כערוץ חי.
- הוסיפו שידור חי תחת Streams כשהמקודד של החדר הוא המקור (כתובת דחיפת RTMP או כתובת משיכה).
- הכניסו את השידור לבאוקט של הקורס כדי שרק סטודנטים רשומים יראו אותו; הוסיפו אותו ל-EPG אם אתם מנהלים מערכת שעות.
- הפעילו catch-up או timeshift על השידור כשסטודנטים רשאים לצפות בשיעור מאוחר יותר; אפשר גם להעלות את ההקלטה כפרק.
מנוי ותפוגת גישה
גישה שמסתיימת עם הקורס.
- קבעו את תקופת הגישה כמשך החבילה; קו שנוצר ממנה פג בסוף התקופה הזו.
- חדשו קו לסמסטר חדש מהלוח, עם קרדיט של המרכז, או דרך ה-API עם action=renew_line.
- הירשמו ל-webhooks מהמערכת שלכם: היא תקבל הודעה כשקו עומד לפוג, פג או הושבת.
אינטגרציה עם LMS חיצוני
ה-LMS מנהל את הגישה; הנגן מנגן.
- צרו מפתח Reseller API ל-LMS; שמרו אותו בסודות של ה-LMS, לעולם לא בעמוד.
- בהרשמה ה-LMS קורא ל-action=create_line עם חבילת התוכנית ומזהה בקשה; בנשירה ל-action=disable_line.
- קשרו מדף הקורס ב-LMS לנגן האינטרנט או תנו לסטודנט את פרטי הנגן; אין התחברות יחידה (SSO) בין השניים.
שיקולי אבטחה
שמרו את השירות בתוך המוסד.
- הפעילו התחברות דו-שלבית לכל חשבון בלוח ותנו לצוות את קבוצת ההרשאות הקטנה ביותר שעובדת.
- שמרו את הנתונים האישיים של הסטודנטים במערכת הסטודנטים; הקו צריך רק שם ותפוגה.
- שמרו על מספר חיבורים מרבי נמוך ושקלו לקשור את הניגון לכתובת הצופה כדי למנוע שיתוף.
- הפעילו את גיבוי מסד הנתונים המוצפן, ואם יש לכם אחסון תואם S3, את העותק מחוץ לאתר.
פתרון תקלות
הבדיקות הראשונות הרגילות.
- סטודנט לא מצליח להתחבר: בדקו את תפוגת הקו ושהוא מופעל, ואז את החבילה ואת הבאוקט של הקורס.
- הקלטה לא מתנגנת: בדקו את תוצאת משימת ה-ingest בעמוד Jobs, ואז את הקובץ בשורש המדיה ואת תפוגת הקישור החתום.
- צופי בניין מגיעים למקור: בדקו את ה-heartbeat של הצומת ושכתובת הצופה נמצאת בניתוב של הצומת.
- ה-API דוחה קריאה: בדקו את המפתח, את שיטת הפעולה (כתיבות הן POST) ואת מזהה הבקשה בקריאה חוזרת.