Erlebnis-Komponist

Experience Composer ist ein cloudbasierter Dienst, mit dem Sie jede öffentlich zugängliche Website erfassen und als Stream in einer bestehenden OpenTok-API-Sitzung veröffentlichen können. Dies komponierter Strom kann für Archivaufzeichnungen, Rundfunkübertragungen und das Streaming in andere interaktive OpenTok-Sitzungen genutzt werden, wobei die ansprechende Benutzeroberfläche und das Benutzererlebnis der Website erhalten bleiben.

REST-API-Methoden

Verwenden Sie die Video API (REST-API), um Folgendes zu tun:

OpenTok Server-SDKs sowie Anleitungen zur Verwendung von Experience Composer.

Anwendungsfälle

Experience Composer-Archiv

Sie können OpenTok verwenden Archiv Funktion zur Aufzeichnung von Audio und Video einer OpenTok-Sitzung. Das Video-Layout für das erstellte Archiv ist jedoch auf die unterstützten Formate beschränkt Video-Layout-Optionen.

Sie können Experience Composer verwenden, um die von Ihrer Website aktuell Layout für das Archivlayout:

Erstellen Sie einen „Experience Composer“, dessen URL auf eine Webseite verweist, die die Streams innerhalb einer Sitzung abonniert und dabei das entsprechende Layout anwendet.
Lassen Sie den Experience Composer die Seite in einer neuen OpenTok-Sitzung in einem Stream veröffentlichen.
Verwenden Sie die OpenTok REST API oder die OpenTok-Server-SDK-Methode, um den Experience Composer-Stream zu archivieren.

Stellen Sie die Auflösung des Archivs so ein, dass sie mit der Auflösung des Experience Composers übereinstimmt (die beim Starten des Experience Composers festgelegt wird).

Composer Broadcast erleben

Mit OpenTok Live-Streaming-Übertragungsfunktion, Sie können eine OpenTok-Sitzung in einen HLS- oder RTMP-Stream übertragen. Das Video-Layout für eine Live-Streaming-Übertragung ist jedoch auf die unterstützten Formate beschränkt Video-Layout-Optionen.

Sie können Experience Composer verwenden, um die von Ihrer Website aktuell Layout für das Sendelayout:

Erstellen Sie einen „Experience Composer“, dessen URL auf eine Webseite verweist, die die Streams innerhalb einer Sitzung abonniert und dabei das entsprechende Layout anwendet.
Lassen Sie den Experience Composer die Seite in einer neuen OpenTok-Sitzung in einem Stream veröffentlichen.
Verwenden Sie die OpenTok REST API oder die OpenTok-Server-SDK-Methode, um den Experience Composer-Stream in einen HLS- oder RTMP-Stream zu übertragen.

Stellen Sie die Auflösung des Archivs so ein, dass sie mit der Auflösung des Experience Composers übereinstimmt (die beim Starten des Experience Composers festgelegt wird).

Ausweitung der interaktiven Live-Übertragungen auf mehr Teilnehmer (bis zu Millionen)

Mit den Live-Streaming-Übertragungen von OpenTok können bis zu 15.000 Clients eine interaktive OpenTok-Sitzung verfolgen. Die unterstützte Anzahl hängt von der Anzahl der Clients ab, die in der Sitzung Streams veröffentlichen (siehe Interaktive Live-Übertragungen Leitfaden).

Sie können Experience Composer verwenden, um die Anzahl der Betrachter zu erweitern:

Erstellen Sie einen „Experience Composer“, dessen URL auf eine Webseite verweist, die die Streams der zu übertragenden OpenTok-Hauptsitzung abonniert.
Lassen Sie den Experience Composer die Seite in einer neuen OpenTok-Sitzung veröffentlichen.
Wiederholen Sie diesen Vorgang mit mehreren weiteren Experience Composer-Instanzen – wobei jede die Streams der ersten Sitzung abonniert und sie an eine neue Sitzung weiterleitet.
Ihr Anwendungsserver sendet die Sitzungs-IDs für die Composer-Sitzungen erleben an jeden der Anzeige-Clients (Clients, die keine Inhalte in der ersten Sitzung veröffentlichen). Der Anwendungsserver muss nachverfolgen, wie viele Clients jeder Experience-Composer-Sitzung hinzugefügt werden, damit sich nicht mehr als 15.000 Clients mit einer einzelnen Sitzung verbinden.

Die daraus resultierende Anzahl an Experience Composer-Sitzungen unterstützt bei zwei Publishern bis zu 15.000 * (15.000 – 2) Zuschauer (224.970.000 Zuschauer). Informationen zu anderen Publisher-Anzahlen finden Sie in der Tabelle der unterstützten Clients im Interaktive Live-Übertragungen Anleitung, und diese Technik wird dabei helfen, 15,000 * ([number supported from that table] - [number of publishers]) Kunden.

