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 şey galeri veya üye olarak adlandırılmaz. Tablo hangi nesnenin hangi rolü oynadığını gösterir; aşağıdaki bölümler onları bu sırayla kurar.
| Sektörünüzde | Platformda | Panelde nerede |
|---|---|---|
| Sergi filmi ve arşiv | VOD kataloğu: sezon ve bölümlü filmler ve diziler, kategoriler ve meta veri | Movies ve Series ya da VOD ingest işi |
| Açılış veya konferans yayını | Canlı kanal: kaynakları, EPG'si ve çıkış formatları olan bir yayın | Streams → canlı yayın ekle (kaynak URL'si veya RTMP push) |
| Galeri veya üye koleksiyonu | Buket: bir paketin verdiği, adlandırılmış kanal, film veya dizi kümesi | Bouquets, Streams ve Movies / Series'ten |
| Ziyaretçi veya üye erişimi | 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 |
| Üyelik süresi | Hattın bitiş tarihi; bir paket, bir kredi veya API ile yenilenir | Hattın bitiş tarihi ve paketin süresi |
| Üye başına cihaz | Hattın en fazla bağlantısı: aynı anda kaç cihaz izleyebilir | Hattın en fazla bağlantısı |
Ön koşullar
Kurmadan önce nelere sahip olmalı.
- Binada bir sunucu (Ubuntu 22.04 veya 24.04), kurulum aracı ve ekranların ile üyelerin cihazlarının kullanacağı galeri ağı.
- Sergi filmi, haklarına sahip olduğunuz arşiv kayıtları, konferans salonu için bir kodlayıcı ve galeriler için ekranlar veya medya oynatıcılar.
- Lisans anahtarı ve binada internet yoksa çevrimdışı etkinleştirme prosedürü; ayrıca gişede kimin üyelik sattığı hakkında bir karar.
Altyapı dağıtımı
Binadaki sunucu, yerinde etkinleştirilir.
- Kurulum aracını sunucuda çalıştırın ve oynatma tabanı URL'sini galeri ağının eriştiği adrese ayarlayın.
- Lisans anahtarını panelden çevrimdışı etkinleştirin; etkinleştirmeden sonra hizmet internet olmadan yerel ağda çalışır.
- Sergi filmini Movies altına, konferans salonu yayınını Streams altına ekleyin ve web oynatıcıda kontrol edin.
- İkinci bir saha veya büyük bir halka açık program için Servers'tan bir node kaydedin; panel onu SSH ile kurar ve o sahanın izleyicilerini ona yönlendirir.
İçerik organizasyonu
Galeriler, arşiv ve üye koleksiyonları.
- Sergi ve yıl başına kategoriler ve bir konferans döngüsü için konuşma başına bir bölümle bir dizi oluşturun.
- Galeri ekranları için bir buket ve üyelerin konuşma ile arşiv filmi arşivi için bir buket oluşturun.
- Galeriler için bir paket ve üyelik türü başına bir paket oluşturun, her biri kendi buketlerini verir; üyelik paketinin süresi üyelik dönemidir.
- Arşiv oynatıcıda iyi okunsun diye her filme afiş ve kısa açıklama ekleyin.
Ortak (bayi) yapılandırması
Devredilmiş hesap olarak gişe ve mağaza.
- Yetkileri hatlar ve etkinleştirme kodlarıyla sınırlı, kataloğa veya sunuculara erişimi olmayan bir grup oluşturun.
- Gişeyi veya mağazayı o grup, üyelik paketleri ve bir kredi bakiyesiyle bayi olarak ekleyin.
- Birden çok mekân işleten bir kültür merkezi mekân başına bir bayi ekleyebilir; her biri kendi bakiyesinden üyelik satar.
Ziyaretçi ve üye erişimi yapılandırması
Hatlarda ekranlar ve üyeler.
- Galeri ekranı başına, galeri paketiyle bir hat oluşturun (Lines → add) ve ağ sabit adres veriyorsa onu ekranın adresine bağlayın.
- Satılan her üyelik için gişede etkinleştirme kodları oluşturun; üye kodu oynatıcıya girer ve hat başlar.
- Üyelik başına en fazla bağlantıyı bir üyenin kullanabileceği cihaz sayısına, genellikle ikiye ayarlayın.
- Üyeye cihazına uygun olanı verin: oynatıcı uygulaması, bir M3U oynatma listesi veya web oynatıcı adresi.
Sergi filmi ve arşiv
İsteğe bağlı arşiv.
- Sergi filmini ve sayısallaştırılmış arşivi film olarak yükleyin ya da VOD ingest işiyle medya köküne içe alın.
- Varsa TMDB metaverisini ekleyin, geri kalan için başlığı ve açıklamayı kendiniz yazın.
- Halka açık olmayan arşivi yalnızca üye buketinde tutun ve her paketin ne gördüğünü bir test hattıyla kontrol edin.
Açılışlar ve konferanslar
Canlı kanal olarak bir etkinlik.
- Konferans salonunun kodlayıcısı için bir canlı yayın ekleyin (RTMP push) ve üye buketine koyun ya da ekranlarda gösterilen bir açılış için galeri buketine koyun.
- Geç gelen bir üye geri sarabilsin diye catch-up'ı etkinleştirin ve sonra kaydı arşive yükleyin.
- Kodlayıcıyı ve yayını etkinlikten önce, kitlenin kullanacağı aynı ağda bir test hattıyla test edin.
Üyelik bitişi ve yenileme
Hattın geçerliliği olarak üyelik.
- Bir hat paketinin dönemi sonunda sona erer; gişede yenileme bir dönem daha ekler.
- Bir üyelik iptal edildiğinde hattı devre dışı bırakın; hiç kullanılmamış etkinleştirme kodları kullanılana kadar kullanılmamış kalır.
- Süresi dolmak üzere olan veya dolmuş hatları görmek için mağazayı veya üyelik sistemini webhook'lara abone edin.
Mağaza veya üyelik sistemi ile entegrasyon
Sistemler erişimi satar; oynatıcı oynatır.
- Mağaza veya üyelik sistemi için bir Reseller API anahtarı oluşturun; her yazma işleminde bir istek kimliğiyle create_line, renew_line ve disable_line çağırır.
- Üyelikler çevrimiçi satılıyorsa bir ticaret konektörü kullanın; diğer tüm sistemler Reseller API ve webhook'ları kullanır.
- İzleyiciler için tek oturum açma yoktur: üye oynatıcıda hattın kimlik bilgileri veya etkinleştirme koduyla oturum açar.
Güvenlik değerlendirmeleri
Koleksiyonları ait oldukları yerde tutun.
- Galeri ağını ziyaretçi ağından ayrı tutun ve herkese açık erişimi TLS'li bir reverse proxy'nin arkasında, TRUSTED_PROXIES ayarlı olarak sunun.
- Her panel hesabı için iki adımlı oturum açma; gişe, hatlar ve kodlarla sınırlı bir yetki grubu alır.
- İmzalı ve süresi dolan oynatma bağlantıları, üyelik başına bağlantı sınırı ve galeri ekranları için adrese bağlama.
- Site dışı kopyalı şifreli veritabanı yedeğini etkinleştirin ve hatların ve kataloğun değişikliklerini incelemek için denetim günlüğünü kullanın.
Sorun giderme
Olağan ilk kontroller.
- Bir galeri ekranı siyah: hattının etkin olduğunu ve süresinin dolmadığını, ekranın adrese bağlamasını ve sunucuya galeri ağından erişilebildiğini kontrol edin.
- Bir üyenin kodu çalışmıyor: kodun daha önce kullanılmadığını ve açtığı paketin hâlâ gişeye atanmış olduğunu kontrol edin.
- Çevrimdışı lisans etkinleştirme başarısız: etkinleştirme dosyasını lisans anahtarına göre ve sunucunun saatini kontrol edin.
- Canlı açılış takılıyor: kodlayıcının bit hızını uplink'e göre ve yayının durumunu Streams altında kontrol edin.