این راهنماها مفاهیم یک صنعت را روی اشیایی که پلتفرم امروز دارد (بوکه‌ها، لاین‌ها، بسته‌ها، حساب‌های پارتنر، نودها، API) نگاشت می‌کنند. این‌ها نگاشت‌های مفهومی‌اند، نه قابلیت‌های مخصوص صنعت، و حساب پارتنر یک حساب تفویضی است، نه tenant ایزوله.
نگاشت مفهومی
در پنل چیزی به نام اتاق یا اقامت وجود ندارد. جدول می‌گوید کدام شیء چه نقشی دارد؛ فصل‌های زیر آن‌ها را به همین ترتیب تنظیم می‌کنند.
| در صنعت شما | روی پلتفرم | کجا در پنل |
|---|---|---|
| اپراتور هتل یا پارتنر مجاز | حساب پارتنر (ریسلر): داشبورد تفویضی با کردیت، مجوزها و لاین‌های خودش | Users ← افزودن ریسلر؛ Groups برای مجوزهای آن |
| بسته کانال | بوکه: مجموعه‌ای نام‌دار از کانال‌ها، فیلم‌ها یا سریال‌ها که یک بسته می‌دهد | Bouquets، از Streams و Movies / Series |
| اتاق یا دستگاه | لاین: یک دسترسی با بسته، بوکه‌ها، انقضا، محدودیت اتصال و خروجی‌هایش | Lines ← افزودن، یا کدهای فعال‌سازی، یا Reseller API |
| ویدیوهای اطلاع‌رسانی هتل | کاتالوگ VOD: فیلم و سریال با فصل و قسمت، دسته‌بندی‌ها و اطلاعات متادیتا | Movies و Series، یا کار ingest VOD |
| کانال‌های تلویزیونی دارای مجوز | کانال زنده: یک استریم با منابع، EPG و فرمت‌های خروجی‌اش | Streams ← افزودن استریم زنده (URL منبع یا RTMP push) |
| مدت اقامت | تاریخ انقضای لاین، که با بسته، کردیت یا API تمدید می‌شود | تاریخ انقضای لاین و مدت بسته |
| یک نود برای هر ساختمان یا بال | نودهای پخش: سرورهای edge ثبت‌شده از پنل، یکی برای هر سایت یا ساختمان | Servers ← افزودن نود، نصب‌شده با SSH |
پیش‌نیازها
آنچه پیش از نصب باید داشته باشید.
- یک سرور روی شبکه ملک (اوبونتو 22.04 یا 24.04)، نصب‌کننده و آدرسی که دستگاه‌های اتاق‌ها به آن دسترسی دارند.
- فیدهای کانالی که ملک حقوق آن را دارد (URL pull یا RTMP)، ویدیوهای اطلاع‌رسانی هتل و دستگاه‌های اتاق‌ها (باکس‌های Android TV، دستگاه‌های MAG یا Enigma2، تلویزیون‌های هوشمند با اپ پخش‌کننده یا مرورگر).
- توانایی PMS در صدا زدن یک API مبتنی بر HTTP هنگام ورود و خروج، یا رویه‌ای در پذیرش برای انجام آن در پنل.
استقرار زیرساخت
سرور مرکزی و یک نود برای هر ساختمان.
- نصب‌کننده را روی سرور مرکزی اجرا کنید؛ پایه پخش را روی آدرس داخلی ملک بگذارید تا اتاق‌ها روی شبکه محلی بمانند.
- فیدهای کانال را در Streams و ویدیوهای اطلاع‌رسانی را در Movies اضافه کنید؛ آن‌ها را در پخش‌کننده وب بررسی کنید.
- برای هر بال یا ساختمان از Servers یک نود ثبت کنید؛ پنل آن را با SSH نصب می‌کند و اتاق‌های آن ساختمان را به آن هدایت می‌کند.
- کلید مجوز را روی سرور بگذارید؛ فعال‌سازی در محل انجام می‌شود و سرویس بدون اینترنت بالادستی کار می‌کند.
سازمان‌دهی محتوا
بسته‌های کانال و ویدیوهای هتل.
- از کانال‌های ملک برای هر بسته کانال (اتاق‌های استاندارد، سوئیت‌ها، کنفرانس) یک بوکه بسازید.
- یک بوکه از ویدیوهای هتل (خوش‌آمدگویی، امکانات، ایمنی) بسازید و آن را به هر بسته اضافه کنید.
- برای هر دسته اتاق یک بسته بسازید با بوکه‌هایی که می‌دهد و مدت یک روز: هنگام ورود، لاین اتاق به ازای هر شب اقامت یک بار تمدید می‌شود (هر تمدید مدت بسته را اضافه می‌کند) و هنگام خروج غیرفعال می‌شود (فصل ۸).
- کانال‌ها را مرتب کنید و لوگو بدهید تا منوی روی تلویزیون خوانا باشد.
پیکربندی پارتنر (ریسلر)
ملک، یا اپراتوری که چند ملک را اداره می‌کند، به‌عنوان حساب تفویضی.
- گروهی بسازید با مجوزهای محدود به لاین‌ها (اتاق‌ها) و بدون تغییر کاتالوگ.
- پذیرش ملک، یا اپراتور را به‌عنوان ریسلر با آن گروه و بسته‌های اتاق‌ها اضافه کنید.
- اپراتور چند ملک برای هر ملک یک ریسلر می‌گیرد، هرکدام با اتاق‌ها و کردیت خودش.
پیکربندی اتاق (لاین)
یک لاین برای هر اتاق، با شماره آن به‌عنوان نام.
- در Lines برای هر اتاق یک لاین بسازید با شماره اتاق به‌عنوان نام و بسته دسته اتاق.
- حداکثر اتصال را 1 (یک تلویزیون) یا به تعداد نمایشگرهای اتاق بگذارید.
- وقتی شبکه به دستگاه‌ها آدرس ثابت می‌دهد، لاین را به آدرس دستگاه اتاق وابسته کنید.
- دستگاه را یک بار پیکربندی کنید (Xtream Codes API یا M3U با مشخصات لاین، یا پرتال MAG / Enigma2)؛ مشخصات در اتاق می‌ماند.
ویدیوهای اطلاع‌رسانی هتل
ویدیوهای خود ملک به‌صورت درخواستی.
- ویدیوهای خوش‌آمدگویی و اطلاع‌رسانی را به‌عنوان فیلم بارگذاری کنید و نسخه‌های زبانی ملک را به‌صورت ورودی جدا یا ترک صوتی بگذارید.
- آن‌ها را در بوکه ویدیوهای هتل بگذارید تا هر دسته اتاق آن‌ها را دریافت کند.
- هر وقت اطلاعات تغییر کرد آن‌ها را از پنل به‌روز کنید؛ اتاق‌ها نسخه جدید را بلافاصله می‌بینند.
کانال‌های تلویزیونی دارای مجوز
کانال‌های ملک به‌صورت استریم زنده.
- هر کانال دارای مجوز را در Streams با فیدش اضافه کنید؛ timeshift یا catch-up را فقط جایی فعال کنید که مجوز اجازه می‌دهد.
- یک منبع EPG اضافه کنید تا راهنمای روی تلویزیون برنامه‌ها را نشان دهد.
- کانال‌های محدود به قلمرو را در بوکه‌هایی نگه دارید که فقط بسته‌های درست می‌دهند.
ورود، خروج و انقضا
اقامت به‌عنوان اعتبار لاین.
- هنگام ورود لاین اتاق را فعال کنید و به‌اندازه مدت اقامت تمدید کنید (PMS از طریق API، یا پذیرش در پنل).
- هنگام خروج لاین را غیرفعال کنید؛ اقامت جدید دوباره آن را فعال می‌کند، پس مشخصات هرگز از اتاق خارج نمی‌شود.
- PMS یا پذیرش را مشترک وب‌هوک‌ها کنید تا لاین‌های فعال، غیرفعال و منقضی را ببیند.
یکپارچه‌سازی با PMS
ورود و خروج اتاق‌ها را هدایت می‌کنند.
- برای PMS یک کلید Reseller API بسازید و در پیکربندی PMS نگه دارید.
- هنگام ورود، PMS برای لاین اتاق action=enable_line و action=renew_line را با یک شناسه درخواست صدا می‌زند؛ هنگام خروج action=disable_line.
- اپلیکیشن خدمات مهمان (تماس با کارکنان، نظافت، تسویه سریع، سرویس اتاق) و اتصال back-office آن بخشی از طرح Enterprise است و همراه ملک تعریف می‌شود.
ملاحظات امنیتی
کانال‌ها را داخل ملک نگه دارید.
- پایه پخش و نودها را روی شبکه ملک نگه دارید؛ چیزی را که اتاق‌ها نیاز ندارند به اینترنت باز نکنید.
- یک اتصال برای هر اتاق، وابسته به دستگاه؛ لینک‌های امضاشده منقضی می‌شوند، پس لینک کپی‌شده از کار می‌افتد.
- ورود دومرحله‌ای برای پنل؛ پذیرش یک گروه مجوز محدود می‌گیرد.
- پشتیبان‌گیری رمزگذاری‌شده از پایگاه داده را روشن کنید؛ مشخصات اتاق‌ها در آن است.
عیب‌یابی
بررسی‌های اولیه معمول.
- اتاقی تلویزیون ندارد: بررسی کنید لاینش فعال و منقضی‌نشده باشد، سپس مشخصات و آدرس دستگاه.
- کانالی در اتاقی نیست: بوکه بسته دسته آن اتاق را بررسی کنید.
- تلویزیون هنگام قطعی اینترنت متوقف می‌شود: بررسی کنید پایه پخش و منابع آدرس داخلی باشند؛ فیدهای بیرونی به اینترنت بالادستی وابسته‌اند.
- فراخوانی PMS شکست می‌خورد: کلید API، POST بودن نوشتن‌ها و شناسه درخواست در تلاش‌های مجدد را بررسی کنید.