Aufzeichnungsmanagement
In diesem Leitfaden erfahren Sie, wie Sie die Aufzeichnungen Ihrer Sitzungen mithilfe der Meetings API verwalten können.
Aktivieren der Aufzeichnung
Es gibt zwei Möglichkeiten, die Aufzeichnung für einen Besprechungsraum zu aktivieren. Sie können entweder Aufnahme in der Benutzeroberfläche aktivieren um den Teilnehmern zu ermöglichen, die Aufzeichnung zu starten/zu stoppen, oder die Besprechung auf automatisch erfassen. Sie können die Aufzeichnung auch so konfigurieren, dass nur der Eigentümer eines Raums und die gemeinsame Bildschirmnutzung während der Besprechung aufgezeichnet werden.
Ermöglichen Sie den Teilnehmern, die Aufzeichnung über die Meeting-Benutzeroberfläche zu starten.
Zunächst können Sie die Aufzeichnungsoption in der Benutzeroberfläche eines Meetings aktivieren, indem Sie is_recording_available. Diese Funktion kann sowohl für Sofort- als auch für Langzeiträume aktiviert werden. Mit dieser Anfrage wird beispielsweise ein Sofortraum mit der Bezeichnung "Neuer Besprechungsraum" erstellt, der es den Teilnehmern einer Sitzung ermöglicht, die Aufzeichnung zu aktivieren:
Vorkonfigurierte Aufzeichnungsoptionen
Die recording_options Objekt kann verwendet werden, um diese Optionen zu aktivieren/deaktivieren:
auto_record: Alle Sitzungen in diesem Raum werden automatisch aufgezeichnet. Die Aufzeichnung kann nicht gestoppt werden, wenn diese Einstellung auftrue.record_only_owner: Nehmen Sie nur den Bildschirm des Eigentümers oder einen beliebigen Bildschirm des Videos auf.
So wird z. B. ein Langzeitraum erstellt, der automatisch aufgezeichnet wird, aber nur der Raumbesitzer und alle gemeinsam genutzten Bildschirme werden in der Aufzeichnung gezeigt:
Rückrufe aufzeichnen
Es gibt drei Rückrufe, die Sie erhalten, wenn Sie eine Sitzung mit der Meetings API aufzeichnen. Sie sollten sich den recording_id und session_idda diese später zum Abrufen und Verwalten Ihrer Aufnahmen verwendet werden.
Aufnahme gestartet
Eine Benachrichtigung, dass die Aufzeichnung für eine Sitzung begonnen hat.
Aufnahme Beendet
Eine Benachrichtigung, dass die Aufzeichnung für eine Sitzung beendet wurde.
Aufnahme hochgeladen
Eine Benachrichtigung, dass eine Aufzeichnung einer Sitzung hochgeladen wurde und über die url.
Abrufen von Aufzeichnungen
Aufzeichnungen sind mit der Sitzung verknüpft, in der sie entstanden sind. Um Aufzeichnungen abzurufen oder zu verwalten, benötigen Sie
die session_iddie in den Callbacks zu finden sind, oder die recording_id, die
sein. mit Hilfe der Sitzungs-ID abgerufen oder können
auch in den Rückrufen zu finden sein.
Hinweis: Die Aufzeichnungen werden 30 Tage lang aufbewahrt.
Alle Aufzeichnungen aus einer Sitzung abrufen
https://api-eu.vonage.com/v1/meetings/sessions/:session_id/recording
Um alle Aufzeichnungen für eine Sitzung zu erhalten, können Sie eine
sessions Endpunkt unter Verwendung der session_id: Beispiel-Anfrage
Dies gibt ein Objekt der Klasse Vonage::Meetings::Sessions::ListResponse Klasse.
Diese Klasse definiert eine each Methode, die es Ihnen ermöglicht, durch die folgenden Elemente zu iterieren recordings Array, das in der Antwort zurückgegeben wird. Zum Beispiel:
Die Klasse umfasst außerdem Enumerable, so dass Sie jede Instanzmethode dieses Moduls für das Objekt aufrufen können. Zum Beispiel:
Beispiel Antwort
Einzelne Aufzeichnung abrufen
https://api-eu.vonage.com/v1/meetings/recordings/:recording_id
Sobald Sie die recording_idkönnen Sie die recordings Endpunkt, um eine Aufzeichnung abzurufen:
Beispiel-Anfrage
Dies gibt eine generische Vonage::Response Objekt.
Die Vonage::Response Objekt de-serialisiert die zurückgegebenen JSON-Daten in Vonage::Entity Objekten und bietet Getter-Methoden für die Top-Level-Eigenschaften dieser JSON-Daten, zum Beispiel:
Für Eigenschaften in den JSON-Daten, bei denen der Wert ein JSON-Objekt ist, wird dieses selbst in ein JSON-Objekt de-serialisiert. Vonage::Entity Objekt, mit seinen eigenen Getter-Methoden. Zum Beispiel kann das _links Getter gibt eine Vonage::Entity Objekt mit einer url getter, der selbst eine Vonage::Entity Objekt mit einer href getter. Sie können diese Getter-Methodenaufrufe verketten, um an die benötigten Daten zu gelangen:
Beispiel Antwort
Eine Aufnahme löschen
https://api-eu.vonage.com/v1/meetings/recordings/:recording_id
Sie können eine Aufnahme mit einer [LÖSCHEN]-Aktion löschen, indem Sie die recording_id über die recordings Endpunkt:
Beispiel-Anfrage
Verschlüsselung der Aufzeichnung
Alle Aufnahmen werden in Amazon S3 gespeichert und beim Hochladen automatisch verschlüsselt, wie in der Datenschutzerklärung beschrieben. Amazon-Dokumentation:
Amazon S3 wendet jetzt die serverseitige Verschlüsselung mit von Amazon S3 verwalteten Schlüsseln (SSE-S3) als Basisverschlüsselungsebene für jeden Bucket in Amazon S3 an. Ab dem 5. Januar 2023 werden alle neuen Objekt-Uploads in Amazon S3 automatisch verschlüsselt, ohne zusätzliche Kosten und ohne Auswirkungen auf die Leistung. Der automatische Verschlüsselungsstatus für die Standardverschlüsselungskonfiguration von S3-Buckets und für neue Objekt-Uploads ist in AWS CloudTrail-Protokollen, S3 Inventory, S3 Storage Lens, der Amazon S3-Konsole und als zusätzlicher Amazon S3-API-Antwort-Header in der AWS-Befehlszeilenschnittstelle und den AWS SDKs verfügbar. Für weitere Informationen siehe Standard-Verschlüsselung FAQ.