בית
XtreamUIPro

מדריך הקמה

מדריך הקמה ליוצרי מדיה ותוכן

הגדירו את הפלטפורמה כשירות ישיר לקהל של אולפן או יוצר: ערוץ 24/7, ספריית תוכניות, תומכים מהחנות שלכם ושותפים כחשבונות שותף.

המדריכים האלה ממפים מושגים של תעשייה לאובייקטים שיש בפלטפורמה כיום (באוקטים, קווים, חבילות, חשבונות שותפים, צמתים, ה-API). אלה מיפויים מושגיים, לא יכולות ייעודיות לתעשייה, וחשבון שותף הוא חשבון מואצל, לא tenant מבודד.

מיפוי מושגי

שום דבר בלוח לא נקרא תוכנית או תומך. הטבלה אומרת איזה אובייקט ממלא איזה תפקיד; הפרקים שלמטה מגדירים אותם בסדר הזה.

בתעשייה שלכםבפלטפורמהאיפה בלוח
ערוץ האולפןערוץ חי: שידור עם המקורות, ה-EPG ופורמטי הפלט שלוStreams ← הוספת שידור חי (כתובת מקור או דחיפת RTMP)
ספריית תוכניותקטלוג VOD: סרטים וסדרות עם עונות ופרקים, קטגוריות ומטא-דאטהMovies ו-Series, או משימת ingest של VOD
דרגת מנויבאוקט: קבוצה בעלת שם של ערוצים, סרטים או סדרות שחבילה מעניקהBouquets, מתוך Streams ו-Movies / Series
גישת תומךקו: גישה אחת עם החבילה, הבאוקטים, התפוגה, מגבלת החיבורים והפלטים שלהLines ← הוספה, או קודי הפעלה, או ה-Reseller API
תקופת חיובתאריך התפוגה של הקו, מתחדש בחבילה, בקרדיט או דרך ה-APIתאריך התפוגה של הקו ומשך החבילה
חשבון שותף או מפיץחשבון שותף (מפיץ): לוח מואצל עם קרדיטים, הרשאות וקווים משלוUsers ← הוספת מפיץ; Groups להרשאותיו
אינטגרציה של חנות או חברוּתReseller API ו-webhooks: פעולות הלוח מהמערכת שלכםמפתחות Reseller API ו-webhooks בלוח של המפיץ

דרישות מקדימות

מה צריך שיהיה לפני ההתקנה.

  1. שרת (Ubuntu 22.04 או 24.04) עם כתובת ציבורית או דומיין, ומספיק רוחב פס יוצא לקהל הצפוי.
  2. הפרקים המוגמרים, מערכת השידור או המקודד של האולפן לערוץ, וחנות בפלטפורמה עם מחבר, או היכולת לקרוא ל-HTTP API.
  3. החלטה על דרגות ושותפים: מה כל מנוי מעניק, ומי רשאי למכור אותו.

פריסת התשתית

קודם שרת אחד, צמתים כשהקהל גדל.

  1. הריצו את המתקין על שרת הניהול והציבו את הלוח מאחורי reverse proxy עם TLS; הגדירו את הפרוקסים המהימנים כדי שכללי IP יראו את הכתובת האמיתית של הצופה.
  2. קבעו את כתובת בסיס הניגון לכתובת הציבורית שהקהל שלכם מגיע אליה.
  3. רשמו צומת מ-Servers באזור שבו צופים תומכים רבים; הלוח מתקין אותו דרך SSH ומנתב אליו את צופי האזור.
  4. צרו חשבון שותף (מפיץ) לכל איש צוות שמנהל את הקטלוג או את התומכים, עם קבוצת הרשאות משלו.

ארגון התוכן

תוכניות כסדרות, דרגות כבאוקטים.

  1. צרו קטגוריות לפי ז'אנר, וסדרה אחת לכל תוכנית עם עונה לכל מקבץ שחרורים ופרק לכל סרטון.
  2. צרו באוקט לערוץ החי, אחד לתוכן החינמי או ההתחלתי ואחד לכל דרגה גבוהה יותר.
  3. צרו חבילה אחת לכל דרגה כשתקופת החיוב היא משכה, חבילת ניסיון למבקרים חדשים אם תרצו, ומחיר בקרדיטים לשותפים.
  4. שמרו את הארכיון בקטגוריה משלו כדי שאפשר יהיה להעביר אותו בין דרגות בלי לגעת בסדרות.

הגדרת שותפים (מפיצים)

