Dessa guider kopplar en branschs begrepp till de objekt som plattformen har i dag (bouquets, linjer, paket, partnerkonton, noder, API:et). De är begreppsmässiga motsvarigheter, inte branschspecifika funktioner, och ett partnerkonto är ett delegerat konto, inte en isolerad hyresgäst.
Begreppsmässig mappning
Inget i panelen heter kurs eller student. Tabellen visar vilket objekt som spelar vilken roll; kapitlen nedan sätter upp dem i den ordningen.
| I din bransch | På plattformen | Var i panelen |
|---|---|---|
| Utbildningscenter eller distributionspartner | Partnerkonto (återförsäljare): en delegerad panel med krediter, behörigheter och egna linjer | Users → lägg till en återförsäljare; Groups för dess behörigheter |
| Kurssamling | Bouquet: en namngiven uppsättning kanaler, filmer eller serier som ett paket ger tillgång till | Bouquets, från Strömmar och Movies / Series |
| Inspelade lektioner | VOD-katalog: filmer och serier med säsonger och avsnitt, kategorier och metadata | Movies och Series, eller VOD-ingest-jobbet |
| Liveundervisning | Live-kanal: en ström med sina källor, EPG och utdataformat | Strömmar → lägg till en live-ström (käll-URL eller RTMP-push) |
| Studentåtkomst | Linje: en åtkomst med sitt paket, sina bouquets, förfallodatum, anslutningsgräns och utdata | Linjer → lägg till, eller aktiveringskoder, eller Reseller API |
| Kursens åtkomstperiod | Linjens förfallodatum, som förnyas av ett paket, en kredit eller API:et | Linjens förfallodatum och paketets varaktighet |
| Gräns för samtidiga sessioner | Linjens max antal anslutningar: hur många enheter som får titta samtidigt | Linjens max antal anslutningar |
| LMS- eller handelsintegration | Reseller API och webhooks: panelens operationer från ditt eget system | Reseller API-nycklar och webhooks i återförsäljarens panel |
Förutsättningar
Vad du ska ha innan du installerar.
- En Linux-server (Ubuntu 22.04 eller 24.04) i campusnätet med Postgres, Redis och ffmpeg installerade av installationsprogrammet, och en domän eller en intern adress för panelen och spelaren.
- De inspelningar du ska publicera (filer eller ett inspelningssystem som kan skicka RTMP) och, för liveundervisning, en encoder i varje sal som ska streama.
- En licensnyckel: Free-planen kräver ingen; kvalificerade institutioner begär den gratis Professional-nyckeln via e-post från sin akademiska domän.
Driftsättning av infrastrukturen
Installera hanteringsservern, sedan en nod per byggnad.
- Kör installationsprogrammet på hanteringsservern; det installerar panelen, API:et, workern och origin som systemd-enheter och skapar den första administratören.
- Ange den publika URL:en för API:et (API_PUBLIC_URL) och för uppspelningsbasen så att spelarlänkarna pekar på campusadressen.
- Registrera en nod via Servers → lägg till en nod för varje byggnad vars salar ska titta; panelen installerar den via SSH från nodpaketet.
- Kontrollera sidan Servers: noden rapporterar sin heartbeat och trafik, och tittarna i den byggnaden dirigeras till den.
Organisation av innehållet
Kurser som serier, program som bouquets och paket.
- Skapa en kategori per fakultet eller ämne under Movies / Series.
- Lägg till varje kurs som en serie: en säsong per modul, ett avsnitt per lektion, med inspelningen som källa (uppladdning eller VOD-ingest-jobbet).
- Skapa en bouquet per kurssamling (till exempel ett programs kurser för en termin) av de serier du lade till.
- Skapa ett paket per program: de bouquets det ger tillgång till, åtkomstperioden som varaktighet och gränsen för samtidiga sessioner.
Konfiguration av partner (återförsäljare)
Ett utbildningscenter eller en fakultet som ett delegerat konto.
- Skapa en grupp med de behörigheter som centret behöver (egna linjer, inga katalogändringar) under Groups.
- Lägg till centret som återförsäljare under Users med den gruppen, ett kreditsaldo och de paket det får dela ut.
- Ge det panelens adress; det sköter sina egna studenter därifrån, och panelen för granskningsloggen.
Konfiguration av studentåtkomst
En linje per student, skapad vid antagningen.
- För små kullar, lägg till linjer via Linjer → lägg till med programmets paket; förfallodatumet följer paketets varaktighet.
- För antagningsdagen, generera aktiveringskoder för paketet; en student löser in en kod i spelaren och får en linje.
- För ett studentsystem eller ett LMS, skapa en Reseller API-nyckel och låt systemet skapa linjer med action=create_line och ett begärans-id per student.
- Ställ in max antal anslutningar på det antal enheter som en student får använda samtidigt; spelaren nekar nästa anslutning utöver det.
Uppsättning av VOD
Inspelade lektioner på begäran.
- Ladda upp varje inspelning som ett avsnitts källa, eller peka VOD-ingest-jobbet på filen och låt workern ladda ner och koda den till mediarotkatalogen.
- Fyll i metadata (titel, beskrivning, affisch) för hand eller från TMDB för offentligt material; lektioner behöver oftast bara en titel och en beskrivning.
- Kontrollera uppspelningen i webbspelaren med en testlinje; länken är signerad och går ut efter den inställda tiden.
Livestreaming från klassrummet
En föreläsning som en live-kanal.
- Lägg till en live-ström under Strömmar med salens encoder som källa (en RTMP-push-adress eller en pull-URL).
- Lägg streamen i kursens bouquet så att bara antagna studenter ser den; lägg till den i EPG om du för ett schema.
- Aktivera catch-up eller timeshift på streamen när studenter får titta på en klass senare; inspelningen kan också laddas upp som ett avsnitt.
Prenumeration och när åtkomsten går ut
Åtkomst som slutar med kursen.
- Ge paketet åtkomstperioden som varaktighet; en linje som skapas av det går ut vid periodens slut.
- Förnya en linje för en ny termin från panelen, med en kredit från centret, eller via API:et med action=renew_line.
- Prenumerera på webhooks med ditt system: det får veta när en linje snart går ut, har gått ut eller har inaktiverats.
Integration med ett externt LMS
LMS:et styr åtkomsten; spelaren spelar upp.
- Skapa en Reseller API-nyckel för LMS:et; förvara den bland LMS:ets hemligheter, aldrig på en sida.
- Vid antagning anropar LMS:et action=create_line med programmets paket och ett begärans-id; vid avhopp action=disable_line.
- Länka från LMS:ets kurssida till webbspelaren eller ge studenten inloggningsuppgifterna till spelaren; det finns ingen single sign-on mellan de två.
Säkerhetsaspekter
Håll tjänsten inom institutionen.
- Aktivera tvåfaktorsinloggning för varje panelkonto och ge personalen den minsta behörighetsgrupp som fungerar.
- Behåll studenternas personuppgifter i studentsystemet; linjen behöver bara ett namn och ett förfallodatum.
- Håll max antal anslutningar lågt och överväg att binda uppspelningen till tittarens adress för att förhindra delning.
- Slå på den krypterade databassäkerhetskopian och, om du har S3-kompatibel lagring, kopian utanför platsen.
Felsökning
De vanliga första kontrollerna.
- En student kan inte logga in: kontrollera linjens förfallodatum och att den är aktiverad, sedan paketet och kursens bouquet.
- En inspelning spelas inte upp: kontrollera ingest-jobbets resultat på sidan Jobs, sedan filen i mediarotkatalogen och den signerade länkens förfallotid.
- En byggnads tittare hamnar på origin: kontrollera nodens heartbeat och att tittarens adress ingår i nodens routing.
- API:et nekar ett anrop: kontrollera nyckeln, åtgärdens metod (skrivningar är POST) och begärans-id vid ett upprepat anrop.