Tito průvodci promítají pojmy oboru do objektů, které platforma dnes má (bouquety, linky, balíčky, partnerské účty, uzly, API). Jde o konceptuální mapování, ne o funkce specifické pro obor, a partnerský účet je delegovaný účet, ne izolovaný tenant.
Konceptuální mapování
Nic v panelu se nenazývá kurz ani student. Tabulka říká, který objekt hraje jakou roli; níže uvedené kapitoly je nastavují v tomto pořadí.
| Ve vašem oboru | Na platformě | Kde v panelu |
|---|---|---|
| Školicí středisko nebo distribuční partner | Partnerský účet (reseller): delegovaný panel s kredity, oprávněními a vlastními linkami | Users → přidat resellera; Groups pro jeho oprávnění |
| Sbírka kurzů | Bouquet: pojmenovaná sada kanálů, filmů nebo seriálů, kterou balíček zpřístupní | Bouquets, ze Streams a Movies / Series |
| Nahrané lekce | VOD katalog: filmy a seriály se sezónami a epizodami, kategoriemi a metadaty | Movies a Series, nebo úloha ingestu VOD |
| Živá hodina | Živý kanál: stream se svými zdroji, EPG a výstupními formáty | Streams → přidat živý stream (URL zdroje nebo RTMP push) |
| Přístup studenta | Linka: jeden přístup se svým balíčkem, bouquety, expirací, limitem připojení a výstupy | Lines → přidat, nebo aktivační kódy, nebo Reseller API |
| Doba přístupu ke kurzu | Datum expirace linky, obnovované balíčkem, kreditem nebo přes API | Datum expirace linky a trvání balíčku |
| Limit souběžných relací | Max. připojení linky: kolik zařízení smí sledovat současně | Max. připojení linky |
| Integrace LMS nebo obchodního systému | Reseller API a webhooky: operace panelu z vašeho vlastního systému | Klíče Reseller API a webhooky v panelu resellera |
Předpoklady
Co mít připraveno před instalací.
- Linuxový server (Ubuntu 22.04 nebo 24.04) v kampusové síti s Postgres, Redis a ffmpeg nainstalovanými instalátorem a doménu nebo interní adresu pro panel a přehrávač.
- Nahrávky, které budete publikovat (soubory nebo záznamový systém, který umí posílat RTMP), a pro živé hodiny enkodér v každé místnosti, která bude streamovat.
- Licenční klíč: tarif Free žádný nevyžaduje; oprávněné instituce si bezplatný klíč Professional vyžádají e-mailem ze své akademické domény.
Nasazení infrastruktury
Nainstalujte řídicí server, poté uzel na budovu.
- Spusťte instalátor na řídicím serveru; nainstaluje panel, API, worker a origin jako jednotky systemd a vytvoří prvního administrátora.
- Nastavte veřejnou URL API (API_PUBLIC_URL) a základ přehrávání, aby odkazy přehrávače mířily na adresu kampusu.
- Zaregistrujte uzel z Servers → přidat uzel pro každou budovu, jejíž sály budou sledovat; panel jej nainstaluje přes SSH z balíčku uzlu.
- Zkontrolujte stránku Servers: uzel hlásí heartbeat a provoz a diváci té budovy jsou na něj směrováni.
Organizace obsahu
Kurzy jako seriály, programy jako bouquety a balíčky.
- Vytvořte jednu kategorii na fakultu nebo předmět v Movies / Series.
- Přidejte každý kurz jako seriál: jedna sezóna na modul, jedna epizoda na lekci, s nahrávkou jako zdrojem (nahrání nebo úloha ingestu VOD).
- Vytvořte jeden bouquet na sbírku kurzů (například kurzy programu na semestr) z přidaných seriálů.
- Vytvořte jeden balíček na program: bouquety, které zpřístupňuje, dobu přístupu jako jeho trvání a limit souběžných relací.
Konfigurace partnerů (resellerů)
Školicí středisko nebo fakulta jako delegovaný účet.
- V Groups vytvořte skupinu s oprávněními, která středisko potřebuje (vlastní linky, žádné změny katalogu).
- V Users přidejte středisko jako resellera s touto skupinou, zůstatkem kreditů a balíčky, které smí rozdávat.
- Dejte mu adresu panelu; své studenty odtud spravuje samo a panel vede auditní log.
Konfigurace přístupu studentů
Jedna linka na studenta, vytvořená při zápisu.
- Pro malé skupiny přidejte linky z Lines → přidat s balíčkem programu; expirace sleduje trvání balíčku.
- Pro den zápisu vygenerujte aktivační kódy pro balíček; student kód uplatní v přehrávači a získá linku.
- Pro studijní systém nebo LMS vytvořte klíč Reseller API a nechte systém vytvářet linky pomocí action=create_line a ID požadavku pro každého studenta.
- Nastavte max. připojení na počet zařízení, která student smí používat současně; přehrávač odmítne další připojení nad tento počet.
Nastavení VOD
Nahrané lekce na vyžádání.
- Nahrajte každou nahrávku jako zdroj epizody, nebo nasměrujte úlohu ingestu VOD na soubor a nechte worker stáhnout a zakódovat jej do kořene médií.
- Vyplňte metadata (název, popis, plakát) ručně nebo z TMDB pro veřejný materiál; lekce obvykle potřebují jen název a popis.
- Zkontrolujte přehrávání ve webovém přehrávači s testovací linkou; odkaz je podepsaný a po nastavené době vyprší.
Živé vysílání z učebny
Přednáška jako živý kanál.
- V Streams přidejte živý stream s enkodérem místnosti jako zdrojem (adresa RTMP push nebo pull URL).
- Zařaďte stream do bouquetu kurzu, aby jej viděli jen zapsaní studenti; přidejte jej do EPG, pokud vedete rozvrh.
- Zapněte na streamu catch-up nebo timeshift, když smějí studenti sledovat hodinu později; záznam lze také nahrát jako epizodu.
Předplatné a expirace přístupu
Přístup, který končí s kurzem.
- Nastavte balíčku dobu přístupu jako trvání; linka z něj vytvořená vyprší na konci této doby.
- Obnovte linku na nový semestr z panelu, kreditem střediska, nebo přes API pomocí action=renew_line.
- Přihlaste svůj systém k webhookům: dozví se, když linka brzy vyprší, vypršela nebo byla deaktivována.
Integrace s externím LMS
LMS řídí přístup; přehrávač přehrává.
- Vytvořte pro LMS klíč Reseller API; uložte jej do tajemství LMS, nikdy do stránky.
- Při zápisu LMS volá action=create_line s balíčkem programu a ID požadavku; při vyřazení action=disable_line.
- Odkazujte ze stránky kurzu v LMS na webový přehrávač nebo studentovi předejte údaje pro přehrávač; mezi nimi neexistuje jednotné přihlášení.
Bezpečnostní hlediska
Udržte službu uvnitř instituce.
- Zapněte dvoufázové přihlášení pro každý účet v panelu a dejte zaměstnancům nejmenší skupinu oprávnění, která funguje.
- Osobní údaje studentů ponechte ve studijním systému; linka potřebuje jen jméno a expiraci.
- Držte max. připojení nízko a zvažte svázání přehrávání s adresou diváka, aby se zabránilo sdílení.
- Zapněte šifrovanou zálohu databáze a, pokud máte úložiště kompatibilní s S3, kopii mimo lokalitu.
Řešení potíží
Obvyklé první kontroly.
- Student se nemůže přihlásit: zkontrolujte expiraci linky a že je povolená, poté balíček a bouquet kurzu.
- Nahrávka se nepřehrává: zkontrolujte výsledek úlohy ingestu na stránce Jobs, poté soubor v kořeni médií a expiraci podepsaného odkazu.
- Diváci budovy dosahují originu: zkontrolujte heartbeat uzlu a že adresa diváka spadá do směrování uzlu.
- API odmítá volání: zkontrolujte klíč, metodu akce (zápisy jsou POST) a ID požadavku opakovaného volání.