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 Wohnung oder Bewohner. 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 |
|---|---|---|
| Konto des Hausverwalters | Partnerkonto (Reseller): ein delegiertes Dashboard mit Credits, Berechtigungen und eigenen Lines | Users → Reseller hinzufügen; Groups für seine Berechtigungen |
| Senderliste | Bouquet: eine benannte Gruppe von Kanälen, Filmen oder Serien, die ein Paket freigibt | Bouquets, aus Streams und Movies / Series |
| Kanal oder Informationskanal | Live-Kanal: ein Stream mit seinen Quellen, EPG und Ausgabeformaten | Streams → Live-Stream hinzufügen (Quell-URL oder RTMP-Push) |
| Willkommens- und Mitteilungsvideos | VOD-Katalog: Filme und Serien mit Staffeln und Folgen, Kategorien und Metadaten | Movies und Series oder der VOD-Ingest-Job |
| Zugang einer Wohnung | Line: ein Zugang mit Paket, Bouquets, Ablaufdatum, Verbindungslimit und Ausgaben | Lines → hinzufügen, oder Aktivierungscodes, oder die Reseller API |
| Miet- oder Belegungszeitraum | Ablaufdatum der Line, verlängert durch ein Paket, einen Credit oder die API | Das Ablaufdatum der Line und die Laufzeit des Pakets |
| Node eines Gebäudes | Streaming-Nodes: aus dem Panel registrierte Edge-Server, einer pro Standort oder Gebäude | Servers → Node hinzufügen, per SSH installiert |
Voraussetzungen
Was vor der Installation bereitstehen sollte.
- Ein Server für die Hausverwaltung (Ubuntu 22.04 oder 24.04), der Installer und ein Server pro Gebäude, der das Netz der Bewohner erreichen kann.
- Die Senderfeeds, die die Gemeinschaft weiterübertragen darf (Pull-URLs oder RTMP), die Mitteilungen und Willkommensvideos der Hausverwaltung und die Geräte der Bewohner (Set-Top-Boxen, Smart-TVs mit Player-App oder ein Browser).
- Eine Entscheidung zu den Haushaltsarten (Standard, Senioren, Studierende) und dazu, wer in der Hausverwaltung die Lines öffnet und verlängert.
Infrastruktur bereitstellen
Der zentrale Server, dann ein Node pro Gebäude.
- Führen Sie den Installer auf dem zentralen Server aus und setzen Sie die Wiedergabe-Basis-URL auf eine Adresse, die die Gebäude erreichen können.
- Fügen Sie die Senderfeeds unter Streams und die Mitteilungen unter Movies hinzu und prüfen Sie sie im Web-Player.
- Registrieren Sie unter Servers einen Node pro Gebäude; das Panel installiert ihn per SSH, oder der Node registriert sich mit einem Einmalcode, und leitet die Bewohner dieses Gebäudes zu ihm.
- Fügen Sie den Hausverwalter unter Users → Reseller hinzufügen hinzu, mit einer Gruppe, die Lines erlaubt und keine Katalogänderungen.
Inhalte organisieren
Senderlisten pro Haushaltsart.
- Legen Sie pro Senderliste ein Bouquet aus den Kanälen jeder Haushaltsart an und ein Bouquet für die Informationen der Hausverwaltung.
- Fügen Sie das Informations-Bouquet jedem Paket hinzu, damit jeder Bewohner die Mitteilungen erhält.
- Legen Sie ein Paket pro Haushaltsart an, mit seinen Bouquets und einer Laufzeit, die zum Mietvertrag oder zum Belegungszeitraum passt.
- Ordnen Sie die Kanäle und geben Sie ihnen Logos, damit sich das Menü auf dem Fernseher gut liest.
Partner-Konfiguration (Reseller)
Der Hausverwalter als delegiertes Konto.
- Legen Sie eine Gruppe mit auf Lines beschränkten Berechtigungen an, ohne Zugriff auf den Katalog oder die Server.
- Fügen Sie jeden Hausverwalter als Reseller mit dieser Gruppe, den Paketen seiner Wohnungen und einem Credit-Guthaben hinzu.
- Ein Verwalter mehrerer Gebäude kann pro Gebäude einen Sub-Reseller hinzufügen, jeweils mit eigenen Wohnungen und Credits.
Wohnung (Line) konfigurieren
Eine Line pro Wohnung, benannt nach ihrer Nummer.
- Legen Sie unter Lines → hinzufügen pro Wohnung eine Line an, mit der Wohnungsnummer als Namen und dem Paket dieser Haushaltsart.
- Setzen Sie die maximalen Verbindungen auf die Zahl der Fernseher im Haushalt.
- Nutzen Sie einen Aktivierungscode statt eines Passworts, wenn der Bewohner am Gerät einen kurzen Code eingeben soll.
- Konfigurieren Sie das Gerät einmal (Xtream Codes API oder M3U mit den Zugangsdaten der Line, oder das MAG- oder Enigma2-Portal); die Zugangsdaten bleiben bei der Wohnung, bis die Line neue erhält.
Willkommens- und Mitteilungsvideos
Die Videos der Hausverwaltung auf Abruf.
- Laden Sie das Willkommensvideo, die Hausordnung und die Wartungsanleitungen als Filme hoch, mit einer Kategorie pro Thema.
- Legen Sie sie in das Informations-Bouquet, damit jedes Paket sie enthält.
- Ersetzen Sie ein Video im Panel, wenn sich die Information ändert; die Bewohner sehen die neue Version sofort.
Kanäle und der Informationskanal
Die Senderliste und der Mitteilungskanal als Live-Streams.
- Fügen Sie jeden lizenzierten Kanal unter Streams mit seinem Feed hinzu, dazu eine EPG-Quelle, damit der Programmführer auf dem Fernseher die Sendungen zeigt.
- Fügen Sie den Informationskanal als Live-Stream hinzu, gespeist von einem Encoder über RTMP oder von einer Schleifenquelle, und legen Sie ihn in das Informations-Bouquet.
- Halten Sie Kanäle mit Gebietsbeschränkungen in Bouquets, die nur die richtigen Pakete zuweisen.
Einzug, Auszug und Ablauf
Die Belegung als Gültigkeit der Line.
- Eine Line läuft am Ende des Zeitraums ihres Pakets ab; verlängern Sie sie mit dem Paket oder einem Credit für jeden neuen Zeitraum des Mietvertrags.
- Wenn ein Bewohner auszieht, deaktivieren Sie die Line; der nächste Bewohner aktiviert sie mit neuen Zugangsdaten wieder, sodass nichts beim alten Haushalt bleibt.
- Abonnieren Sie die Webhooks für das Wohnungssystem oder den Verwalter, um Lines zu sehen, die bald ablaufen oder bereits abgelaufen sind.
Anbindung an ein Wohnungs- oder Abrechnungssystem
Systeme öffnen den Zugang; der Player spielt ab.
- Erstellen Sie einen Reseller-API-Schlüssel für das Wohnungs- oder Abrechnungssystem; es ruft create_line, renew_line, enable_line und disable_line auf und sendet bei jedem Schreibzugriff eine Request-ID.
- Nutzen Sie einen Commerce-Konnektor, wenn Bewohner zusätzliche Pakete online kaufen; jedes andere System nutzt die Reseller API und Webhooks.
- Es gibt kein Single Sign-on für Zuschauer: Ein Bewohner meldet sich im Player mit den Zugangsdaten der Line an.
Sicherheitsaspekte
Den Dienst innerhalb der Gemeinschaft halten.
- Betreiben Sie das Panel hinter einem Reverse Proxy mit TLS und setzen Sie TRUSTED_PROXIES, damit das Audit-Log und die IP-Regeln echte Adressen sehen.
- Zwei-Faktor-Anmeldung für jedes Verwaltungskonto; die Hausverwalter erhalten eine auf Lines beschränkte Berechtigungsgruppe.
- Ein Verbindungslimit pro Line, signierte und ablaufende Wiedergabelinks und Adressbindung, wo die Geräte feste Adressen haben.
- Aktivieren Sie das verschlüsselte Datenbank-Backup mit einer Off-Site-Kopie; die Zugangsdaten der Lines liegen darin.
Fehlersuche
Die üblichen ersten Prüfungen.
- Eine Wohnung hat kein Fernsehen: Prüfen Sie, ob ihre Line aktiviert und nicht abgelaufen ist, dann die Zugangsdaten des Geräts und die Wiedergabeadresse.
- Ein Gebäude puffert am Abend: Prüfen Sie den Heartbeat des Gebäude-Nodes und ob seine Bewohner zu ihm geleitet werden.
- Ein Kanal fehlt für eine Haushaltsart: Prüfen Sie die Bouquets dieses Pakets.
- Ein Verwalter kann keine Lines anlegen: Prüfen Sie das Credit-Guthaben des Resellers, die Berechtigungen seiner Gruppe und die ihm zugewiesenen Pakete.