این راهنماها مفاهیم یک صنعت را روی اشیایی که پلتفرم امروز دارد (بوکه‌ها، لاین‌ها، بسته‌ها، حساب‌های پارتنر، نودها، API) نگاشت می‌کنند. این‌ها نگاشت‌های مفهومی‌اند، نه قابلیت‌های مخصوص صنعت، و حساب پارتنر یک حساب تفویضی است، نه tenant ایزوله.
نگاشت مفهومی
در پنل چیزی به نام گالری یا عضو نیست. جدول می‌گوید کدام شیء چه نقشی دارد؛ بخش‌های زیر آن‌ها را به همین ترتیب راه می‌اندازند.
| در صنعت شما | روی پلتفرم | کجا در پنل |
|---|---|---|
| فیلم نمایشگاه و آرشیو | کاتالوگ VOD: فیلم و سریال با فصل و قسمت، دسته‌بندی‌ها و اطلاعات متادیتا | Movies و Series، یا کار ingest VOD |
| پخش افتتاحیه یا سخنرانی | کانال زنده: یک استریم با منابع، EPG و فرمت‌های خروجی‌اش | Streams ← افزودن استریم زنده (URL منبع یا RTMP push) |
| مجموعه گالری یا اعضا | بوکه: مجموعه‌ای نام‌دار از کانال‌ها، فیلم‌ها یا سریال‌ها که یک بسته می‌دهد | Bouquets، از Streams و Movies / Series |
| دسترسی بازدیدکننده یا عضو | لاین: یک دسترسی با بسته، بوکه‌ها، انقضا، محدودیت اتصال و خروجی‌هایش | Lines ← افزودن، یا کدهای فعال‌سازی، یا Reseller API |
| دوره عضویت | تاریخ انقضای لاین، که با بسته، کردیت یا API تمدید می‌شود | تاریخ انقضای لاین و مدت بسته |
| دستگاه به ازای هر عضو | حداکثر اتصال لاین: چند دستگاه می‌توانند هم‌زمان تماشا کنند | حداکثر اتصال لاین |
پیش‌نیازها
آنچه پیش از نصب باید داشته باشید.
- یک سرور در ساختمان (Ubuntu 22.04 یا 24.04)، نصب‌کننده و شبکه گالری که نمایشگرها و دستگاه‌های اعضا از آن استفاده می‌کنند.
- فیلم نمایشگاه، ضبط‌های آرشیوی که حقوقشان را دارید، یک انکودر برای سالن سخنرانی و نمایشگرها یا مدیاپلیرهای گالری‌ها.
- کلید مجوز و، اگر ساختمان اینترنت ندارد، روش فعال‌سازی آفلاین؛ و تصمیم درباره اینکه چه کسی در باجه عضویت می‌فروشد.
استقرار زیرساخت
سرور در ساختمان، در محل فعال می‌شود.
- نصب‌کننده را روی سرور اجرا کنید و URL پایه پخش را روی آدرسی بگذارید که شبکه گالری به آن می‌رسد.
- کلید مجوز را از پنل به‌صورت آفلاین فعال کنید؛ پس از فعال‌سازی سرویس بدون اینترنت روی شبکه محلی اجرا می‌شود.
- فیلم نمایشگاه را زیر Movies و فید سالن سخنرانی را زیر Streams اضافه کنید و در پخش‌کننده وب بررسی کنید.
- برای سایت دوم یا برنامه عمومی بزرگ، از Servers یک نود ثبت کنید؛ پنل آن را با SSH نصب می‌کند و بینندگان آن سایت را به آن هدایت می‌کند.
سازمان‌دهی محتوا
گالری‌ها، آرشیو و مجموعه‌های اعضا.
- برای هر نمایشگاه و هر سال دسته‌بندی بسازید، و برای یک دوره سخنرانی سریالی با یک قسمت برای هر سخنرانی.
- یک بوکه برای نمایشگرهای گالری و یکی برای کتابخانه اعضا از سخنرانی‌ها و فیلم‌های آرشیوی بسازید.
- یک بسته برای گالری‌ها و یکی برای هر نوع عضویت بسازید که هر کدام بوکه‌های خودش را می‌دهد؛ مدت بسته عضویت همان دوره عضویت است.
- برای هر فیلم پوستر و توضیح کوتاه اضافه کنید تا کتابخانه در پخش‌کننده خوب خوانده شود.
پیکربندی پارتنر (ریسلر)
باجه و فروشگاه به‌صورت حساب تفویض‌شده.
- گروهی با مجوزهای محدود به لاین‌ها و کدهای فعال‌سازی بسازید، بدون دسترسی به کاتالوگ یا سرورها.
- باجه، یا فروشگاه، را با آن گروه، بسته‌های عضویت و موجودی کردیت به‌عنوان ریسلر اضافه کنید.
- مرکز فرهنگی‌ای که چند مکان را اداره می‌کند می‌تواند برای هر مکان یک ریسلر اضافه کند که هر کدام از موجودی خودش عضویت می‌فروشد.
پیکربندی دسترسی بازدیدکنندگان و اعضا
نمایشگرها و اعضا روی لاین‌ها.
- برای هر نمایشگر گالری زیر Lines → افزودن یک لاین با بسته گالری بسازید، و وقتی شبکه آدرس ثابت می‌دهد آن را به آدرس نمایشگر ببندید.
- برای هر عضویت فروخته‌شده در باجه کد فعال‌سازی بسازید؛ عضو کد را در پخش‌کننده وارد می‌کند و لاین شروع می‌شود.
- حداکثر اتصال هر عضویت را روی تعداد دستگاه‌هایی که عضو می‌تواند استفاده کند، معمولاً دو، بگذارید.
- به عضو برنامه پخش‌کننده، پلی‌لیست M3U یا آدرس پخش‌کننده وب را بدهید، هر کدام که با دستگاهش جور است.
فیلم نمایشگاه و آرشیو
کتابخانه درخواستی.
- فیلم نمایشگاه و آرشیو دیجیتال‌شده را به‌صورت فیلم آپلود کنید، یا با کار ingest مربوط به VOD به ریشه رسانه وارد کنید.
- هر جا فراداده TMDB هست اضافه کنید و برای بقیه عنوان و توضیح را خودتان بنویسید.
- آرشیوی که برای عموم نیست را فقط در بوکه اعضا نگه دارید و با لاین آزمایشی بررسی کنید هر بسته چه می‌بیند.
افتتاحیه‌ها و سخنرانی‌ها
یک رویداد به‌صورت کانال زنده.
- برای انکودر سالن سخنرانی (RTMP پوش) یک استریم زنده اضافه کنید و آن را در بوکه اعضا بگذارید، یا برای افتتاحیه‌ای که روی نمایشگرها نشان داده می‌شود در بوکه گالری.
- catch-up را فعال کنید تا عضوی که دیر می‌رسد بتواند به عقب برگردد، و بعداً ضبط را در کتابخانه آپلود کنید.
- پیش از رویداد انکودر و استریم را با لاین آزمایشی روی همان شبکه‌ای که مخاطب استفاده می‌کند آزمایش کنید.
انقضا و تمدید عضویت
عضویت به‌عنوان اعتبار لاین.
- لاین در پایان دوره بسته‌اش منقضی می‌شود؛ تمدید در باجه یک دوره دیگر اضافه می‌کند.
- وقتی عضویتی لغو می‌شود لاین را غیرفعال کنید؛ کدهای فعال‌سازی که هرگز استفاده نشده‌اند تا زمان استفاده دست‌نخورده می‌مانند.
- فروشگاه یا سامانه عضویت را به وب‌هوک‌ها مشترک کنید تا لاین‌هایی که در شرف انقضا یا منقضی‌اند را ببیند.
یکپارچگی با فروشگاه یا سامانه عضویت
سامانه‌ها دسترسی را می‌فروشند؛ پخش‌کننده پخش می‌کند.
- برای فروشگاه یا سامانه عضویت یک کلید Reseller API بسازید؛ create_line، renew_line و disable_line را با شناسه درخواست در هر نوشتن صدا می‌زند.
- وقتی عضویت‌ها آنلاین فروخته می‌شوند از کانکتور تجارت استفاده کنید؛ هر سامانه دیگری از Reseller API و وب‌هوک استفاده می‌کند.
- ورود یکپارچه برای بینندگان نیست: عضو با اطلاعات لاین یا کد فعال‌سازی وارد پخش‌کننده می‌شود.
ملاحظات امنیتی
مجموعه‌ها را همان‌جا نگه دارید که باید باشند.
- شبکه گالری را از شبکه بازدیدکنندگان جدا نگه دارید و هر دسترسی عمومی را پشت ریورس‌پراکسی با TLS و TRUSTED_PROXIES تنظیم‌شده ارائه دهید.
- ورود دومرحله‌ای برای هر حساب پنل؛ باجه گروه مجوزی محدود به لاین‌ها و کدها می‌گیرد.
- لینک‌های پخش امضاشده و منقضی‌شونده، سقف اتصال برای هر عضویت و بستن نمایشگرهای گالری به آدرس.
- پشتیبان‌گیری رمزگذاری‌شده پایگاه داده با نسخه بیرونی را فعال کنید و از گزارش ممیزی برای بازبینی تغییر لاین‌ها و کاتالوگ استفاده کنید.
عیب‌یابی
بررسی‌های اولیه معمول.
- نمایشگر گالری سیاه است: بررسی کنید لاینش فعال و منقضی‌نشده است، بستن به آدرس نمایشگر، و اینکه سرور روی شبکه گالری در دسترس است.
- کد عضو کار نمی‌کند: بررسی کنید کد پیش‌تر استفاده نشده و بسته‌ای که باز می‌کند هنوز به باجه اختصاص دارد.
- فعال‌سازی آفلاین مجوز شکست می‌خورد: فایل فعال‌سازی را با کلید مجوز و ساعت سرور مطابقت دهید.
- افتتاحیه زنده می‌پرد: بیت‌ریت انکودر را با آپ‌لینک و وضعیت استریم را زیر Streams بررسی کنید.