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 lägenhet eller boende. 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 |
|---|---|---|
| Fastighetsförvaltarens konto | 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 |
| Kanalutbud | Bouquet: en namngiven uppsättning kanaler, filmer eller serier som ett paket ger tillgång till | Bouquets, från Strömmar och Movies / Series |
| Kanal eller informationskanal | 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) |
| Välkomst- och meddelandevideor | VOD-katalog: filmer och serier med säsonger och avsnitt, kategorier och metadata | Movies och Series, eller VOD-ingest-jobbet |
| Lägenhetens åtkomst | Linje: en åtkomst med sitt paket, sina bouquets, förfallodatum, anslutningsgräns och utdata | Linjer → lägg till, eller aktiveringskoder, eller Reseller API |
| Hyres- eller boendeperiod | Linjens förfallodatum, som förnyas av ett paket, en kredit eller API:et | Linjens förfallodatum och paketets varaktighet |
| Byggnadens nod | Streamingnoder: edge-servrar som registreras från panelen, en per plats eller byggnad | Servers → lägg till en nod, installerad via SSH |
Förutsättningar
Vad du ska ha innan du installerar.
- En server för förvaltningen (Ubuntu 22.04 eller 24.04), installationsprogrammet och en server för varje byggnad som kan nå de boendes nät.
- De kanalflöden området får vidaresända (pull-URL:er eller RTMP), förvaltningens meddelanden och välkomstvideor, och de boendes enheter (set-top-boxar, smart-TV med en spelarapp, eller en webbläsare).
- Ett beslut om bostadstyperna (standard, senior, student), och vem i förvaltningen som öppnar och förnyar linjer.
Driftsättning av infrastrukturen
Den centrala servern, sedan en nod per byggnad.
- Kör installationsprogrammet på den centrala servern och ange uppspelningsbasens URL till en adress byggnaderna kan nå.
- Lägg till kanalflödena under Strömmar och meddelandena under Movies, och kontrollera dem i webbspelaren.
- Registrera en nod per byggnad via Servers; panelen installerar den via SSH, eller så registrerar noden sig med en engångskod, och dirigerar den byggnadens boende till sig.
- Lägg till fastighetsförvaltaren under Users → lägg till en återförsäljare, med en grupp som tillåter linjer och inga katalogändringar.
Organisation av innehållet
Utbud per sorts bostad.
- Skapa en bouquet per utbud av kanalerna för varje sorts bostad, och en bouquet för förvaltningens information.
- Lägg informationsbouqueten i varje paket så att varje boende får meddelandena.
- Skapa ett paket per sorts bostad med dess bouquets och en löptid som motsvarar hyresavtalet eller boendeperioden.
- Ordna kanalerna och ge dem logotyper så att menyn på TV:n läses bra.
Konfiguration av partner (återförsäljare)
Fastighetsförvaltaren som ett delegerat konto.
- Skapa en grupp med behörigheter begränsade till linjer, utan åtkomst till katalogen eller servrarna.
- Lägg till varje fastighetsförvaltare som återförsäljare med den gruppen, paketen för deras bostäder och ett kreditsaldo.
- En förvaltare av flera byggnader kan lägga till en underåterförsäljare per byggnad, var och en med egna bostäder och krediter.
Konfiguration av lägenheter (linjer)
En linje per lägenhet, namngiven efter dess nummer.
- Skapa en linje per lägenhet via Linjer → lägg till, med lägenhetsnumret som namn och paketet för den sortens bostad.
- Ställ in max antal anslutningar på antalet TV-apparater i bostaden.
- Använd en aktiveringskod i stället för ett lösenord när den boende ska ange en kort kod på enheten.
- Konfigurera enheten en gång (Xtream Codes API eller M3U med linjens inloggningsuppgifter, eller MAG- eller Enigma2-portalen); inloggningsuppgifterna stannar kvar vid lägenheten tills linjen får nya.
Välkomst- och meddelandevideor
Förvaltningens videor på begäran.
- Ladda upp välkomstvideon, ordningsreglerna och underhållsguiderna som filmer, med en kategori per ämne.
- Lägg dem i informationsbouqueten så att varje paket innehåller dem.
- Ersätt en video från panelen när informationen ändras; de boende ser den nya versionen direkt.
Kanaler och informationskanalen
Utbudet och meddelandekanalen som live-strömmar.
- Lägg till varje licensierad kanal under Strömmar med dess flöde, och en EPG-källa så att guiden på TV:n visar programmen.
- Lägg till informationskanalen som en live-ström, matad av en encoder via RTMP eller av en loopande källa, och placera den i informationsbouqueten.
- Ha kanaler med territoriella begränsningar i bouquets som bara rätt paket ger.
Inflyttning, utflyttning och förfallodatum
Boendet som linjens giltighet.
- En linje går ut vid slutet av sitt pakets period; förnya den med paketet eller en kredit för varje ny period av hyresavtalet.
- När en boende flyttar ut, inaktivera linjen; nästa boende aktiverar den igen med nya inloggningsuppgifter, så att ingenting blir kvar hos det gamla hushållet.
- Prenumerera bostadssystemet eller förvaltaren på webhooks för att se linjer som snart går ut eller redan har gått ut.
Integration med ett bostads- eller faktureringssystem
Systemen öppnar åtkomsten; spelaren spelar.
- Skapa en Reseller API-nyckel för bostads- eller faktureringssystemet; det anropar create_line, renew_line, enable_line och disable_line, och skickar ett request-id med varje skrivning.
- Använd en handelsconnector när boende köper extra paket online; alla andra system använder Reseller API och webhooks.
- Det finns ingen single sign-on för tittare: en boende loggar in i spelaren med linjens inloggningsuppgifter.
Säkerhetsaspekter
Behåll tjänsten inom området.
- Servera panelen bakom en reverse proxy med TLS och sätt TRUSTED_PROXIES så att granskningsloggen och IP-reglerna ser riktiga adresser.
- Tvåfaktorsinloggning för varje förvaltningskonto; fastighetsförvaltarna får en behörighetsgrupp begränsad till linjer.
- En anslutningsgräns per linje, signerade uppspelningslänkar som går ut och adressbindning där enheterna har fasta adresser.
- Aktivera den krypterade databassäkerhetskopian med en kopia utanför platsen; linernas inloggningsuppgifter finns i den.
Felsökning
De vanliga första kontrollerna.
- En lägenhet saknar TV: kontrollera att dess linje är aktiverad och inte har gått ut, sedan enhetens inloggningsuppgifter och uppspelningsadressen.
- En byggnad buffrar på kvällen: kontrollera byggnadens nods heartbeat och att dess boende dirigeras till den.
- En kanal saknas för en sorts bostad: kontrollera det paketets bouquets.
- En förvaltare kan inte skapa linjer: kontrollera återförsäljarens kreditsaldo, gruppbehörigheterna och de paket som är tilldelade den.