שותפים ומפיצים.

  1. צרו קבוצה לשותפים עם הרשאות קווים בלבד, כדי שלא יוכלו לשנות את הקטלוג.
  2. הוסיפו כל שותף כמפיץ עם הקבוצה הזו ויתרת קרדיטים; מחיר החבילה שלו הוא מה שהאולפן מחליט.
  3. מפיץ שיש לו תת-שותפים יכול ליצור תת-מפיצים תחת חשבונו, עד חמש רמות.

הגדרת גישת תומכים

קו אחד לכל תומך.

  1. התקינו את המחבר של החנות שלכם (למשל WooCommerce) והזינו את מפתח Reseller API ואת החבילה שמתאימה לכל מוצר.
  2. בהצטרפות המחבר קורא ל-create_line עם החבילה ומזהה בקשה; תקופת החיוב היא משך החבילה.
  3. קבעו את מספר החיבורים המרבי למספר המכשירים שתומך רשאי להשתמש בהם, בדרך כלל שניים או שלושה.
  4. למתנה או להשקה, צרו קודי הפעלה בכמות או הוסיפו קווים מ-Lines → add עם חבילת ניסיון.

ספריית תוכניות

פרקים לפי דרישה.

  1. העלו כל פרק כמקור, או ייבאו אותו עם משימת ייבוא ה-VOD; מלאו את הכותרת, העונה, מספר הפרק ומטא-דאטה מ-TMDB אם יש לתוכנית.
  2. צרפו כל סדרה לבאוקטים של הדרגות שרשאיות לצפות בה.
  3. בדקו ניגון עם קו בדיקה מכל דרגה לפני שמכריזים על שחרור.

ערוץ האולפן

ערוץ סביב השעון.

  1. הוסיפו שידור חי למערכת השידור של האולפן (דחיפת RTMP) והציבו אותו באוקטים של כל דרגה שכוללת את הערוץ.
  2. טענו את המדריך של הערוץ כ-XMLTV כדי שתומכים יראו מה משודר, והפעילו צפייה בדיעבד בתוכניות ששווה לשחזר.
  3. שמרו על מערכת השידור פעילה בין שחרורים עם תוכן מתוזמן של האולפן עצמו; הלוח רק מעביר את השידור.

תפוגת מנוי

הגישה עוקבת אחרי התשלום.

  1. קו פוקע בסוף תקופת החבילה שלו; החנות מחדשת אותו עם renew_line כשהתשלום הבא מגיע.
  2. הירשמו ב-webhooks בחנות כדי לשלוח תזכורת ב-line.expiring ולהוריד דרגה לתומך ב-line.expired.
  3. תומך שמבטל מושבת על ידי החנות עם disable_line, ואפשר לחדש את הקו מאוחר יותר בלי חשבון חדש.

אינטגרציה עם החנות

החנות מוכרת; הנגן מנגן.

  1. המחבר יוצר, מחדש ומשבית קווים בהתאם להזמנות; כל חנות אחרת משתמשת ב-Reseller API וב-webhooks.
  2. שותפים רואים את הקווים שלהם בלוח שלהם, ו-Reseller API מאפשר להם לאוטומט זאת.
  3. אין כניסה אחודה לצופים: תומכים נכנסים לנגן עם פרטי הקו שלהם, שהחנות שולחת להם.

שיקולי אבטחה

הגנו על המנוי, לא רק על השרת.

  1. הגישו את הלוח ואת כתובת בסיס הניגון ב-TLS והגדירו TRUSTED_PROXIES ל-reverse proxy שלכם.
  2. כניסה דו-שלבית לכל חשבון לוח, וקבוצות הרשאות כדי ששותפים לא יוכלו לשנות את הקטלוג.
  3. קישורי ניגון חתומים ופוקעים ומגבלת חיבורים לכל קו; קשרו קו למדינה אם הרישיון טריטוריאלי.
  4. גיבויים מוצפנים של מסד הנתונים עם עותק מחוץ לאתר, ויומן ביקורת לכל שינוי בקווים ובקטלוג.

פתרון תקלות

הבדיקות הראשונות הרגילות.

  1. תומך חדש לא יכול לצפות אחרי שילם: בדקו את הקריאה של מחבר החנות ביומן Reseller API ואת תאריך התפוגה של הקו.
  2. תומך רואה תוכן של דרגה גבוהה יותר: בדקו את החבילה של הקו ואת הבאוקטים שהיא מעניקה.
  3. הערוץ נעצר בסוף מחזור שידור: בדקו את הדחיפה של המקודד לשידור החי ואת סטטוס הבדיקה של השידור.
  4. מכירה של שותף לא מופיעה: בדקו את הקרדיטים שלו ושהחבילה שבה השתמש שייכת לקבוצה שלו.