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 zaal of een lid. De tabel zegt welk object welke rol speelt; de hoofdstukken hieronder richten ze in die volgorde in.
| In je sector | Op het platform | Waar in het paneel |
|---|---|---|
| Tentoonstellingsfilm en archief | VOD-catalogus: films en series met seizoenen en afleveringen, categorieën en metadata | Movies en Series, of de VOD-ingesttaak |
| Uitzending van opening of lezing | Live kanaal: een stream met zijn bronnen, EPG en uitvoerformaten | Streams → een live stream toevoegen (bron-URL of RTMP-push) |
| Collectie van de zalen of van leden | Bouquet: een benoemde set kanalen, films of series die een pakket toekent | Bouquets, vanuit Streams en Movies / Series |
| Toegang van bezoeker of lid | Lijn: één toegang met pakket, bouquets, vervaldatum, verbindingslimiet en uitvoer | Lijnen → toevoegen, of activeringscodes, of de Reseller-API |
| Lidmaatschapsperiode | Vervaldatum van de lijn, verlengd door een pakket, een credit of de API | De vervaldatum van de lijn en de looptijd van het pakket |
| Apparaten per lid | Max. verbindingen van de lijn: hoeveel apparaten tegelijk mogen kijken | De max. verbindingen van de lijn |
Vereisten
Wat je nodig hebt voor de installatie.
- Een server in het gebouw (Ubuntu 22.04 of 24.04), de installer en het netwerk van de zalen dat de schermen en de apparaten van de leden zullen gebruiken.
- De tentoonstellingsfilm, de archiefopnames waarvoor je de rechten hebt, een encoder voor de collegezaal en de schermen of mediaspelers voor de zalen.
- De licentiesleutel en, als het gebouw geen internet heeft, de procedure voor offline activering; en een besluit over wie aan de balie lidmaatschappen verkoopt.
Uitrol van de infrastructuur
De server in het gebouw, ter plaatse geactiveerd.
- Draai de installer op de server en stel de afspeelbasis-URL in op het adres dat het netwerk van de zalen bereikt.
- Activeer de licentiesleutel offline vanuit het paneel; na activering draait de dienst op het lokale netwerk zonder internet.
- Voeg de tentoonstellingsfilm toe onder Movies en de feed van de collegezaal onder Streams, en controleer ze in de webspeler.
- Meld voor een tweede locatie of een groot publiek programma een node aan via Servers; het paneel installeert hem via SSH en stuurt de kijkers van die locatie ernaartoe.
Indeling van de content
Zalen, archief en ledencollecties.
- Maak categorieën per tentoonstelling en per jaar, en een serie voor een lezingencyclus met één aflevering per lezing.
- Maak één bouquet voor de schermen in de zalen en één voor de ledenbibliotheek met lezingen en archieffilms.
- Maak een pakket voor de zalen en één per soort lidmaatschap, elk met zijn bouquets; de looptijd van het lidmaatschapspakket is de lidmaatschapsperiode.
- Voeg posters en korte beschrijvingen toe aan elke film, zodat de bibliotheek in de speler goed leest.
Configuratie van partners (resellers)
De balie en de shop als gedelegeerde accounts.
- Maak een groep met rechten die beperkt zijn tot lijnen en activeringscodes, en zonder toegang tot de catalogus of de servers.
- Voeg de balie, of de shop, toe als reseller met die groep, de lidmaatschapspakketten en een creditsaldo.
- Een cultuurcentrum met meerdere locaties kan per locatie een reseller toevoegen, elk met lidmaatschappen uit zijn eigen saldo.
Configuratie van toegang voor bezoekers en leden
Schermen en leden op lijnen.
- Maak onder Lijnen → toevoegen één lijn per zaalscherm aan met het zalenpakket, en koppel hem aan het adres van het scherm wanneer het netwerk vaste adressen geeft.
- Maak aan de balie activeringscodes aan voor elk verkocht lidmaatschap; het lid voert de code in de speler in en de lijn start.
- Stel het maximale aantal verbindingen per lidmaatschap in op het aantal apparaten dat een lid mag gebruiken, doorgaans twee.
- Geef het lid de speler-app, een M3U-afspeellijst of het adres van de webspeler, wat bij zijn apparaat past.
Tentoonstellingsfilm en archief
De bibliotheek op aanvraag.
- Upload de tentoonstellingsfilm en het gedigitaliseerde archief als films, of importeer ze met de VOD-ingesttaak in de mediaroot.
- Voeg TMDB-metadata toe waar die bestaat, en schrijf voor de rest zelf de titel en beschrijving.
- Houd het archief dat niet voor het publiek is alleen in de ledenbouquet, en controleer met een testlijn wat elk pakket ziet.
Openingen en lezingen
Een evenement als live kanaal.
- Voeg een live stream toe voor de encoder van de collegezaal (RTMP-push) en plaats hem in de ledenbouquet, of in de zalenbouquet voor een opening die op de schermen wordt getoond.
- Schakel catch-up in zodat een lid dat later binnenkomt kan terugspoelen, en upload de opname daarna naar de bibliotheek.
- Test de encoder en de stream vóór het evenement met een testlijn, op hetzelfde netwerk dat het publiek zal gebruiken.
Vervaldatum en verlenging van het lidmaatschap
Het lidmaatschap als geldigheid van de lijn.
- Een lijn verloopt aan het einde van de periode van zijn pakket; een verlenging aan de balie voegt een nieuwe periode toe.
- Schakel een lijn uit wanneer een lidmaatschap wordt opgezegd; activeringscodes die nooit zijn gebruikt blijven ongebruikt totdat ze worden verzilverd.
- Abonneer de shop of het ledensysteem op de webhooks om lijnen te zien die bijna verlopen of al zijn verlopen.
Integratie met de shop of het ledensysteem
Systemen verkopen de toegang; de speler speelt af.
- Maak een Reseller-API-sleutel voor de shop of het ledensysteem; die roept create_line, renew_line en disable_line aan, met een request-id bij elke schrijfactie.
- Gebruik een commerceconnector wanneer lidmaatschappen online worden verkocht; elk ander systeem gebruikt de Reseller-API en webhooks.
- Er is geen single sign-on voor kijkers: een lid meldt zich in de speler aan met de inloggegevens van de lijn of de activeringscode.
Beveiligingsoverwegingen
Houd de collecties waar ze horen.
- Houd het netwerk van de zalen gescheiden van het netwerk van de bezoekers, en serveer elke publieke toegang achter een reverse proxy met TLS en TRUSTED_PROXIES ingesteld.
- Aanmelden met twee factoren voor elk paneelaccount; de balie krijgt een rechtengroep die beperkt is tot lijnen en codes.
- Ondertekende en verlopende afspeellinks, een verbindingslimiet per lidmaatschap en adresbinding voor de zaalschermen.
- Schakel de versleutelde databaseback-up met een off-sitekopie in en gebruik het auditlogboek om wijzigingen van lijnen en catalogus te controleren.
Probleemoplossing
De gebruikelijke eerste controles.
- Een zaalscherm is zwart: controleer of zijn lijn is ingeschakeld en niet is verlopen, de adresbinding van het scherm en of de server bereikbaar is op het netwerk van de zalen.
- De code van een lid werkt niet: controleer of de code al is verzilverd en of het pakket dat hij opent nog aan de balie is toegewezen.
- Licentieactivering mislukt offline: controleer het activeringsbestand ten opzichte van de licentiesleutel en de klok van de server.
- De live opening hapert: controleer de bitrate van de encoder ten opzichte van de uplink en de status van de stream onder Streams.