Webplayer-Gruppen
Verwenden Sie Webplayer-Gruppen, damit Zuschauer auf einer Seite zwischen freigegebenen Sprachfeeds, Kameraperspektiven oder Replay-Varianten wechseln können.
Geeignet, wennMehrere vorhandene Player benötigen eine gemeinsame Seite für Sprach-, Kamera- oder Replay-Auswahl.
Anderes Modul verwenden, wennVerwenden Sie zuerst Webplayer, um jeden zugrunde liegenden Wiedergabe-Endpunkt zu erstellen und zu prüfen.
/api/vod-group/createVoraussetzungen
Alle Verwaltungsmethoden erfordern einen gültigen x-access-token. Erstellen und testen Sie die einzelnen Webplayer, bevor Sie deren Kennungen zu einer Gruppe hinzufügen.
Funktionen
createundupdatedefinieren Mitgliedschaft, Standardauswahl, Zugriff, Branding und Ereigniseinstellungen.getAll,getCountundgetByIdinspizieren Gruppen.startundstopsteuern die Verfügbarkeit der Gruppe.removelöscht die Gruppe, lässt die enthaltenen Webplayer jedoch unverändert.
Beispiel-Workflow
- Erstellen und validieren Sie einen Webplayer für jeden Sprachfeed.
- Erstellen Sie eine Gruppe, die diese Playeridentifikatoren enthält.
- Wählen Sie die primäre Sprache als Standard.
- Wenden Sie die gemeinsamen Zugriffs- und Ereigniseinstellungen an.
- Starten Sie die Gruppe und veröffentlichen Sie ihre Viewer-URL oder Einbettung.
Typische Anwendungsfälle
- Bieten Sie parallele Sprach- oder Kommentar-Feeds auf einer Veranstaltungsseite an.
- Veröffentlichen Sie eine kuratierte Reihe von Wiederholungs- oder Episodenvarianten.
- Wenden Sie eine gemeinsame Zugriffs- oder Pay-per-View-Richtlinie auf mehrere Player an.
Einschränkungen und Fehlerbehebung
Eine Gruppe ist auf gültige, abspielbare Webplayer angewiesen. Wenn Sie einen enthaltenen Player entfernen oder stoppen, bleibt die entsprechende Auswahl möglicherweise bis zur nächsten Aktualisierung nicht verfügbar. Testen Sie vor der Veröffentlichung die Standardauswahl, den Zugriffsablauf und jeden Player.
Nächste Schritte
Öffnen Sie Webplayer, um jede Quelle vorzubereiten. Betten Sie die getestete Gruppe anschließend in die Zuschaueroberfläche ein oder verlinken Sie sie.
Ein Pay-per-View-Event erstellen
Bereiten Sie zuerst die Player vor, gruppieren Sie die freigegebenen Feeds auf einer Zuschauer-Seite und setzen Sie Pay-per-View- und Zugriffseinstellungen an der Gruppe.
- Event-Player erstellenBereiten Sie jeden Live- oder Datei-Feed vor, den Zuschauer kaufen können.
POST /api/vod/create - Bezahlte Gruppe erstellenVerbinden Sie Player und konfigurieren Sie pay_per_view_settings, Zugriff, Branding und Eventdaten.
POST /api/vod-group/create - Zuschauer-Seite startenStarten Sie die Gruppe erst nach erfolgreichen Kauf- und Wiedergabetests.
POST /api/vod-group/start
Eine Zahlungskonfiguration ist kein abgeschlossener Commerce-Test. Prüfen Sie Kauf, Autorisierung, Supportkontakt und Wiedergabe vor dem Event mit einem Testkunden.
Verwenden Sie diese Methode, wenn mehrere Player mit gemeinsamer Auswahl, Branding, Veranstaltungsdarstellung oder Zugriffsrichtlinie auf einer Zuschaueroberfläche bereitgestellt werden sollen.
Sie ist der übliche Einrichtungsschritt für Sprach-, Kamera- oder Kommentargruppen, insbesondere wenn Passwort- oder Pay-per-View-Regeln für die gesamte Gruppe gelten. Beispiele für Operator-Automatisierung finden Sie unter vMix Script.
Verwenden Sie dies, wenn mehrere parallele Webplayer Sprach- oder Kommentarvarianten darstellen und einer standardmäßig ausgewählt werden soll.
Verwenden Sie dies, wenn die gruppierte Browser-Erfahrung zwischen On-Demand-Dateien oder vorbereiteten dateibasierten Playern wechseln soll.
Verwenden Sie dies, wenn die gruppierte Wiedergabe hinter einem gemeinsamen Gästepasswort privat bleiben soll.
Verwenden Sie dies, wenn eine gebrandete Veranstaltungsseite einen oder mehrere Player mit PayPal-basierten Zahlungs-, Zugriffs- und Zeitplanmetadaten zusammenfassen soll.
Dashboard-Bezeichnung: Gruppenname.
Lesbarer Name der gruppierten Wiedergabeoberfläche.
Dashboard-Bezeichnung: Typ.
Unterstützte Werte sind LANGUAGE_LIST und FILES_LIST.
Liste der verknüpften Playereinträge: Jedes Element enthält id, den Anzeigenamen name und das Flag selected, das für die Standardauswahl verwendet wird.
Unterstützte Modi sind VOD_PASSWORD_DISABLED, VOD_USE_PASSWORD und Kombinationen aus E-Mail-Adresse und Passwort.
Optionaler Pay-per-View-Block: Das aktuelle Dashboard zeigt zusätzlich zum deaktivierten Standard einen PayPal-basierten Modus an.
Optionale Branding-Felder für die gruppierte Wiedergabeseite.
Optionaler Supportkontakt, der in der veranstaltungsspezifischen Playeroberfläche angezeigt wird.
Optionale Zeitplanmetadaten der Veranstaltung, die in der Gruppe gespeichert sind.
Dashboard-Bezeichnung: Einmal erstellt aktivieren.
Steuert, ob die Gruppe direkt nach der Bereitstellung aktiv sein soll.
Kennungen und die Kerngruppenidentitätsfelder.
Gespeicherte Playereinträge in der Gruppe, einschließlich des Status der Standardauswahl.
Autorisierungsstatus plus alle verknüpften Zuschauer-Benutzer, die zur Gruppe gehören.
Gespeicherte Pay-per-View-Konfiguration für die Gruppe.
Branding- und Ereignismetadaten, die mit dem Gruppenobjekt zurückgegeben werden.
Aktueller Aktivstatus und Backend-verwaltete Zeitstempel.
Bei erfolgreicher Ausführung enthält die Antwort success: true.