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 program eller supporter. 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 |
|---|---|---|
| Studions kanal | 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) |
| Programbibliotek | VOD-katalog: filmer och serier med säsonger och avsnitt, kategorier och metadata | Movies och Series, eller VOD-ingest-jobbet |
| Prenumerationsnivå | Bouquet: en namngiven uppsättning kanaler, filmer eller serier som ett paket ger tillgång till | Bouquets, från Strömmar och Movies / Series |
| Supporterns åtkomst | Linje: en åtkomst med sitt paket, sina bouquets, förfallodatum, anslutningsgräns och utdata | Linjer → lägg till, eller aktiveringskoder, eller Reseller API |
| Faktureringsperiod | Linjens förfallodatum, som förnyas av ett paket, en kredit eller API:et | Linjens förfallodatum och paketets varaktighet |
| Konto för affiliate eller distributör | 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 |
| Integration med butik eller medlemskap | 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 server (Ubuntu 22.04 eller 24.04) med en publik adress eller en domän, och tillräcklig uppströmsbandbredd för den publik du räknar med.
- De färdiga avsnitten, studions playout eller encoder för kanalen, och en butik på en plattform med en connector, eller möjligheten att anropa ett HTTP-API.
- Ett beslut om nivåer och affiliates: vad varje prenumeration ger och vem som får sälja den.
Driftsättning av infrastrukturen
Först en server, noder när publiken växer.
- Kör installationsprogrammet på hanteringsservern och lägg panelen bakom en reverse proxy med TLS; ange de betrodda proxyerna så att IP-regler ser tittarens riktiga adress.
- Ange uppspelningsbasens URL till den publika adress din publik når.
- Registrera en nod via Servers i en region där många supportrar tittar; panelen installerar den via SSH och dirigerar den regionens tittare till den.
- Skapa ett partnerkonto (reseller) för varje medarbetare som sköter katalogen eller supportrarna, med en egen behörighetsgrupp.
Organisation av innehållet
Program som serier, nivåer som bouquets.
- Skapa kategorier per genre, och en serie per program med en säsong per utgivningsomgång och ett avsnitt per video.
- Skapa en bouquet för livekanalen, en för det kostnadsfria eller inledande innehållet och en för varje högre nivå.
- Skapa ett paket per nivå med faktureringsperioden som löptid, ett testpaket för nya besökare om du vill ha ett, och ett pris i krediter för affiliates.
- Ha bakkatalogen i en egen kategori så att den kan flyttas mellan nivåer utan att serierna rörs.
Konfiguration av partner (återförsäljare)
Affiliates och distributörer.
- Skapa en grupp för affiliates med enbart linjebehörigheter, så att de inte kan ändra katalogen.
- Lägg till varje affiliate som återförsäljare med den gruppen och ett kreditsaldo; dess paketpris bestämmer studion.
- En distributör med underaffiliates får skapa underåterförsäljare under sitt eget konto, upp till fem nivåer djupt.
Konfiguration av supporteråtkomst
En linje per supporter.
- Installera connectorn för din butik (till exempel WooCommerce) och ange Reseller API-nyckeln och det paket som motsvarar varje produkt.
- Vid en prenumeration anropar connectorn create_line med paketet och ett request-id; faktureringsperioden är paketets löptid.
- Ställ in max antal anslutningar på det antal enheter en supporter får använda, vanligtvis två eller tre.
- För en gratisutdelning eller en lansering, generera aktiveringskoder i bulk eller lägg till linjer via Linjer → lägg till med ett testpaket.
Programbibliotek
Avsnitt på begäran.
- Ladda upp varje avsnitt som en källa, eller importera det med VOD-ingestjobbet; fyll i titel, säsong, avsnittsnummer och TMDB-metadata om programmet har någon.
- Koppla varje serie till bouqueten för de nivåer som får titta på den.
- Kontrollera uppspelningen med en testlinje för varje nivå innan du tillkännager en utgåva.
Studions kanal
En kanal dygnet runt.
- Lägg till en live-ström för studions playout (RTMP-push) och placera den i bouqueten för varje nivå som innehåller kanalen.
- Läs in kanalens guide som XMLTV så att supportrar ser vad som sänds, och aktivera catch-up för de program som är värda att se igen.
- Håll playout igång mellan utgåvorna med studions eget schemalagda innehåll; panelen vidarebefordrar bara strömmen.
Prenumerationens förfallodatum
Åtkomsten följer betalningen.
- En linje går ut vid slutet av sitt pakets period; butiken förnyar den med renew_line när nästa betalning kommer in.
- Prenumerera butiken på webhooks för att skicka en påminnelse vid line.expiring och sänka en supporter vid line.expired.
- En supporter som säger upp inaktiveras av butiken med disable_line, och linjen kan förnyas senare utan ett nytt konto.
Integration med butiken
Butiken säljer; spelaren spelar.
- Connectorn skapar, förnyar och inaktiverar linjer i takt med beställningarna; alla andra butiker använder Reseller API och webhooks.
- Affiliates ser sina egna linjer i sin panel, och Reseller API låter dem automatisera det.
- Det finns ingen single sign-on för tittare: supportrar loggar in i spelaren med inloggningsuppgifterna för sin linje, som butiken skickar dem.
Säkerhetsaspekter
Skydda prenumerationen, inte bara servern.
- Servera panelen och uppspelningsbasens URL över TLS och sätt TRUSTED_PROXIES till din reverse proxy.
- Tvåfaktorsinloggning för varje panelkonto, och behörighetsgrupper så att affiliates inte kan ändra katalogen.
- Signerade uppspelningslänkar som går ut och en anslutningsgräns per linje; bind en linje till ett land om en licens är territoriell.
- Krypterade databassäkerhetskopior med en kopia utanför platsen, och granskningsloggen för varje ändring av linjer och katalog.
Felsökning
De vanliga första kontrollerna.
- En ny supporter kan inte titta efter betalning: kontrollera butiksconnectorns anrop i Reseller API-loggen och linjens förfallodatum.
- En supporter ser innehåll från en högre nivå: kontrollera linjens paket och de bouquets det ger.
- Kanalen stannar i slutet av en playout-cykel: kontrollera encoderns push till live streamen och strömmens probe-status.
- En affiliates försäljning syns inte: kontrollera dess krediter och att paketet den använde tillhör dess grupp.