Andere Anwendungsfälle

Mit Experience Composer können Sie beliebige Webseiten erfassen und als Audio-Video-Stream an eine OpenTok-Sitzung senden, damit andere sie ansehen können. Die Seite kann Audio- und Videomaterial aus anderen Quellen als OpenTok-Streams enthalten. Oder sie kann dynamische Inhalte mit komplexem UI-Layout enthalten, die von den mit der OpenTok-Sitzung verbundenen Clients angezeigt werden können.

Beschränkungen

Keine GPU-Unterstützung

Die Rendering-Server von Experience Composer bieten keine GPU-Unterstützung. Sie sind nicht in der Lage, Web-Applications auszuführen, die in der Regel mehr als 10 % der GPU-Leistung beanspruchen würden, wenn sie in Chrome auf einem Desktop-Computer ausgeführt würden. Wenn die Webanwendung, die Sie an Experience Composer senden, OpenGL (oder anderen Code, der von einer GPU profitieren würde) verwendet, kann dies zu Leistungseinbußen und einer schlechteren Darstellung in Experience Composer führen.

Geplante Sitzungen erforderlich

Experience Composer ist nur mit gerouteten Sitzungen kompatibel (Sitzungen, die die OpenTok Media Router).

Server-Rotation

Ein Experience Composer wird während der Serverrotation für die von ihm verwendete Sitzung beendet. Sie können einen Experience Composer als Reaktion auf Benachrichtigungsereignisse zur Serverrotation neu starten. Siehe Server-Rotation und Sitzungsmigration.

Konfigurieren von Rückrufen

Um sichere Callbacks für Experience Composer-Webhooks zu konfigurieren, lesen Sie bitte dieser Leitfaden.

Wenn sich der Status eines Experience Composers ändert, wird ein HTTP POST an die konfigurierte URL gesendet. Wenn keine Callback-URL konfiguriert ist, wird keine Statusaktualisierung übermittelt. Die Rohdaten der HTTP-Anforderung sind eine JSON-kodierte Nachricht der folgenden Form:

{
  "id": "&lt;experience-composer-id&gt;",
  "sessionId": "&lt;session-id&gt;",
  "streamId": "&lt;output-stream-id&gt;",
  "status": "stopped",
  "reason": "Max duration exceeded."
  "event": "render"
}

Das JSON-Objekt enthält die folgenden Eigenschaften:

id — Die eindeutige ID für den Experience Composer.
sessionId — Die OpenTok-Sitzungs-ID.
streamId – Die ID des zusammengesetzten Streams, der veröffentlicht wird. Die streamId ist möglicherweise nicht verfügbar, wenn der Status „failed“ lautet.
status — Der Status des Experience Composers. Diese Eigenschaft kann einen der folgenden Werte annehmen:
- „gestartet“ – Die Vonage Video API-Plattform hat erfolgreich eine Verbindung zum Remote-Anwendungsserver hergestellt und veröffentlicht die Webansicht in einem OpenTok-Stream.
- „beendet“ – Der Experience Composer wurde beendet.
- „fehlgeschlagen“ – Es ist ein Fehler aufgetreten, und der Experience Composer konnte nicht fortfahren. Dies kann beim Start auftreten, wenn der OpenTok- Server keine Verbindung zum Remote-Anwendungsserver herstellen oder den Stream nicht erneut veröffentlichen kann. Es kann auch zu jedem beliebigen Zeitpunkt während des Vorgangs aufgrund eines Fehlers der Vonage Video API-Plattform auftreten.
Grund – Dieses Feld ist nur verfügbar, wenn der Status entweder „gestoppt“ oder „fehlgeschlagen“ lautet. Wenn der Status „gestoppt“ lautet, enthält das Feld „Grund“ entweder den Eintrag „Maximale Dauer überschritten“ oder „Stopp angefordert“. Wenn der Status „fehlgeschlagen“ lautet, enthält das Feld „Grund“ den Eintrag „Interner Serverfehler“.
Ereignis – Bei allen Callback-Ereignissen des Experience Composer ist dieser Wert auf „render“ gesetzt.

Visualisierung von Daten

Daten in der Insights-API anzeigen

Sie können die Einblicke API um die Nutzungsdaten von Experience Composer anzuzeigen. Die experienceComposer Die Nutzungsdaten zeigen die von Experience Composer veröffentlichten Protokolle.

Die experienceComposerArchive und experienceComposerBroadcast Verwendungseigenschaften sind veraltet. Zuvor war die experienceComposer Nutzungsdaten haben nicht umfassten Protokolle aus Zeiten, in denen ein „Experience Composer“ mit einem Archiv oder einer Übertragung verbunden war. Dies ist jedoch nicht mehr der Fall. (Die Pakete „Experience Composer Archive“ und „Experience Composer Broadcast“ sind nicht mehr verfügbar.)