Multiview
Mit Multiview überwachen Sie RTSP-, SRT-, RTMP- oder NDI-Eingänge gemeinsam in einem browserbasierten Multiviewer. Fügen Sie die RTSP-URL einer Kamera oder eines Medienservers direkt hinzu; nur für die Anzeige auf der Wand ist keine SRT- oder RTMP-Konvertierung erforderlich.
Geeignet, wennOperatoren benötigen eine Browser-Videowand für mehrere SRT-, RTMP- oder NDI-Feeds.
Anderes Modul verwenden, wennVerwenden Sie Webplayer für Zuschauer; Multiview ist für das operative Monitoring bestimmt.
/api/multiview/createVoraussetzungen
Verwenden Sie x-access-token zum Konfigurieren, Starten, Stoppen und Erstellen authentifizierter Viewer-Sitzungen. Wenn visibility PUBLIC ist, kann jeder mit der Multiview-ID seine öffentliche Ansicht, Statistiken und Beitrittsmethoden verwenden, also teilen Sie die ID nur so weit wie beabsichtigt.
Funktionen
createspeichert die Multiview-, Layout-, Sichtbarkeits- und Anfangseingaben; eine leere Eingabeliste ist gültig.updatewendet die vollständige gewünschte Eingabeliste und das Layout an.getAll,getCountundgetByIdprüfen gespeicherte Multiviews.startundstopsteuern die Monitoring-Laufzeit.joingibt die Browsersitzungsdetails für einen autorisierten Viewer zurück.removelöscht die Multiview.
Beispiel-Workflow
- Erstellen Sie ein privates Multiview mit dem gewünschten Layout; die Eingabeliste kann zunächst leer sein.
- Aktualisieren Sie das Multiview mit dem vollständigen Satz von RTSP-, SRT-, RTMP- oder NDI-Eingängen.
- Starten Sie die Multiview und rufen Sie die authentifizierte Join-Methode auf.
- Öffnen Sie die zurückgegebene Viewer-Sitzung und bestätigen Sie den Live-Status jeder Eingabe.
- Senden Sie die vollständige gewünschte Liste für spätere Updates; ausgelassene Eingaben werden entfernt.
Typische Anwendungsfälle
- Überwachen Sie RTSP-Kameras direkt, ohne eine separate SRT-/RTMP-Brücke aufzubauen.
- Überwachen Sie Primär- und Backup-Contribution-Feeds in einem Kontrollraum.
- Geben Sie einem Remote-Produzenten eine Ansicht von Kameras, Programmausgabe und Rückgabefeeds.
- Vergleichen Sie regionale oder Sprachausgaben vor der Verteilung.
Einschränkungen und Fehlerbehebung
Korrigieren Sie fehlende oder ungültige Namen, RTSP-URLs, Eingabe-IDs, Sichtbarkeitswerte oder Teilnehmerdaten, bevor Sie die Anfrage erneut senden. Ein Multiview kann verfügbar bleiben, während einer seiner Eingänge offline ist; prüfen Sie deshalb den Live-Status jedes Eingangs einzeln. Fügen Sie nur dann eine Verarbeitungspipeline hinzu, wenn eine Quelle Transcodierung, Größenänderung, Audioanpassungen oder ein separates Auslieferungsprotokoll benötigt.
Nächste Schritte
Verbinden Sie die vorgesehenen Feeds, prüfen Sie den Viewer-Zugriff und aktivieren Sie den öffentlichen Zugriff nur, wenn das Multiview geteilt werden soll.
Ein Operator-Multiview erstellen und verwalten
Erstellen Sie die Videowand mit geprüften Eingangs-Kacheln, aktualisieren Sie das Layout ohne neue Ressourcen-ID, starten Sie sie und prüfen Sie die gespeicherte Ressource vor der Freigabe eines öffentlichen Raums.
- Videowand erstellenDefinieren Sie Quellen-Kacheln, Layout, Sichtbarkeit und Operator-Einstellungen.
POST /api/multiview/create - Kacheln und Layout aktualisierenSenden Sie die vorhandene ID mit dem vollständig gewünschten Raum-, Quellen-, Sichtbarkeits- und Layoutzustand.
POST /api/multiview/update - Videowand startenStarten Sie das Multiview erst, nachdem seine Eingangsressourcen verfügbar sind.
POST /api/multiview/start - Verwaltete Videowand lesenPrüfen Sie Quellen- und Sichtbarkeitszustand über die authentifizierte Ressource, bevor Sie eine öffentliche ID freigeben.
POST /api/multiview/getById - Raumstatus lesenVerwenden Sie den öffentlichen Status-Aufruf nur für einen bewusst öffentlichen Raum.
POST /api/multiview-public/getStat
Behandeln Sie eine öffentliche Multiview-ID als teilbares Zugriffsmittel. Halten Sie private Operator-Wände hinter authentifizierten Methoden.
Einen Contribution-Feed empfangen, im Multiview überwachen und aufzeichnen
Stellen Sie zuerst den SRT-Ingest bereit, binden Sie dessen Ressourcen-ID an eine private Multiview-Kachel und verwenden Sie dieselbe fehlerfreie Quelle anschließend für eine Aufzeichnung.
- Contribution-Ingest erstellenKonfigurieren Sie Listener, Zugriff, Latenz und Routing und behalten Sie die zurückgegebene SRT-Server-ID.
POST /api/srt-servers/create - Ingest startenStarten Sie den Listener und bestätigen Sie die verbundene Contribution-Quelle vor dem Aufbau nachgelagerter Ressourcen.
POST /api/srt-servers/start - Private Videowand erstellenErstellen Sie das Multiview-Grundgerüst mit Layout, Sichtbarkeit und Overlay-Einstellungen.
POST /api/multiview/create - SRT-Kachel anbindenSetzen Sie source_id der Kachel auf die SRT-Server-ID und verwenden Sie den dokumentierten SRT-Software-Quellentyp.
POST /api/multiview/update - Operator-Monitoring startenStarten Sie die aktualisierte Wand und treten Sie über den authentifizierten Operator-Pfad bei.
POST /api/multiview/start - Archiv-Job erstellenWählen Sie denselben SRT-Server über das SRT-Eingabe-Preset des Recording-Moduls und legen Sie Format und Modus fest.
POST /api/recording/create - Aufzeichnung startenStarten Sie die Aufzeichnung erst bei stabilem Ingest und Operator-Multiview.
POST /api/recording/start - Aufzeichnungszustand prüfenÜberwachen Sie Bitrate, Bildrate, Ausgabezeit, Geschwindigkeit und Fortschritt unabhängig von der Videowand.
POST /api/recording/getStat
Multiview wird derzeit mit einer leeren inputs-Liste erstellt. Fügen Sie die SRT-Kachel per Update hinzu: source_kind ist INPUT_TYPE_SRT_SOFTWARE und source_id ist die SRT-Server-ID. Der Recording-Create-Aufruf benötigt sein eigenes SRT-Eingabe-Preset; die Multiview-ID ist keine Recording-Quellen-ID.
Erstellen Sie ein Multiview. Sofern active nicht false ist, startet Callaba auch die zugeordneten Eingänge und die Konferenz. Der Benutzerbereich wird aus dem API-Token abgeleitet; senden Sie deshalb kein user_id.
Nächster Aufruf: Lesen Sie mit getById die gespeicherten Eingänge und fordern Sie anschließend mit join ein Operator-Token an.
Eine Antwort mit Status 400 hat die Form { success: false, status, code, message, details }.
Erforderlicher, für Operatoren sichtbarer Name, 1–120 Zeichen.
Optionale Layout-Kennung: Die Engine verwendet standardmäßig 4-tiles.
Optionale Overlay-Konfiguration für die Videowand.
Optionale Eingabedefinitionen: Unterstützte Laufzeitquellentypen umfassen direktes RTSP sowie SRT-, RTMP- und NDI-Varianten. Beginnen Sie mit einem leeren Array, wenn Sie die Wand bereitstellen möchten, bevor Sie Feeds hinzufügen.
Optional PRIVATE oder PUBLIC. Der Standard ist PRIVATE.
Optionaler anfänglicher Laufzeitstatus. Standardmäßig aktiv, sofern nicht explizit auf false gesetzt.
Stabile Multiview-Kennung.
Vom Operator vergebener Multiview-Name.
Ausgewähltes Kachellayout, zum Beispiel 4-tiles.
Normalisierte Videoeingänge und deren Laufzeitbindungen.
PRIVATE oder PUBLIC.
Zugeordnete Konferenz für die Bedienoberfläche.
Aktivstatus der Multiview-Laufzeit.