Bu kılavuzlar bir sektörün kavramlarını platformun bugün sahip olduğu nesnelere (buketler, hatlar, paketler, bayi hesapları, node'lar, API) eşler. Bunlar kavramsal eşlemelerdir, sektöre özgü özellikler değildir ve bayi hesabı yalıtılmış bir kiracı değil, devredilmiş bir hesaptır.
Kavramsal eşleme
Panelde hiçbir şeye oda veya konaklama denmez. Tablo hangi nesnenin hangi rolü oynadığını söyler; aşağıdaki bölümler onları bu sırayla kurar.
| Sektörünüzde | Platformda | Panelde nerede |
|---|---|---|
| Otel işletmecisi veya yetkili ortak | Bayi hesabı (reseller): kredisi, yetkileri ve kendi hatları olan devredilmiş bir panel | Users → bayi ekle; yetkileri için Groups |
| Kanal paketi | Buket: bir paketin verdiği, adlandırılmış kanal, film veya dizi kümesi | Bouquets, Streams ve Movies / Series'ten |
| Oda veya cihaz | Hat: paketi, buketleri, bitiş tarihi, bağlantı sınırı ve çıkışlarıyla tek bir erişim | Lines → ekle, veya etkinleştirme kodları, veya Reseller API |
| Otel bilgilendirme videoları | VOD kataloğu: sezon ve bölümlü filmler ve diziler, kategoriler ve meta veri | Movies ve Series ya da VOD ingest işi |
| Lisanslı televizyon kanalları | Canlı kanal: kaynakları, EPG'si ve çıkış formatları olan bir yayın | Streams → canlı yayın ekle (kaynak URL'si veya RTMP push) |
| Konaklama süresi | Hattın bitiş tarihi; bir paket, bir kredi veya API ile yenilenir | Hattın bitiş tarihi ve paketin süresi |
| Bina veya kanat başına bir node | Yayın node'ları: panelden kaydedilen edge sunucular, her site veya bina için bir tane | Servers → node ekle, SSH ile kurulur |
Ön koşullar
Kurmadan önce nelere sahip olmalı.
- Tesis ağında bir sunucu (Ubuntu 22.04 veya 24.04), kurulum aracı ve oda cihazlarının erişebileceği bir adres.
- Tesisin haklarına sahip olduğu kanal beslemeleri (pull URL'leri veya RTMP), otelin bilgilendirme videoları ve oda cihazları (Android TV kutuları, MAG veya Enigma2 kutuları, oynatıcı uygulaması veya tarayıcısı olan akıllı TV'ler).
- PMS'in check-in ve check-out'ta bir HTTP API çağırabilmesi ya da bunu panelde yapmak için bir resepsiyon prosedürü.
Altyapı dağıtımı
Merkezi sunucu ve bina başına bir node.
- Kurulum aracını merkezi sunucuda çalıştırın; odaların yerel ağda kalması için oynatma tabanını tesisin dahili adresine ayarlayın.
- Kanal beslemelerini Streams altına, bilgilendirme videolarını Movies altına ekleyin; web oynatıcıda kontrol edin.
- Servers'tan kanat veya bina başına bir node kaydedin; panel onu SSH ile kurar ve o binanın odalarını ona yönlendirir.
- Lisans anahtarını sunucuda ayarlayın; etkinleştirme yerinde olur ve hizmet uplink olmadan çalışır.
İçerik organizasyonu
Kanal paketleri ve otel videoları.
- Tesisin kanallarından kanal paketi başına (standart odalar, süitler, konferans) bir buket oluşturun.
- Otel videolarından (karşılama, olanaklar, güvenlik) bir buket oluşturun ve her pakete ekleyin.
- Oda kategorisi başına, verdiği buketler ve bir gün süreyle bir paket oluşturun: girişte odanın hattı konaklamanın her gecesi için bir kez yenilenir (her yenileme paketin süresini ekler), çıkışta ise devre dışı bırakılır (bölüm 8).
- Televizyondaki menünün iyi okunması için kanalları sıralayın ve logolarını verin.
Ortak (bayi) yapılandırması
Devredilmiş hesap olarak tesis veya birkaç tesisi işleten bir operatör.
- Yetkileri hatlarla (odalar) sınırlı ve katalog değişikliği olmayan bir grup oluşturun.
- Tesisin resepsiyonunu veya operatörü, o grup ve oda paketleriyle bayi olarak ekleyin.
- Birkaç tesisi işleten bir operatör, her biri kendi odaları ve kredileriyle tesis başına bir bayi alır.
Oda (hat) yapılandırması
Numarasıyla adlandırılmış oda başına bir hat.
- Lines altında adı oda numarası olan ve oda kategorisinin paketini kullanan oda başına bir hat oluşturun.
- En fazla bağlantıyı 1 (bir televizyon) veya odadaki ekran sayısına ayarlayın.
- Ağ cihazlara sabit adres veriyorsa hattı oda cihazının adresine bağlayın.
- Cihazı (hattın kimlik bilgileriyle Xtream Codes API veya M3U, ya da MAG / Enigma2 portalı) bir kez yapılandırın; kimlik bilgileri odada kalır.
Otel bilgilendirme videoları
Tesisin kendi isteğe bağlı videoları.
- Karşılama ve bilgilendirme videolarını film olarak yükleyin; tesisin dil sürümlerini ayrı girdiler veya ses parçaları olarak ekleyin.
- Onları otel videoları buketine koyun ki her oda kategorisi alsın.
- Bilgi değiştiğinde panelden güncelleyin; odalar yeni sürümü hemen görür.
Lisanslı televizyon kanalları
Canlı yayın olarak tesisin kanalları.
- Her lisanslı kanalı Streams altına beslemesiyle ekleyin; timeshift veya catch-up'ı yalnızca lisansın izin verdiği yerde etkinleştirin.
- Televizyondaki rehberin programları göstermesi için bir EPG kaynağı ekleyin.
- Bölgeyle sınırlı kanalları yalnızca doğru paketlerin verdiği buketlerde tutun.
Check-in, check-out ve bitiş
Hattın geçerliliği olarak konaklama.
- Check-in'de odanın hattını etkinleştirin ve konaklama süresi kadar yenileyin (API üzerinden PMS veya panelde resepsiyon).
- Check-out'ta hattı devre dışı bırakın; yeni bir konaklama onu yeniden etkinleştirir, böylece kimlik bilgileri odadan hiç çıkmaz.
- Etkinleştirilen, devre dışı bırakılan ve biten hatları görmek için PMS'i veya resepsiyonu webhook'lara abone edin.
PMS ile entegrasyon
Check-in ve check-out odaları yönetir.
- PMS için bir Reseller API anahtarı oluşturun ve PMS'in yapılandırmasında tutun.
- Check-in'de PMS, odanın hattı için bir istek kimliğiyle action=enable_line ve action=renew_line çağırır; check-out'ta action=disable_line.
- Misafir hizmetleri uygulaması (personel çağırma, kat hizmetleri, hızlı check-out, oda servisi) ve arka ofis bağlantısı Enterprise planın parçasıdır ve tesisle birlikte kapsamlandırılır.
Güvenlik değerlendirmeleri
Kanalları tesisin içinde tutun.
- Oynatma tabanını ve node'ları tesisin ağında tutun; odaların ihtiyaç duymadığı hiçbir şeyi internete açmayın.
- Cihaza bağlı oda başına bir bağlantı; imzalı bağlantıların süresi dolar, bu yüzden kopyalanmış bir bağlantı çalışmaz.
- Panel için iki adımlı giriş; resepsiyon sınırlı bir yetki grubu alır.
- Şifreli veritabanı yedeğini açın; oda kimlik bilgileri onun içindedir.
Sorun giderme
Olağan ilk kontroller.
- Bir odada televizyon yok: hattının etkin olduğunu ve süresinin dolmadığını, ardından cihazın kimlik bilgilerini ve adresini kontrol edin.
- Bir odada kanal eksik: oda kategorisinin paketinin buketini kontrol edin.
- Televizyon internet kesintisinde duruyor: oynatma tabanının ve kaynakların dahili adresler olduğunu kontrol edin; harici beslemeler uplink'e bağlıdır.
- PMS çağrısı başarısız: API anahtarını, yazma işlemlerinin POST olduğunu ve yeniden denemelerdeki istek kimliğini kontrol edin.