RTC-Aufzeichnungen
Vor der Aufzeichnung
Abschnitt betitelt „Vor der Aufzeichnung“Stellen Sie sicher, dass die Aufzeichnung im RTC des Arbeitsbereichs enthalten ist Tarif. Informieren Sie die Teilnehmer und holen Sie alle für Ihren Anwendungsfall erforderlichen Einwilligungen ein. Ihre Anwendung muss über eine eigene, gut sichtbare Aufzeichnungsanzeige sowie ein Einwilligungsverfahren verfügen.
Die Teilnehmer sollten die Spuren, die Sie erfassen möchten, bereits veröffentlichen, wenn die Aufzeichnung beginnt. Die aktuelle Version erfasst die ausgewählten Spuren; sie fügt neue Teilnehmer oder Spuren, die erst später mit der Veröffentlichung beginnen, nicht automatisch hinzu. Eine stille oder leere Sitzung ist kein aussagekräftiger Aufzeichnungstest.
Aufzeichnung in der Konsole
Abschnitt betitelt „Aufzeichnung in der Konsole“- Treten Sie einem offenen Raum bei und veröffentlichen Sie das gewünschte Audio-/Videomaterial.
- Auswählen Aufnahme starten in den Aufrufparametern.
- Öffnen Aufzeichnungen um den Auftrag zu überprüfen. Verwenden Sie Aktualisieren um den Status neu zu laden.
- Auswählen Stopp Beenden Sie die aktive Aufzeichnung, sobald Sie fertig sind, oder schließen Sie den Raum.
- Warten Sie, bis der Auftrag
readyVerwenden Sie anschließend die Schaltflächen zum Herunterladen des Titels.
Das Verlassen Ihres eigenen Anrufs ist nicht dasselbe wie das explizite Beenden der Aufzeichnung oder das Schließen des Raums. Verwenden Sie für Integrationen die Aufzeichnung API. Um die Audioaufnahme einer Aufzeichnung in Text umzuwandeln, lesen Sie bitte Transkription.
Lebenszyklus
Abschnitt betitelt „Lebenszyklus“| Status | Bedeutung |
|---|---|
queued | Die Startanfrage wurde angenommen |
recording | Die Aufzeichnung ist aktiv oder wird gestartet |
processing | Die Aufzeichnung wurde beendet und die Ausgabe wird fertiggestellt |
ready | Titel-Dateien stehen zum autorisierten Download zur Verfügung |
failed | Die Aufnahme oder Verarbeitung wurde nicht erfolgreich abgeschlossen |
Für einen Raum darf jeweils nur ein Auftrag in der Warteschlange, in der Aufzeichnung oder in der Verarbeitung vorhanden sein. Behandeln Sie keinen 202 Eine „start“-Antwort oder eine erfolgreiche „stop“-Anfrage gilt als Abschluss. Verwenden Sie die Aufzeichnungsliste oder die signierte recording.ready Ereignis.
Ausgabe und aktuelle Einschränkungen
Abschnitt betitelt „Ausgabe und aktuelle Einschränkungen“Die Ausgabe lautet Einzelne MKV-Spuren, nicht ein einzelnes zusammengesetztes Besprechungsvideo. Jeder Track gibt seinen Medientyp, seine Quelle, seinen Teilnehmer, seine Größe und seine Track-ID an. Die Wiedergabeunterstützung variiert; verwenden Sie einen kompatiblen Player oder Ihren eigenen Medienverarbeitungs- Workflow, wenn Sie ein anderes Format oder ein kombiniertes Layout benötigen.
Die aktuelle Version der Aufzeichnungsfunktion beschränkt die Aufzeichnung auf eine Stunde und etwa 1 GiB pro Spur. Später hinzugekommene Spuren werden nicht automatisch erfasst.
Aufzeichnungen löschen, aufbewahren oder übermitteln
Abschnitt betitelt „Aufzeichnungen löschen, aufbewahren oder übermitteln“Eine Aufzeichnung löschen mit DELETE /v1/recordings/{recordingId}: Es wird an den Papierkorb gesendet, nach 30 Tagen automatisch gelöscht, und Sie können es bis dahin wiederherstellen mit
POST /v1/recordings/{recordingId}/restore. Eine Aufnahme im Papierkorb wird weiterhin auf Ihren Aufnahmespeicher angerechnet. Um sie früher endgültig zu entfernen, löschen Sie sie aus dem Papierkorb mit POST /v1/recordings/{recordingId}/purge: RTC antwortet 202
(status: "deleting"), der Löschvorgang ist in Kürze abgeschlossen und recording.purged
folgen.
CHAMPREP werden für die Aufbewahrungsfrist Ihres Tarifs gespeichert; nach Ablauf dieser Frist wird die Aufzeichnung ebenfalls in den Papierkorb verschoben. Bei Tarifen, die diese Funktion beinhalten, kopiert RTC zudem jede fertige Aufzeichnung in Ihren eigenen Speicherbereich, und diese Kopien werden niemals von RTC gelöscht. Siehe Eine Aufzeichnung löschen und Nutzen Sie Ihren eigenen Speicherplatz.
Sicher herunterladen
Abschnitt betitelt „Sicher herunterladen“Ihr Backend verwendet einen Schlüssel mit recordings:read um die Download-URL eines ausgewählten Titels abzufragen. Die API prüftAPI den Projektzugriff der Aufnahme und des Schlüssels. Anschließend gibt sie eine URL der RTC-Domain zurück, die nach fünf Minuten abläuft.
Jeder, der im Besitz dieser temporären URL ist, kann sie nutzen, solange sie gültig ist. Eine separate Anmeldung im Browser ist nicht erforderlich. Stellen Sie die Datei nur einem Nutzer zur Verfügung, den Ihre Anwendung autorisiert hat, oder streamen Sie die Datei über Ihr eigenes authentifiziertes Backend, wenn Sie möchten, dass jeder Download an die Sitzung Ihrer Anwendung gebunden ist.
- Veröffentlichen Sie Download-URLs nicht auf öffentlichen Seiten, in Analysedaten, Protokollen oder geteilten Nachrichten.
- Rufen Sie die URL genau so ab, wie sie zurückgegeben wurde, anstatt einen Objektpfad zu erstellen.
- Sollte die URL ablaufen, fordern Sie nach erneuter Überprüfung der Zugriffsrechte eine neue an.
- Durch den Widerruf des ausstellenden APISchlüssels werden dessen ausstehende Download-Berechtigungen ungültig.
- Das Herunterladen einer autorisierten Kopie führt nicht dazu, dass diese gespeicherte Kopie widerrufbar wird.
Verwendung Webhooks , um Ihrer Anwendung mitzuteilen, dass die Verarbeitung abgeschlossen ist, ohne wiederholt Download-Berechtigungen anzufordern.