Ana sayfa
XtreamUIPro

Kurulum kılavuzu

Üniversiteler ve Kampüsler kurulum kılavuzu

Platformu bir üniversitenin televizyon ve video hizmeti olarak yapılandırın: kampüs kanalları, fakülte bazında ders arşivleri, kendi node'larındaki yurtlar ve öğrenci bilgi sisteminin yönettiği öğrenci erişimi.

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 fakülte, dönem veya öğrenci 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üzdePlatformdaPanelde nerede
Fakülte veya bölüm hesabıBayi hesabı (reseller): kredisi, yetkileri ve kendi hatları olan devredilmiş bir panelUsers → bayi ekle; yetkileri için Groups
Fakülte koleksiyonu veya kampüs kanal listesiBuket: bir paketin verdiği, adlandırılmış kanal, film veya dizi kümesiBouquets, Streams ve Movies / Series'ten
Kampüs kanalı veya canlı etkinlikCanlı kanal: kaynakları, EPG'si ve çıkış formatları olan bir yayınStreams → canlı yayın ekle (kaynak URL'si veya RTMP push)
Ders arşiviVOD kataloğu: sezon ve bölümlü filmler ve diziler, kategoriler ve meta veriMovies ve Series ya da VOD ingest işi
Öğrenci veya personel erişimiHat: paketi, buketleri, bitiş tarihi, bağlantı sınırı ve çıkışlarıyla tek bir erişimLines → ekle, veya etkinleştirme kodları, veya Reseller API
Dönemin veya kaydın sonuHattın bitiş tarihi; bir paket, bir kredi veya API ile yenilenirHattın bitiş tarihi ve paketin süresi
Kampüs veya yurt node'uYayın node'ları: panelden kaydedilen edge sunucular, her site veya bina için bir taneServers → node ekle, SSH ile kurulur
Öğrenci bilgi sistemi entegrasyonuReseller API ve webhook'lar: panelin işlemleri kendi sisteminizdenBayinin panelindeki Reseller API anahtarları ve webhook'lar

Ön koşullar

Kurmadan önce nelere sahip olmalı.

  1. Diğer kampüslerden ve yurtlardan erişilebilen ana kampüste bir sunucu (Ubuntu 22.04 veya 24.04), kurulum aracı ve reverse proxy'nizin arkasında dahili bir adres veya alan adı.
  2. Kampüs kanal beslemeleri ve ders kayıtları (veya ders yakalama sisteminin dışa aktarımı) ve öğrenci bilgi sisteminin bir HTTP API çağırabilmesi.
  3. Yapı hakkında bir karar: hangi fakültelerin ortak hesabı alacağı, ders dizilerinin nasıl adlandırılacağı ve bir dönem paketinin ne kadar süreceği.

Altyapı dağıtımı

Önce ana kampüs, sonra diğer sahalar.

  1. Kurulum aracını ana kampüs sunucusunda çalıştırın; paneli üniversitenin reverse proxy'sinin arkasına koyun ve günlükler ile IP kuralları gerçek adresleri görsün diye güvenilir proxy'leri ayarlayın.
  2. Oynatma tabanını öğrencilerin kampüsten ve yurtlardan eriştiği adrese ayarlayın.
  3. Servers'tan kampüs ve yurt başına bir node kaydedin; panel onu SSH ile kurar ve o sahanın izleyicilerini ona yönlendirir.
  4. Lisans anahtarını sunucuda ayarlayın; akademik bir alan adına sahip bir kurum, eğitim programının ücretsiz Professional anahtarını e-postayla talep edebilir.

İçerik organizasyonu

Fakülte koleksiyonları ve kampüs kanal listesi.

  1. Fakülte ve ders başına kategoriler oluşturun ve kurs başına, dönem başına bir sezon ve ders başına bir bölümle bir dizi oluşturun.
  2. Fakülte koleksiyonu başına bir buket, kampüs kanalları için bir buket ve oryantasyon videoları gibi ortak malzeme için bir buket oluşturun.
  3. Öğrenciler ve personel için paketler oluşturun: her birinin ihtiyaç duyduğu buketler, süre olarak dönemle; böylece yenilenmedikçe erişim dönemle biter.
  4. Açık kapı günleri veya misafir öğrenciler için kısa bir deneme paketi oluşturun.

Ortak (bayi) yapılandırması

Devredilmiş hesap olarak fakülteler.

  1. Hatlar ve fakültenin kendi kataloğu için yetkisi olan, ayarlara erişimi olmayan bir grup oluşturun.
  2. Her fakülteyi veya bölümü o grup ve paketleriyle bir ortak hesabı (bayi) olarak ekleyin; alt bayiler bir fakülte içindeki bölümleri yansıtabilir.
  3. Bir fakülte yalnızca kendi hatlarını görür ve yönetir; merkez ekip tüm görünümü korur. Devredilmiş bir hesaptır, yalıtılmış bir kurulum değil.

