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 ders veya öğrenci 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 |
|---|---|---|
| Eğitim merkezi veya dağıtım bayisi | Bayi hesabı (reseller): kredisi, yetkileri ve kendi hatları olan devredilmiş bir panel | Users → bayi ekle; yetkileri için Groups |
| Ders koleksiyonu | Buket: bir paketin verdiği, adlandırılmış kanal, film veya dizi kümesi | Bouquets, Streams ve Movies / Series'ten |
| Kayıtlı dersler | VOD kataloğu: sezon ve bölümlü filmler ve diziler, kategoriler ve meta veri | Movies ve Series ya da VOD ingest işi |
| Canlı ders | Canlı kanal: kaynakları, EPG'si ve çıkış formatları olan bir yayın | Streams → canlı yayın ekle (kaynak URL'si veya RTMP push) |
| Öğrenci 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 |
| Ders erişim süresi | Hattın bitiş tarihi; bir paket, bir kredi veya API ile yenilenir | Hattın bitiş tarihi ve paketin süresi |
| Eşzamanlı oturum sınırı | Hattın en fazla bağlantısı: aynı anda kaç cihaz izleyebilir | Hattın en fazla bağlantısı |
| LMS veya ticaret entegrasyonu | Reseller API ve webhook'lar: panelin işlemleri kendi sisteminizden | Bayinin panelindeki Reseller API anahtarları ve webhook'lar |
Ön koşullar
Kurmadan önce nelere sahip olmalı.
- Kampüs ağında, kurulum aracının Postgres, Redis ve ffmpeg'i kurduğu bir Linux sunucu (Ubuntu 22.04 veya 24.04) ve panel ile oynatıcı için bir alan adı veya dahili adres.
- Yayınlayacağınız kayıtlar (dosyalar veya RTMP gönderebilen bir yakalama sistemi) ve canlı dersler için, yayın yapacak her odada bir kodlayıcı.
- Bir lisans anahtarı: Free plan gerektirmez; uygun kurumlar ücretsiz Professional anahtarını akademik alan adlarından e-posta ile talep eder.
Altyapı dağıtımı
Yönetim sunucusunu, ardından bina başına bir node kurun.
- Kurulum aracını yönetim sunucusunda çalıştırın; paneli, API'yi, worker'ı ve origin'i systemd birimleri olarak kurar ve ilk yöneticiyi oluşturur.
- Oynatıcı bağlantılarının kampüs adresini göstermesi için API'nin genel URL'sini (API_PUBLIC_URL) ve oynatma tabanını ayarlayın.
- Salonları izleyecek her bina için Servers → node ekle ile bir node kaydedin; panel onu node paketinden SSH ile kurar.
- Servers sayfasını kontrol edin: node heartbeat ve trafik bildirir ve o binanın izleyicileri ona yönlendirilir.
İçerik organizasyonu
Dersler dizi olarak, programlar buket ve paket olarak.
- Movies / Series altında fakülte veya konu başına bir kategori oluşturun.
- Her dersi bir dizi olarak ekleyin: modül başına bir sezon, konu başına bir bölüm, kaynak olarak kayıtla (yükleme veya VOD ingest işi).
- Eklediğiniz dizilerden ders koleksiyonu başına bir buket oluşturun (örneğin bir programın bir dönemlik dersleri).
- Program başına bir paket oluşturun: verdiği buketler, süre olarak erişim süresi ve eşzamanlı oturum sınırı.
Ortak (bayi) yapılandırması
Devredilmiş hesap olarak bir eğitim merkezi veya fakülte.
- Groups altında merkezin ihtiyaç duyduğu yetkilerle (kendi hatları, katalog değişikliği yok) bir grup oluşturun.
- Merkezi Users altında o grupla, bir kredi bakiyesi ve verebileceği paketlerle bayi olarak ekleyin.
- Ona panel adresini verin; öğrencilerini oradan yönetir, panel denetim günlüğünü tutar.
Öğrenci erişimi yapılandırması
Kayıtta oluşturulan öğrenci başına bir hat.
- Küçük gruplar için Lines → ekle ile programın paketiyle hat ekleyin; bitiş tarihi paket süresini izler.
- Kayıt günü için pakete etkinleştirme kodları üretin; öğrenci kodu oynatıcıda kullanır ve bir hat alır.
- Bir öğrenci sistemi veya LMS için bir Reseller API anahtarı oluşturun ve sistemin her öğrenci için action=create_line ve bir istek kimliğiyle hat oluşturmasına izin verin.
- En fazla bağlantıyı öğrencinin aynı anda kullanabileceği cihaz sayısına ayarlayın; oynatıcı bunun ötesindeki bağlantıyı reddeder.
VOD kurulumu
İsteğe bağlı kayıtlı dersler.
- Her kaydı bir bölümün kaynağı olarak yükleyin ya da VOD ingest işini dosyaya yönlendirin ve worker'ın indirip medya köküne kodlamasına izin verin.
- Meta veriyi (başlık, açıklama, poster) elle ya da herkese açık materyal için TMDB'den doldurun; dersler genellikle yalnızca başlık ve açıklama ister.
- Oynatmayı web oynatıcıda bir test hattıyla kontrol edin; bağlantı imzalıdır ve ayarlanan süreden sonra sona erer.
Canlı sınıf yayını
Canlı kanal olarak bir ders.
- Streams altında kaynak olarak odanın kodlayıcısıyla (bir RTMP push adresi veya pull URL'si) bir canlı yayın ekleyin.
- Yayını dersin buketine koyun ki yalnızca kayıtlı öğrenciler görsün; bir ders programı tutuyorsanız EPG'ye ekleyin.
- Öğrenciler bir dersi sonradan izleyebilecekse yayında catch-up veya timeshift'i etkinleştirin; kayıt bir bölüm olarak da yüklenebilir.
Abonelik ve erişim sona ermesi
Dersle birlikte biten erişim.
- Pakete süre olarak erişim süresini verin; ondan oluşturulan bir hat bu sürenin sonunda sona erer.
- Bir hattı yeni dönem için panelden, merkezin bir kredisiyle ya da API ile action=renew_line kullanarak yenileyin.
- Sisteminizi webhook'lara abone edin: bir hat bitmek üzereyken, bittiğinde veya devre dışı bırakıldığında haberdar edilir.
Harici bir LMS ile entegrasyon
LMS erişimi yönetir; oynatıcı oynatır.
- LMS için bir Reseller API anahtarı oluşturun; onu LMS'in gizli bilgilerinde tutun, asla bir sayfada değil.
- Kayıtta LMS, programın paketi ve bir istek kimliğiyle action=create_line çağırır; kayıt silindiğinde action=disable_line.
- LMS'in ders sayfasından web oynatıcıya bağlantı verin ya da öğrenciye oynatıcı kimlik bilgilerini verin; ikisi arasında tek oturum açma yoktur.
Güvenlik değerlendirmeleri
Hizmeti kurumun içinde tutun.
- Her panel hesabı için iki adımlı girişi etkinleştirin ve personele işe yarayan en küçük yetki grubunu verin.
- Öğrencilerin kişisel verilerini öğrenci sisteminde tutun; hat yalnızca bir ad ve bir bitiş tarihi ister.
- En fazla bağlantıyı düşük tutun ve paylaşımı önlemek için oynatmayı izleyicinin adresine bağlamayı düşünün.
- Şifreli veritabanı yedeğini ve S3 uyumlu depolamanız varsa site dışı kopyayı açın.
Sorun giderme
Olağan ilk kontroller.
- Bir öğrenci giriş yapamıyor: hattın bitiş tarihini ve etkin olduğunu, ardından dersin paketini ve buketini kontrol edin.
- Bir kayıt oynamıyor: Jobs sayfasında ingest işinin sonucunu, ardından medya kökündeki dosyayı ve imzalı bağlantının süresini kontrol edin.
- Bir binanın izleyicileri origin'e düşüyor: node'un heartbeat'ini ve izleyicinin adresinin node'un yönlendirmesine girdiğini kontrol edin.
- API bir çağrıyı reddediyor: anahtarı, eylemin yöntemini (yazma işlemleri POST'tur) ve yeniden denenen çağrının istek kimliğini kontrol edin.