Deze gidsen koppelen de begrippen van een sector aan de objecten die het platform vandaag heeft (bouquets, lijnen, pakketten, partneraccounts, nodes, de API). Het zijn conceptuele toewijzingen, geen sectorspecifieke functies, en een partneraccount is een gedelegeerd account, geen geïsoleerde tenant.
Conceptuele toewijzing
Niets in het paneel heet een cursus of een student. De tabel zegt welk object welke rol speelt; de hoofdstukken hieronder zetten ze in die volgorde op.
| In je sector | Op het platform | Waar in het paneel |
|---|---|---|
| Opleidingscentrum of distributiepartner | Partneraccount (reseller): een gedelegeerd dashboard met credits, rechten en eigen lijnen | Users → een reseller toevoegen; Groups voor zijn rechten |
| Cursuscollectie | Bouquet: een benoemde set kanalen, films of series die een pakket toekent | Bouquets, vanuit Streams en Movies / Series |
| Opgenomen lessen | VOD-catalogus: films en series met seizoenen en afleveringen, categorieën en metadata | Movies en Series, of de VOD-ingesttaak |
| Live les | Live kanaal: een stream met zijn bronnen, EPG en uitvoerformaten | Streams → een live stream toevoegen (bron-URL of RTMP-push) |
| Studenttoegang | Lijn: één toegang met pakket, bouquets, vervaldatum, verbindingslimiet en uitvoer | Lijnen → toevoegen, of activeringscodes, of de Reseller-API |
| Toegangsperiode van de cursus | Vervaldatum van de lijn, verlengd door een pakket, een credit of de API | De vervaldatum van de lijn en de looptijd van het pakket |
| Limiet voor gelijktijdige sessies | Max. verbindingen van de lijn: hoeveel apparaten tegelijk mogen kijken | De max. verbindingen van de lijn |
| LMS- of webshopintegratie | Reseller-API en webhooks: de handelingen van het paneel vanuit je eigen systeem | Reseller-API-sleutels en webhooks in het dashboard van de reseller |
Vereisten
Wat je moet hebben vóór de installatie.
- Een Linux-server (Ubuntu 22.04 of 24.04) op het campusnetwerk met Postgres, Redis en ffmpeg die het installatieprogramma installeert, en een domein of intern adres voor het paneel en de player.
- De opnames die je gaat publiceren (bestanden of een opnamesysteem dat RTMP kan pushen) en, voor live lessen, een encoder in elke zaal die gaat streamen.
- Een licentiesleutel: het Free-abonnement heeft er geen nodig; kwalificerende instellingen vragen de gratis Professional-sleutel per e-mail aan vanaf hun academische domein.
Uitrol van de infrastructuur
Installeer de beheerserver, daarna een node per gebouw.
- Start het installatieprogramma op de beheerserver; het installeert het paneel, de API, de worker en de origin als systemd-units en maakt de eerste beheerder aan.
- Stel de openbare URL van de API (API_PUBLIC_URL) en van de playback base in zodat de playerlinks naar het campusadres wijzen.
- Registreer een node via Servers → een node toevoegen voor elk gebouw waarvan de zalen gaan kijken; het paneel installeert die via SSH vanuit het nodepakket.
- Controleer de pagina Servers: de node meldt zijn heartbeat en verkeer en kijkers in dat gebouw worden ernaartoe geleid.
Indeling van de content
Cursussen als series, opleidingen als bouquets en pakketten.
- Maak één categorie per faculteit of vak onder Movies / Series.
- Voeg elke cursus toe als serie: één seizoen per module, één aflevering per les, met de opname als bron (upload of de VOD-ingesttaak).
- Maak één bouquet per cursuscollectie (bijvoorbeeld de cursussen van een opleiding voor één periode) van de series die je hebt toegevoegd.
- Maak één pakket per opleiding: de bouquets die het toekent, de toegangsperiode als looptijd en de limiet voor gelijktijdige sessies.
Configuratie van partners (resellers)
Een opleidingscentrum of faculteit als gedelegeerd account.
- Maak onder Groups een groep met de rechten die het centrum nodig heeft (eigen lijnen, geen cataloguswijzigingen).
- Voeg het centrum onder Users toe als reseller met die groep, een creditsaldo en de pakketten die het mag uitdelen.
- Geef het het dashboardadres; het beheert vanaf daar zijn eigen studenten en het paneel houdt het auditlog bij.
Configuratie van studententoegang
Eén lijn per student, aangemaakt bij de inschrijving.
- Voeg voor kleine groepen lijnen toe via Lijnen → toevoegen met het pakket van de opleiding; de vervaldatum volgt de looptijd van het pakket.
- Genereer voor de inschrijfdag activeringscodes voor het pakket; een student wisselt een code in de player in en krijgt een lijn.
- Maak voor een studentensysteem of LMS een Reseller-API-sleutel aan en laat het systeem lijnen aanmaken met action=create_line en een request-id per student.
- Stel max. verbindingen in op het aantal apparaten dat een student tegelijk mag gebruiken; de player weigert de eerstvolgende verbinding daarboven.
VOD-setup
Opgenomen lessen on demand.
- Upload elke opname als bron van een aflevering, of wijs de VOD-ingesttaak naar het bestand en laat de worker het downloaden en coderen in de mediaroot.
- Vul de metadata (titel, beschrijving, poster) handmatig of vanuit TMDB voor openbaar materiaal; lessen hebben meestal alleen een titel en een beschrijving nodig.
- Controleer het afspelen in de webplayer met een testlijn; de link is ondertekend en verloopt na de ingestelde tijd.
Live klasstreaming
Een college als live kanaal.
- Voeg onder Streams een live stream toe met de encoder van de zaal als bron (een RTMP-pushadres of een pull-URL).
- Zet de stream in de bouquet van de cursus zodat alleen ingeschreven studenten hem zien; voeg hem toe aan de EPG als je een rooster bijhoudt.
- Schakel catch-up of timeshift in op de stream wanneer studenten een les later mogen bekijken; de opname kan ook als aflevering worden geüpload.
Abonnement en toegangsverloop
Toegang die met de cursus eindigt.
- Geef het pakket de toegangsperiode als looptijd; een lijn die ermee is aangemaakt verloopt aan het einde van die periode.
- Verleng een lijn voor een nieuwe periode vanuit het paneel, met een credit van het centrum, of via de API met action=renew_line.
- Abonneer je systeem op de webhooks: het wordt verwittigd wanneer een lijn bijna verloopt, verlopen is of is uitgeschakeld.
Integratie met een externe LMS
De LMS stuurt de toegang aan; de player speelt af.
- Maak een Reseller-API-sleutel voor de LMS; bewaar die in de geheimen van de LMS, nooit op een pagina.
- Bij inschrijving roept de LMS action=create_line aan met het pakket van de opleiding en een request-id; bij uitschrijving action=disable_line.
- Link vanaf de cursuspagina van de LMS naar de webplayer of geef de student de inloggegevens van de player; er is geen single sign-on tussen beide.
Beveiligingsoverwegingen
Houd de dienst binnen de instelling.
- Schakel tweestapsverificatie in voor elk paneelaccount en geef medewerkers de kleinste rechtengroep die werkt.
- Houd persoonsgegevens van studenten in het studentensysteem; de lijn heeft alleen een naam en een vervaldatum nodig.
- Houd max. verbindingen laag en overweeg het afspelen aan het adres van de kijker te binden om delen te voorkomen.
- Schakel de versleutelde databaseback-up in en, als je S3-compatibele opslag hebt, de kopie buiten de locatie.
Probleemoplossing
De gebruikelijke eerste controles.
- Een student kan zich niet aanmelden: controleer de vervaldatum van de lijn en of die is ingeschakeld, daarna het pakket en de bouquet van de cursus.
- Een opname speelt niet af: controleer het resultaat van de ingesttaak op de pagina Taken, daarna het bestand in de mediaroot en de vervaldatum van de ondertekende link.
- Kijkers van een gebouw komen bij de origin uit: controleer de heartbeat van de node en of het adres van de kijker onder de routering van de node valt.
- De API weigert een aanroep: controleer de sleutel, de methode van de actie (schrijfacties zijn POST) en het request-id van een herhaalde aanroep.