Aufzeichnung von Videos
Übersicht
Mit der Vonage Video-Archivierungs-API können Sie die Audio- und Videodaten einer Sitzung in zwei Formaten aufzeichnen:
- Zusammengestellte Archive (Standard) erzeugt MP4-Dateien, die sofort wiedergegeben werden können.
- Einzelne Stream-Archive bündeln jeden veröffentlichten Stream in ein ZIP mit Mediendateien pro Stream und Metadaten für die Nachbearbeitung.
Sie können entscheiden, welches Format Sie verwenden möchten, wenn Sie die Archivierungs-REST-API oder das Server-SDK aufrufen. Siehe die Vergleich einzelner Streams und zusammengesetzter Archive um den Modus zu wählen, der Ihrem Arbeitsablauf entspricht.
Die Archivierung erfordert sowohl clientseitigen als auch serverseitigen Code. Um Sitzungen zu archivieren, müssen Sie einen HTTP-Server einrichten. Sie können den richtigen Server-SDK für Ihr Server-Setup. Wenn das Server SDK Daten vom Client SDK erhält, führt es die eigentliche Archivierungsfunktionalität aus. Ihr client-seitiger Code ruft dann Ihren server-seitigen Code über HTTP-Aufrufe auf.
In den meisten Applications wird die Kontrolle über die Archivaufzeichnung nicht jedem Endbenutzer gewährt.
Sie können automatisch archivierte Sitzungen haben, die immer dann aufgezeichnet werden, wenn ein Client mit der Veröffentlichung eines Streams beginnt.
Sie sollten ein Amazon S3- oder Microsoft Azure-Ziel für die Speicherung Ihrer Archivaufzeichnungen einrichten.
In dieser Anleitung wird das Thema behandelt:
- Starten einer Archivaufzeichnung
- Anhalten einer Archivaufzeichnung
- Abrufen von Archivaufzeichnungsinformationen
Bevor Sie beginnen
Bevor Sie die Aufzeichnung zu Ihrer Anwendung hinzufügen, sollten Sie sicherstellen, dass Sie bereits eine grundlegende Videoanwendung laufen haben.
Wenn Sie keinen eigenen Server schreiben möchten, können Sie einen vorgefertigten Server verwenden, der im Code Hub von Vonage bereitgestellt wird. Gehen Sie zum Vonage Video-Lernserver (PHP) und klicken Sie auf "Code bereitstellen". Dadurch wird unser Lernserver heruntergeladen und automatisch für Sie gestartet.
Wenn Sie den Code erforschen möchten, können Sie stattdessen auf "Get Code" klicken oder auf die Seite GitHub und laden Sie den Code auf Ihren lokalen Rechner herunter.
Sie können nur Läufe archivieren, die den Vonage Video-Media-Router (Sitzungen, bei denen der Medienmodus auf geroutet eingestellt ist)
Starten einer Archivaufzeichnung
Sofern Ihre Sitzung nicht auf automatische Archivierung eingestellt ist, müssen Sie unserem System mitteilen, dass die Aufzeichnung Ihrer Sitzung beginnen soll. In der Praxis bedeutet dies, dass Ihr Front-End einem Moderator (oder einer anderen geeigneten Rolle) die Aufzeichnungsoptionen präsentiert und Ihr Front-End eine Anfrage an einen Back-End-Server sendet, der mit der API spricht, um die Aufzeichnung zu starten.
- Lassen Sie Ihr Front-End eine Anfrage an Ihren Server senden, um die Archivierung zu starten.
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"sessionId\": \"value goes here\"}");
Request request = new Request.Builder()
.url(serverURL)
.method("POST", body)
.addHeader("Content-Type", "application/json")
.build();
Response response = client.newCall(request).execute();
- Lassen Sie Ihren Back-End-Server die Anfrage annehmen und kontaktieren Sie die REST-API, um die Archivierung zu starten.
Wenn Sie die REST-API direkt verwenden, erhalten Sie eine Antwort ähnlich der folgenden:
Wenn Sie ein SDK verwenden, werden die oben genannten Informationen in einem für das SDK geeigneten Format zurückgegeben. Bitte prüfen Sie die Referenz für Ihr Server-SDK über den genauen Rückgabewert, den Sie erhalten werden.
Anhalten einer Archivaufzeichnung
Eine Aufzeichnung wird so lange fortgesetzt, bis eine der folgenden Bedingungen erfüllt ist:
- 4 Stunden Aufnahmezeit
- 1 Stunde Inaktivität (keine Clients veröffentlichen Streams)
- 12 Stunden aktive und "pausierte" Veröffentlichung insgesamt. Ein Stream wird pausiert, wenn keine Clients veröffentlichen.
Es wird nicht empfohlen, eine Archivaufzeichnung aufgrund der oben genannten Schwellenwerte zu beenden. Sie sollten ein Archiv immer dann stoppen, wenn Sie wissen, dass ein Archiv beendet ist. Dies funktioniert ähnlich wie beim Starten eines Archivs, bei dem Ihr Front-End eine Anfrage an das Back-End senden sollte, um der API mitzuteilen, dass die Aufzeichnung beendet werden soll.
- Lassen Sie Ihr Front-End eine Anfrage an Ihren Server senden, um die Archivaufzeichnung zu stoppen.
OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"session\": \"value goes here\"}");
Request request = new Request.Builder()
.url(serverURL)
.method("POST", body)
.addHeader("Content-Type", "application/json")
.build();
Response response = client.newCall(request).execute();
- Ihr Back-End-Server sendet eine Anfrage an die REST-API, um die Aufzeichnung zu beenden.
Sie werden eine Antwort ähnlich der folgenden erhalten:
Diese Antwort enthält möglicherweise nicht die endgültige Aufzeichnungs-URL, insbesondere wenn Sie auf Ihren eigenen S3- oder Azure-Speicher archivieren oder wenn die Archivaufzeichnung noch nicht abgeschlossen ist. Wir senden einen Rückruf an Ihren Server, wenn das Archiv zum Download bereit ist.
Abrufen von Archivaufzeichnungsinformationen
Sie können auch jederzeit Informationen über jede Archivaufzeichnung abrufen. Dies ist nützlich, um Statistiken über das Archiv zu erhalten und um den Status des Archivs selbst zu überprüfen. Wenn Sie z. B. ein Archiv anhalten, kann es einige Augenblicke dauern, bis das Archiv selbst fertig ist. Sie können die Informationen eines Archivs überprüfen, um festzustellen, wann das Archiv fertig ist und zum Herunterladen bereitsteht.
Sie erhalten eine ähnliche Antwort wie beim Beenden der Archivaufzeichnung.