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 sal eller medlem. Tabellen anger vilket objekt som spelar vilken roll; kapitlen nedan sätter upp dem i den ordningen.
| I din bransch | På plattformen | Var i panelen |
|---|---|---|
| Utställningsfilm och arkiv | VOD-katalog: filmer och serier med säsonger och avsnitt, kategorier och metadata | Movies och Series, eller VOD-ingest-jobbet |
| Sändning av invigning eller föreläsning | 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) |
| Samling för salarna eller medlemmar | Bouquet: en namngiven uppsättning kanaler, filmer eller serier som ett paket ger tillgång till | Bouquets, från Strömmar och Movies / Series |
| Besökar- eller medlemsåtkomst | Linje: en åtkomst med sitt paket, sina bouquets, förfallodatum, anslutningsgräns och utdata | Linjer → lägg till, eller aktiveringskoder, eller Reseller API |
| Medlemsperiod | Linjens förfallodatum, som förnyas av ett paket, en kredit eller API:et | Linjens förfallodatum och paketets varaktighet |
| Enheter per medlem | Linjens max antal anslutningar: hur många enheter som får titta samtidigt | Linjens max antal anslutningar |
Förutsättningar
Vad du ska ha innan du installerar.
- En server i byggnaden (Ubuntu 22.04 eller 24.04), installationsprogrammet och salarnas nät som skärmarna och medlemmarnas enheter ska använda.
- Utställningsfilmen, arkivinspelningarna du har rättigheterna till, en encoder för föreläsningssalen och skärmarna eller mediaspelarna för salarna.
- Licensnyckeln och, om byggnaden saknar internet, proceduren för offlineaktivering; samt ett beslut om vem i receptionen som säljer medlemskap.
Driftsättning av infrastrukturen
Servern i byggnaden, aktiverad på plats.
- Kör installationsprogrammet på servern och ange uppspelningsbasens URL till den adress salarnas nät når.
- Aktivera licensnyckeln offline från panelen; efter aktiveringen körs tjänsten i det lokala nätet utan internet.
- Lägg till utställningsfilmen under Movies och föreläsningssalens flöde under Strömmar, och kontrollera dem i webbspelaren.
- För en andra plats eller ett stort publikt program, registrera en nod via Servers; panelen installerar den via SSH och dirigerar den platsens tittare till den.
Organisation av innehållet
Salar, arkiv och medlemssamlingar.
- Skapa kategorier per utställning och per år, och en serie för en föreläsningscykel med ett avsnitt per föredrag.
- Skapa en bouquet för skärmarna i salarna och en för medlemmarnas bibliotek med föredrag och arkivfilm.
- Skapa ett paket för salarna och ett per sorts medlemskap, vart och ett med sina bouquets; medlemspaketets löptid är medlemsperioden.
- Lägg till affischer och korta beskrivningar på varje film så att biblioteket läses bra i spelaren.
Konfiguration av partner (återförsäljare)
Receptionen och butiken som delegerade konton.
- Skapa en grupp med behörigheter begränsade till linjer och aktiveringskoder, och ingen åtkomst till katalogen eller servrarna.
- Lägg till receptionen, eller butiken, som återförsäljare med den gruppen, medlemspaketen och ett kreditsaldo.
- Ett kulturcenter med flera lokaler kan lägga till en återförsäljare per lokal, var och en säljer medlemskap från sitt eget saldo.
Konfiguration av besökar- och medlemsåtkomst
Skärmar och medlemmar på linjer.
- Skapa en linje per salskärm via Linjer → lägg till med salpaketet, och bind den till skärmens adress när nätet ger fasta adresser.
- Skapa aktiveringskoder i receptionen för varje sålt medlemskap; medlemmen anger koden i spelaren och linjen startar.
- Ställ in max antal anslutningar per medlemskap på det antal enheter en medlem får använda, vanligtvis två.
- Ge medlemmen spelarappen, en M3U-spellista eller webbspelarens adress, beroende på vad som passar deras enhet.
Utställningsfilm och arkiv
Biblioteket på begäran.
- Ladda upp utställningsfilmen och det digitaliserade arkivet som filmer, eller importera dem med VOD-ingestjobbet till mediarooten.
- Lägg till TMDB-metadata där den finns, och skriv titel och beskrivning själv för resten.
- Ha arkivmaterial som inte är för allmänheten bara i medlemsbouqueten, och kontrollera vad varje paket ser med en testlinje.
Invigningar och föreläsningar
Ett evenemang som en livekanal.
- Lägg till en live-ström för föreläsningssalens encoder (RTMP-push) och placera den i medlemsbouqueten, eller i salbouqueten för en invigning som visas på skärmarna.
- Aktivera catch-up så att en medlem som kommer sent kan spola tillbaka, och ladda upp inspelningen till biblioteket efteråt.
- Testa encodern och strömmen före evenemanget med en testlinje, i samma nät som publiken kommer att använda.
Medlemskapets förfallodatum och förnyelse
Medlemskapet som linjens giltighet.
- En linje går ut vid slutet av sitt pakets period; en förnyelse i receptionen lägger till ytterligare en period.
- Inaktivera en linje när ett medlemskap sägs upp; aktiveringskoder som aldrig har använts förblir oanvända tills de löses in.
- Prenumerera butiken eller medlemssystemet på webhooks för att se linjer som snart går ut eller redan har gått ut.
Integration med butiken eller medlemssystemet
Systemen säljer åtkomsten; spelaren spelar.
- Skapa en Reseller API-nyckel för butiken eller medlemssystemet; det anropar create_line, renew_line och disable_line, med ett request-id på varje skrivning.
- Använd en handelsconnector när medlemskap säljs online; alla andra system använder Reseller API och webhooks.
- Det finns ingen single sign-on för tittare: en medlem loggar in i spelaren med linjens inloggningsuppgifter eller aktiveringskoden.
Säkerhetsaspekter
Behåll samlingarna där de hör hemma.
- Håll salarnas nät åtskilt från besökarnas nät, och servera all publik åtkomst bakom en reverse proxy med TLS och TRUSTED_PROXIES inställt.
- Tvåfaktorsinloggning för varje panelkonto; receptionen får en behörighetsgrupp begränsad till linjer och koder.
- Signerade uppspelningslänkar som går ut, en anslutningsgräns per medlemskap och adressbindning för skärmarna i salarna.
- Aktivera den krypterade databassäkerhetskopian med en kopia utanför platsen, och använd granskningsloggen för att granska ändringar av linjer och katalog.
Felsökning
De vanliga första kontrollerna.
- En salskärm är svart: kontrollera att dess linje är aktiverad och inte har gått ut, skärmens adressbindning och att servern kan nås i salarnas nät.
- En medlems kod fungerar inte: kontrollera att koden inte redan har lösts in och att paketet den öppnar fortfarande är tilldelat receptionen.
- Licensaktiveringen misslyckas offline: kontrollera aktiveringsfilen mot licensnyckeln och serverns klocka.
- Liveinvigningen hackar: kontrollera encoderns bitrate mot uplinken och strömmens status under Strömmar.