Öğrenci erişimi yapılandırması

SIS'ten öğrenci başına bir hat.

  1. Öğrenci bilgi sistemi için bir Reseller API anahtarı oluşturun ve o sistemin gizli bilgileri arasında tutun.
  2. Kayıtta SIS, öğrencinin paketi ve bir istek kimliğiyle action=create_line çağırır; paketin süresi olan dönem, erişim süresidir.
  3. En fazla bağlantıyı bir öğrencinin aynı anda kullanabileceği cihaz sayısına (genellikle iki: telefon ve dizüstü) ayarlayın.
  4. Personel ve bir pilot için Lines → add'den hat ekleyin ve kimlik bilgilerini verin.

Ders arşivleri

İsteğe bağlı kayıtlar.

  1. Her kaydı bir bölümün kaynağı olarak yükleyin veya VOD ingest işiyle içe alın; kurs başlığını ve kısa bir açıklamayı tutun.
  2. Diziyi fakültenin buketine bağlayın; böylece kursu yalnızca paketi onu veren öğrenciler görür.
  3. Kimin neyi gördüğünü doğrulamak için her paketin bir test hattıyla oynatmayı kontrol edin.

Kampüs kanalları ve canlı etkinlikler

Kampüs için canlı kanallar.

  1. Kampüs kanal beslemelerini Streams altına canlı yayın olarak ve rehber için bir EPG kaynağı ekleyin.
  2. Ders salonu veya etkinlik başına, salonun kodlayıcısının RTMP ile beslediği bir canlı yayın ekleyin ve geç gelen izleyiciler geri sarabilsin diye catch-up'ı etkinleştirin.
  3. Her kanalı doğru buketin içine koyun; yurtlardaki node'lar onu origin'den bir kez alır ve öğrencilere yerel olarak hizmet verir.

Bitiş ve yenileme

Hattın geçerliliği olarak dönem.

  1. Bir hat paketinin dönemi sonunda sona erer; yeniden kayıtta SIS action=renew_line çağırır ve bir dönem daha eklenir.
  2. Bir öğrenci kaydını sildirdiğinde veya mezun olduğunda SIS action=disable_line çağırır.
  3. Süresi dolmak üzere olan ve dolmuş hatları kayıtlarıyla uzlaştırmak için SIS'i webhook'lara abone edin.

Öğrenci bilgi sistemiyle entegrasyon

SIS erişimi yönetir; oynatıcı oynatır.

  1. SIS, Reseller API üzerinden bir anahtar ve istek kimliğiyle hat oluşturur, yeniler, etkinleştirir ve devre dışı bırakır.
  2. İzleyiciler için tek oturum açma ve yerel LMS veya SIS entegrasyonu yoktur: öğrenci oynatıcıda hattın kimlik bilgileriyle oturum açar ve LMS'teki bir kurs sayfası web oynatıcıya bağlantı verebilir.
  3. Dahili raporlama araçları için salt okunur bayraklı, IP izin listeli ve bitiş tarihli Admin API anahtarları kullanın.

Güvenlik değerlendirmeleri

Erişimi öğrenciler ve personelle sınırlı tutun.

  1. Platformu kampüs ağında veya TLS'li reverse proxy'nin arkasında tutun; TRUSTED_PROXIES'i proxy'ye ayarlayın.
  2. Her panel hesabı için iki adımlı oturum açma ve rol başına bir yetki grubu; böylece bir fakülte başka bir fakültenin hatlarını göremez.
  3. İmzalı ve süresi dolan oynatma bağlantıları, hat başına bağlantı sınırı ve işe yaradığı yerde bir ülkeye veya adrese bağlama.
  4. Site dışı kopyalı şifreli veritabanı yedekleri ve hatların ve kataloğun her değişikliği için denetim günlüğü.

Sorun giderme

Olağan ilk kontroller.

  1. Bir öğrenci ders görmüyor: hattın bitiş tarihini, sonra paketi ve verdiği buketleri kontrol edin.
  2. Yeni bir öğrencinin erişimi yok: SIS çağrısının Reseller API çağrı günlüğünde başarılı olduğunu ve istek kimliğinin yeni olduğunu kontrol edin.
  3. Bir yurt akşamları takılıyor: node'unun heartbeat'ini ve izleyicilerin ona yönlendirildiğini kontrol edin.
  4. Denetim günlüğü proxy'nin adresini gösteriyor: TRUSTED_PROXIES'i proxy'ye ayarlayın ve paneli yeniden başlatın.