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 Zimmer oder Aufenthalt. Die Tabelle sagt, welches Objekt welche Rolle spielt; die folgenden Kapitel richten sie in dieser Reihenfolge ein.
| In Ihrer Branche | Auf der Plattform | Wo im Panel |
|---|---|---|
| Hotelbetreiber oder autorisierter Partner | Partnerkonto (Reseller): ein delegiertes Dashboard mit Credits, Berechtigungen und eigenen Lines | Users → Reseller hinzufügen; Groups für seine Berechtigungen |
| Kanalpaket | Bouquet: eine benannte Gruppe von Kanälen, Filmen oder Serien, die ein Paket freigibt | Bouquets, aus Streams und Movies / Series |
| Zimmer oder Gerät | Line: ein Zugang mit Paket, Bouquets, Ablaufdatum, Verbindungslimit und Ausgaben | Lines → hinzufügen, oder Aktivierungscodes, oder die Reseller API |
| Informationsvideos des Hotels | VOD-Katalog: Filme und Serien mit Staffeln und Folgen, Kategorien und Metadaten | Movies und Series oder der VOD-Ingest-Job |
| Lizenzierte Fernsehkanäle | Live-Kanal: ein Stream mit seinen Quellen, EPG und Ausgabeformaten | Streams → Live-Stream hinzufügen (Quell-URL oder RTMP-Push) |
| Aufenthaltsdauer | Ablaufdatum der Line, verlängert durch ein Paket, einen Credit oder die API | Das Ablaufdatum der Line und die Laufzeit des Pakets |
| Ein Node pro Gebäude oder Flügel | 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 im Netz des Hauses (Ubuntu 22.04 oder 24.04), der Installer und eine Adresse, die die Zimmergeräte erreichen können.
- Die Kanal-Feeds, an denen das Haus Rechte hält (Pull-URLs oder RTMP), die Informationsvideos des Hotels und die Zimmergeräte (Android-TV-Boxen, MAG- oder Enigma2-Boxen, Smart-TVs mit Player-App oder Browser).
- Die Fähigkeit des PMS, bei Check-in und Check-out eine HTTP-API aufzurufen, oder ein Verfahren an der Rezeption, das im Panel zu erledigen.
Infrastruktur bereitstellen
Der zentrale Server und ein Node pro Gebäude.
- Führen Sie den Installer auf dem zentralen Server aus; setzen Sie die Wiedergabebasis auf die interne Adresse des Hauses, damit die Zimmer im lokalen Netz bleiben.
- Fügen Sie die Kanal-Feeds unter Streams und die Informationsvideos unter Movies hinzu; prüfen Sie sie im Web-Player.
- Registrieren Sie unter Servers einen Node pro Flügel oder Gebäude; das Panel installiert ihn per SSH und leitet die Zimmer dieses Gebäudes auf ihn.
- Setzen Sie den Lizenzschlüssel auf dem Server; die Aktivierung erfolgt vor Ort, und der Dienst läuft ohne den Uplink.
Inhalte organisieren
Kanalpakete und Hotelvideos.
- Legen Sie aus den Kanälen des Hauses ein Bouquet pro Kanalpaket an (Standardzimmer, Suiten, Konferenz).
- Legen Sie ein Bouquet mit Hotelvideos an (Begrüßung, Einrichtungen, Sicherheit) und fügen Sie es jedem Paket hinzu.
- Legen Sie pro Zimmerkategorie ein Paket mit den freigegebenen Bouquets und einer Laufzeit von einem Tag an: Beim Check-in wird die Line des Zimmers einmal pro Übernachtung verlängert (jede Verlängerung addiert die Laufzeit des Pakets), beim Check-out wird sie deaktiviert (Kapitel 8).
- Ordnen Sie die Kanäle und geben Sie ihnen Logos, damit das Menü auf dem Fernseher gut lesbar ist.
Partner-Konfiguration (Reseller)
Das Haus oder ein Betreiber mehrerer Häuser als delegiertes Konto.
- Legen Sie eine Gruppe mit Berechtigungen an, die auf Lines (Zimmer) beschränkt sind und keine Katalogänderungen erlauben.
- Fügen Sie die Rezeption des Hauses oder den Betreiber als Reseller mit dieser Gruppe und den Zimmerpaketen hinzu.
- Ein Betreiber mehrerer Häuser erhält einen Reseller pro Haus, jeder mit eigenen Zimmern und Credits.
Zimmer-Konfiguration (Line)
Eine Line pro Zimmer, benannt nach seiner Nummer.
- Legen Sie unter Lines eine Line pro Zimmer an, mit der Zimmernummer als Namen und dem Paket der Zimmerkategorie.
- Setzen Sie die max. Verbindungen auf 1 (ein Fernseher) oder auf die Zahl der Bildschirme im Zimmer.
- Binden Sie die Line an die Adresse des Zimmergeräts, wenn das Netz den Geräten feste Adressen gibt.
- Konfigurieren Sie das Gerät einmalig (Xtream Codes API oder M3U mit den Zugangsdaten der Line, oder das MAG- / Enigma2-Portal); die Zugangsdaten bleiben beim Zimmer.
Informationsvideos des Hotels
Die eigenen Videos des Hauses auf Abruf.
- Laden Sie die Begrüßungs- und Informationsvideos als Filme hoch, mit den Sprachversionen des Hauses als eigenen Einträgen oder Tonspuren.
- Legen Sie sie in das Bouquet der Hotelvideos, damit jede Zimmerkategorie sie erhält.
- Aktualisieren Sie sie im Panel, wann immer sich die Informationen ändern; die Zimmer sehen die neue Version sofort.
Lizenzierte Fernsehkanäle
Die Kanäle des Hauses als Live-Streams.
- Fügen Sie jeden lizenzierten Kanal unter Streams mit seinem Feed hinzu; aktivieren Sie Timeshift oder Catch-up nur, wo die Lizenz es erlaubt.
- Fügen Sie eine EPG-Quelle hinzu, damit der Programmführer auf dem Fernseher die Sendungen zeigt.
- Halten Sie gebietsbeschränkte Kanäle in Bouquets, die nur die richtigen Pakete freigeben.
Check-in, Check-out und Ablauf
Der Aufenthalt als Gültigkeit der Line.
- Aktivieren Sie beim Check-in die Line des Zimmers und verlängern Sie sie um die Dauer des Aufenthalts (das PMS über die API oder die Rezeption im Panel).
- Deaktivieren Sie die Line beim Check-out; ein neuer Aufenthalt aktiviert sie wieder, sodass die Zugangsdaten das Zimmer nie verlassen.
- Abonnieren Sie die Webhooks mit dem PMS oder der Rezeption, um aktivierte, deaktivierte und abgelaufene Lines zu sehen.
Integration mit dem PMS
Check-in und Check-out steuern die Zimmer.
- Legen Sie einen Reseller-API-Schlüssel für das PMS an und bewahren Sie ihn in der Konfiguration des PMS auf.
- Beim Check-in ruft das PMS action=enable_line und action=renew_line für die Line des Zimmers mit einer Request-ID auf; beim Check-out action=disable_line.
- Die Gästeservice-Anwendung (Personal rufen, Housekeeping, Express-Check-out, Zimmerservice) und ihre Back-Office-Anbindung sind Teil des Enterprise-Tarifs und werden gemeinsam mit dem Haus abgegrenzt.
Sicherheitsaspekte
Halten Sie die Kanäle im Haus.
- Halten Sie Wiedergabebasis und Nodes im Netz des Hauses; legen Sie nichts im Internet offen, was die Zimmer nicht brauchen.
- Eine Verbindung pro Zimmer, an das Gerät gebunden; signierte Links laufen ab, sodass ein kopierter Link nicht mehr funktioniert.
- Zwei-Faktor-Anmeldung für das Panel; die Rezeption erhält eine Berechtigungsgruppe mit eingeschränkten Rechten.
- Aktivieren Sie das verschlüsselte Datenbank-Backup; die Zimmer-Zugangsdaten liegen darin.
Fehlersuche
Die üblichen ersten Prüfungen.
- Ein Zimmer hat kein Fernsehen: Prüfen Sie, ob seine Line aktiviert und nicht abgelaufen ist, dann die Zugangsdaten und die Adresse des Geräts.
- Ein Kanal fehlt in einem Zimmer: Prüfen Sie das Bouquet des Pakets der Zimmerkategorie.
- Das Fernsehen bricht bei einem Internetausfall ab: Prüfen Sie, ob Wiedergabebasis und Quellen interne Adressen sind; externe Feeds hängen vom Uplink ab.
- Der Aufruf des PMS schlägt fehl: Prüfen Sie den API-Schlüssel, dass Schreiboperationen POST sind, und die Request-ID bei Wiederholungen.