Diese Anleitungen bilden die Begriffe einer Branche auf die Objekte ab, die die Plattform heute hat (Bouquets, Lines, Pakete, Partnerkonten, Nodes, die API). Es sind konzeptionelle Zuordnungen, keine branchenspezifischen Funktionen, und ein Partnerkonto ist ein delegiertes Konto, kein isolierter Mandant.
Konzeptionelle Zuordnung
Nichts im Panel heißt Sendung oder Unterstützer. Die Tabelle zeigt, welches Objekt welche Rolle übernimmt; die folgenden Kapitel richten sie in dieser Reihenfolge ein.
| In Ihrer Branche | Auf der Plattform | Wo im Panel |
|---|---|---|
| Der Kanal des Studios | Live-Kanal: ein Stream mit seinen Quellen, EPG und Ausgabeformaten | Streams → Live-Stream hinzufügen (Quell-URL oder RTMP-Push) |
| Sendungsbibliothek | VOD-Katalog: Filme und Serien mit Staffeln und Folgen, Kategorien und Metadaten | Movies und Series oder der VOD-Ingest-Job |
| Abo-Stufe | Bouquet: eine benannte Gruppe von Kanälen, Filmen oder Serien, die ein Paket freigibt | Bouquets, aus Streams und Movies / Series |
| Zugang des Unterstützers | Line: ein Zugang mit Paket, Bouquets, Ablaufdatum, Verbindungslimit und Ausgaben | Lines → hinzufügen, oder Aktivierungscodes, oder die Reseller API |
| Abrechnungszeitraum | Ablaufdatum der Line, verlängert durch ein Paket, einen Credit oder die API | Das Ablaufdatum der Line und die Laufzeit des Pakets |
| Konto eines Affiliates oder Distributors | Partnerkonto (Reseller): ein delegiertes Dashboard mit Credits, Berechtigungen und eigenen Lines | Users → Reseller hinzufügen; Groups für seine Berechtigungen |
| Shop- oder Mitgliedschaftsintegration | Reseller API und Webhooks: die Operationen des Panels aus Ihrem eigenen System | Reseller-API-Schlüssel und Webhooks im Dashboard des Resellers |
Voraussetzungen
Was vor der Installation bereitstehen sollte.
- Ein Server (Ubuntu 22.04 oder 24.04) mit öffentlicher Adresse oder Domain und genug Upstream-Bandbreite für das erwartete Publikum.
- Die fertigen Folgen, das Playout oder der Encoder des Studios für den Kanal und ein Shop auf einer Plattform mit Konnektor oder die Möglichkeit, eine HTTP-API aufzurufen.
- Eine Entscheidung zu Stufen und Affiliates: was jedes Abonnement zuweist und wer es verkaufen darf.
Infrastruktur bereitstellen
Zuerst ein Server, Nodes, wenn das Publikum wächst.
- Führen Sie den Installer auf dem Verwaltungsserver aus und stellen Sie das Panel hinter einen Reverse Proxy mit TLS; setzen Sie die vertrauenswürdigen Proxys, damit IP-Regeln die echte Adresse des Zuschauers sehen.
- Setzen Sie die Wiedergabe-Basis-URL auf die öffentliche Adresse, die Ihr Publikum erreicht.
- Registrieren Sie unter Servers einen Node in einer Region, in der viele Unterstützer zuschauen; das Panel installiert ihn per SSH und leitet die Zuschauer dieser Region zu ihm.
- Legen Sie für jede Person im Team, die den Katalog oder die Unterstützer betreut, ein Partnerkonto (Reseller) mit eigener Berechtigungsgruppe an.
Inhalte organisieren
Sendungen als Serien, Stufen als Bouquets.
- Legen Sie Kategorien pro Genre an und eine Serie pro Sendung, mit einer Staffel pro Veröffentlichungsblock und einer Folge pro Video.
- Legen Sie ein Bouquet für den Live-Kanal an, eines für kostenlose oder Einstiegsinhalte und eines für jede höhere Stufe.
- Legen Sie ein Paket pro Stufe an, mit dem Abrechnungszeitraum als Laufzeit, auf Wunsch ein Testpaket für neue Besucher und einen Preis in Credits für die Affiliates.
- Halten Sie das Archiv in einer eigenen Kategorie, damit es zwischen Stufen verschoben werden kann, ohne die Serien anzufassen.
Partner-Konfiguration (Reseller)
Affiliates und Distributoren.
- Legen Sie eine Gruppe für Affiliates nur mit Line-Berechtigungen an, damit sie den Katalog nicht ändern können.
- Fügen Sie jeden Affiliate als Reseller mit dieser Gruppe und einem Credit-Guthaben hinzu; der Preis seines Pakets ist, was das Studio entscheidet.
- Ein Distributor mit Sub-Affiliates kann unter seinem eigenen Konto Sub-Reseller anlegen, bis zu fünf Ebenen tief.
Zugang der Unterstützer konfigurieren
Eine Line pro Unterstützer.
- Installieren Sie den Konnektor Ihres Shops (zum Beispiel WooCommerce) und tragen Sie den Reseller-API-Schlüssel und das zu jedem Produkt passende Paket ein.
- Beim Abonnement ruft der Konnektor create_line mit dem Paket und einer Request-ID auf; der Abrechnungszeitraum ist die Laufzeit des Pakets.
- Setzen Sie die maximalen Verbindungen auf die Zahl der Geräte, die ein Unterstützer nutzen darf, üblicherweise zwei oder drei.
- Für eine Verlosung oder einen Launch erzeugen Sie Aktivierungscodes in großer Zahl oder fügen unter Lines → hinzufügen Lines mit einem Testpaket hinzu.
Sendungsbibliothek
Folgen auf Abruf.
- Laden Sie jede Folge als Quelle hoch oder übernehmen Sie sie mit dem VOD-Ingest-Job; füllen Sie Titel, Staffel, Folgennummer und die TMDB-Metadaten aus, falls die Sendung welche hat.
- Ordnen Sie jede Serie den Bouquets der Stufen zu, die sie sehen dürfen.
- Prüfen Sie die Wiedergabe mit einer Test-Line jeder Stufe, bevor Sie eine Veröffentlichung ankündigen.
Der Kanal des Studios
Ein Kanal rund um die Uhr.
- Fügen Sie einen Live-Stream für das Playout des Studios hinzu (RTMP-Push) und legen Sie ihn in die Bouquets jeder Stufe, die den Kanal enthält.
- Laden Sie den Programmführer des Kanals als XMLTV, damit Unterstützer sehen, was läuft, und aktivieren Sie Catch-up für Sendungen, die sich zum Wiedersehen lohnen.
- Halten Sie das Playout zwischen den Veröffentlichungen mit dem eigenen geplanten Inhalt des Studios am Laufen; das Panel leitet den Stream nur weiter.
Ablauf des Abonnements
Der Zugang folgt der Zahlung.
- Eine Line läuft am Ende des Zeitraums ihres Pakets ab; der Shop verlängert sie mit renew_line, wenn die nächste Zahlung eingeht.
- Abonnieren Sie die Webhooks für den Shop, um bei line.expiring eine Erinnerung zu senden und bei line.expired einen Unterstützer herunterzustufen.
- Ein Unterstützer, der kündigt, wird vom Shop mit disable_line deaktiviert, und die Line kann später ohne neues Konto verlängert werden.
Anbindung an den Shop
Der Shop verkauft; der Player spielt ab.
- Der Konnektor legt Lines im Gleichschritt mit den Bestellungen an, verlängert und deaktiviert sie; jeder andere Shop nutzt die Reseller API und Webhooks.
- Affiliates sehen ihre eigenen Lines in ihrem Dashboard, und die Reseller API lässt sie das automatisieren.
- Es gibt kein Single Sign-on für Zuschauer: Unterstützer melden sich im Player mit den Zugangsdaten ihrer Line an, die der Shop ihnen sendet.
Sicherheitsaspekte
Schützen Sie das Abonnement, nicht nur den Server.
- Betreiben Sie das Panel und die Wiedergabe-Basis-URL über TLS und setzen Sie TRUSTED_PROXIES auf Ihren Reverse Proxy.
- Zwei-Faktor-Anmeldung für jedes Panel-Konto und Berechtigungsgruppen, damit Affiliates den Katalog nicht ändern können.
- Signierte und ablaufende Wiedergabelinks und ein Verbindungslimit pro Line; binden Sie eine Line an ein Land, wenn eine Lizenz gebietsbezogen ist.
- Verschlüsselte Datenbank-Backups mit einer Off-Site-Kopie und das Audit-Log für jede Änderung an Lines und Katalog.
Fehlersuche
Die üblichen ersten Prüfungen.
- Ein neuer Unterstützer kann nach der Zahlung nicht zuschauen: Prüfen Sie den Aufruf des Shop-Konnektors im Reseller-API-Log und das Ablaufdatum der Line.
- Ein Unterstützer sieht Inhalte einer höheren Stufe: Prüfen Sie das Paket der Line und die Bouquets, die es zuweist.
- Der Kanal bricht am Ende eines Playout-Zyklus ab: Prüfen Sie den Push des Encoders an den Live-Stream und den Probe-Status des Streams.
- Der Verkauf eines Affiliates erscheint nicht: Prüfen Sie seine Credits und ob das verwendete Paket zu seiner Gruppe gehört.