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 Ausstellungsraum oder Mitglied. 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 |
|---|---|---|
| Ausstellungsfilm und Archiv | VOD-Katalog: Filme und Serien mit Staffeln und Folgen, Kategorien und Metadaten | Movies und Series oder der VOD-Ingest-Job |
| Eröffnungs- oder Vortragsübertragung | Live-Kanal: ein Stream mit seinen Quellen, EPG und Ausgabeformaten | Streams → Live-Stream hinzufügen (Quell-URL oder RTMP-Push) |
| Sammlung der Ausstellungsräume oder der Mitglieder | Bouquet: eine benannte Gruppe von Kanälen, Filmen oder Serien, die ein Paket freigibt | Bouquets, aus Streams und Movies / Series |
| Zugang eines Besuchers oder Mitglieds | Line: ein Zugang mit Paket, Bouquets, Ablaufdatum, Verbindungslimit und Ausgaben | Lines → hinzufügen, oder Aktivierungscodes, oder die Reseller API |
| Mitgliedschaftszeitraum | Ablaufdatum der Line, verlängert durch ein Paket, einen Credit oder die API | Das Ablaufdatum der Line und die Laufzeit des Pakets |
| Geräte pro Mitglied | Max. Verbindungen der Line: wie viele Geräte gleichzeitig schauen dürfen | Die max. Verbindungen der Line |
Voraussetzungen
Was vor der Installation bereitstehen sollte.
- Ein Server im Gebäude (Ubuntu 22.04 oder 24.04), der Installer und das Netz der Ausstellungsräume, das die Bildschirme und die Geräte der Mitglieder nutzen werden.
- Der Ausstellungsfilm, die Archivaufnahmen, an denen Sie die Rechte halten, ein Encoder für den Vortragssaal und die Bildschirme oder Mediaplayer für die Ausstellungsräume.
- Der Lizenzschlüssel und, falls das Gebäude kein Internet hat, das Verfahren zur Offline-Aktivierung; und eine Entscheidung, wer an der Kasse Mitgliedschaften verkauft.
Infrastruktur bereitstellen
Der Server im Gebäude, vor Ort aktiviert.
- Führen Sie den Installer auf dem Server aus und setzen Sie die Wiedergabe-Basis-URL auf die Adresse, die das Netz der Ausstellungsräume erreicht.
- Aktivieren Sie den Lizenzschlüssel offline im Panel; nach der Aktivierung läuft der Dienst im lokalen Netz ohne Internet.
- Fügen Sie den Ausstellungsfilm unter Movies und den Feed des Vortragssaals unter Streams hinzu und prüfen Sie sie im Web-Player.
- Registrieren Sie für einen zweiten Standort oder ein großes öffentliches Programm unter Servers einen Node; das Panel installiert ihn per SSH und leitet die Zuschauer dieses Standorts zu ihm.
Inhalte organisieren
Ausstellungsräume, Archiv und Mitgliedersammlungen.
- Legen Sie Kategorien pro Ausstellung und pro Jahr an sowie eine Serie für einen Vortragszyklus mit einer Folge pro Vortrag.
- Legen Sie ein Bouquet für die Bildschirme in den Ausstellungsräumen an und eines für die Mitgliederbibliothek mit Vorträgen und Archivfilmen.
- Legen Sie ein Paket für die Ausstellungsräume und eines pro Mitgliedschaftsart an, jeweils mit ihren Bouquets; die Laufzeit des Mitgliedspakets ist der Mitgliedszeitraum.
- Fügen Sie jedem Film Poster und kurze Beschreibungen hinzu, damit sich die Bibliothek im Player gut liest.
Partner-Konfiguration (Reseller)
Kasse und Shop als delegierte Konten.
- Legen Sie eine Gruppe mit auf Lines und Aktivierungscodes beschränkten Berechtigungen an, ohne Zugriff auf den Katalog oder die Server.
- Fügen Sie die Kasse oder den Shop als Reseller mit dieser Gruppe, den Mitgliedspaketen und einem Credit-Guthaben hinzu.
- Ein Kulturzentrum mit mehreren Häusern kann pro Haus einen Reseller hinzufügen, der jeweils Mitgliedschaften aus seinem eigenen Guthaben verkauft.
Besucher- und Mitgliederzugang konfigurieren
Bildschirme und Mitglieder auf Lines.
- Legen Sie unter Lines → hinzufügen pro Bildschirm eines Ausstellungsraums eine Line mit dem Paket für die Ausstellungsräume an und binden Sie sie an die Adresse des Bildschirms, wenn das Netz feste Adressen vergibt.
- Erzeugen Sie an der Kasse für jede verkaufte Mitgliedschaft Aktivierungscodes; das Mitglied gibt den Code im Player ein, und die Line startet.
- Setzen Sie die maximalen Verbindungen pro Mitgliedschaft auf die Zahl der Geräte, die ein Mitglied nutzen darf, typischerweise zwei.
- Geben Sie dem Mitglied die Player-App, eine M3U-Playlist oder die Adresse des Web-Players, je nachdem, was zu seinem Gerät passt.
Ausstellungsfilm und Archiv
Die Bibliothek auf Abruf.
- Laden Sie den Ausstellungsfilm und das digitalisierte Archiv als Filme hoch oder übernehmen Sie sie mit dem VOD-Ingest-Job in das Medienverzeichnis.
- Fügen Sie TMDB-Metadaten hinzu, wo sie existieren, und schreiben Sie Titel und Beschreibung für den Rest selbst.
- Halten Sie das Archiv, das nicht für die Öffentlichkeit bestimmt ist, nur im Mitglieder-Bouquet und prüfen Sie mit einer Test-Line, was jedes Paket sieht.
Eröffnungen und Vorträge
Eine Veranstaltung als Live-Kanal.
- Fügen Sie einen Live-Stream für den Encoder des Vortragssaals hinzu (RTMP-Push) und legen Sie ihn in das Mitglieder-Bouquet oder, für eine auf den Bildschirmen gezeigte Eröffnung, in das Bouquet der Ausstellungsräume.
- Aktivieren Sie Catch-up, damit ein Mitglied, das später kommt, zurückspulen kann, und laden Sie die Aufzeichnung danach in die Bibliothek hoch.
- Testen Sie den Encoder und den Stream vor der Veranstaltung mit einer Test-Line, im selben Netz, das das Publikum nutzen wird.
Ablauf und Verlängerung der Mitgliedschaft
Die Mitgliedschaft als Gültigkeit der Line.
- Eine Line läuft am Ende des Zeitraums ihres Pakets ab; eine Verlängerung an der Kasse fügt einen weiteren Zeitraum hinzu.
- Deaktivieren Sie eine Line, wenn eine Mitgliedschaft gekündigt wird; nie verwendete Aktivierungscodes bleiben unbenutzt, bis sie eingelöst werden.
- Abonnieren Sie die Webhooks für den Shop oder das Mitgliedschaftssystem, um Lines zu sehen, die bald ablaufen oder bereits abgelaufen sind.
Anbindung an den Shop oder das Mitgliedschaftssystem
Systeme verkaufen den Zugang; der Player spielt ab.
- Erstellen Sie einen Reseller-API-Schlüssel für den Shop oder das Mitgliedschaftssystem; es ruft create_line, renew_line und disable_line auf, mit einer Request-ID bei jedem Schreibzugriff.
- Nutzen Sie einen Commerce-Konnektor, wenn Mitgliedschaften online verkauft werden; jedes andere System nutzt die Reseller API und Webhooks.
- Es gibt kein Single Sign-on für Zuschauer: Ein Mitglied meldet sich im Player mit den Zugangsdaten der Line oder dem Aktivierungscode an.
Sicherheitsaspekte
Die Sammlungen dort halten, wo sie hingehören.
- Halten Sie das Netz der Ausstellungsräume getrennt vom Besuchernetz und betreiben Sie jeden öffentlichen Zugang hinter einem Reverse Proxy mit TLS und gesetztem TRUSTED_PROXIES.
- Zwei-Faktor-Anmeldung für jedes Panel-Konto; die Kasse erhält eine Berechtigungsgruppe, die auf Lines und Codes beschränkt ist.
- Signierte und ablaufende Wiedergabelinks, ein Verbindungslimit pro Mitgliedschaft und Adressbindung für die Bildschirme in den Ausstellungsräumen.
- Aktivieren Sie das verschlüsselte Datenbank-Backup mit einer Off-Site-Kopie und nutzen Sie das Audit-Log, um Änderungen an Lines und Katalog zu prüfen.
Fehlersuche
Die üblichen ersten Prüfungen.
- Ein Bildschirm in einem Ausstellungsraum ist schwarz: Prüfen Sie, ob seine Line aktiviert und nicht abgelaufen ist, die Adressbindung des Bildschirms und ob der Server im Netz der Ausstellungsräume erreichbar ist.
- Der Code eines Mitglieds funktioniert nicht: Prüfen Sie, ob der Code nicht schon eingelöst wurde und ob das Paket, das er öffnet, der Kasse noch zugewiesen ist.
- Die Lizenzaktivierung schlägt offline fehl: Prüfen Sie die Aktivierungsdatei anhand des Lizenzschlüssels und der Uhr des Servers.
- Die Live-Eröffnung ruckelt: Prüfen Sie die Bitrate des Encoders gegen den Uplink und den Status des Streams unter Streams.