Enregistrements RTC
Avant l’enregistrement
Section intitulée « Avant l’enregistrement »Assurez-vous que l’enregistrement est inclus dans le RTC de l’espace de travail formule d’abonnement. Informez les participants et obtenez tout consentement requis pour votre cas d’utilisation. Votre application doit disposer de son propre indicateur d’enregistrement visible et de son propre processus de consentement.
Les participants doivent déjà publier les pistes que vous souhaitez capturer lorsque l’enregistrement commence. La version actuelle capture les pistes sélectionnées ; elle n’ajoute pas automatiquement les nouveaux participants ou les pistes qui commencent à être publiées par la suite. Une session silencieuse ou vide ne constitue pas un test d’enregistrement utile.
Enregistrez dans la console
Section intitulée « Enregistrez dans la console »- Rejoignez une salle ouverte et publiez le contenu audio/vidéo souhaité.
- Sélectionnez Lancer l’enregistrement dans les contrôles d’appel.
- Ouvrir Enregistrements pour examiner la tâche. Utilisez Actualiser pour actualiser le statut.
- Sélectionnez Arrêter sur l’enregistrement actif une fois l’opération terminée, ou fermez la salle.
- Attendez que la tâche soit
ready, puis utilisez ses boutons de téléchargement de piste.
Quitter votre propre appel n’équivaut pas à arrêter explicitement l’enregistrement ou à fermer la salle. Pour les intégrations, utilisez le enregistrement API. Pour convertir l’audio d’un enregistrement en texte, consultez transcription.
Cycle de vie
Section intitulée « Cycle de vie »| Statut | Signification |
|---|---|
queued | La requête de démarrage a été acceptée |
recording | La capture est en cours ou sur le point de démarrer |
processing | L’enregistrement est terminé et le traitement de la sortie est en cours de finalisation |
ready | Les fichiers audio sont disponibles en téléchargement pour les utilisateurs autorisés |
failed | La capture ou le traitement n’a pas abouti |
Il ne peut exister qu’une seule tâche en file d’attente, en enregistrement ou en cours de traitement pour une salle à la fois. Ne traitez pas un 202 Considérez une réponse de démarrage ou une requête d’arrêt aboutie comme une opération terminée. Utilisez la liste des enregistrements ou le fichier signé recording.ready événement.
Contraintes de sortie et contraintes actuelles
Section intitulée « Contraintes de sortie et contraintes actuelles »Le résultat est pistes MKV individuelles, et non une seule vidéo de réunion montée. Chaque piste identifie son type de média, sa source, son participant, sa taille et son identifiant. La prise en charge de la lecture varie ; utilisez un lecteur compatible ou votre propre workflow de traitement multimédia lorsque vous avez besoin d’un autre format ou d’une mise en page combinée.
La version actuelle de l’enregistrement limite l’enregistrement à une heure et à environ 1 GiB par piste. Elle n’enregistre pas automatiquement les pistes des participants qui se sont joints tardivement.
Supprimer, conserver ou transmettre les enregistrements
Section intitulée « Supprimer, conserver ou transmettre les enregistrements »Supprimer un enregistrement avec DELETE /v1/recordings/{recordingId}: elle est envoyée dans la Corbeille, supprimée automatiquement au bout de 30 jours, et vous pouvez la restaurer jusqu’à ce moment-là à l’aide de
POST /v1/recordings/{recordingId}/restore. Un enregistrement placé dans la corbeille continue de compter sur votre espace de stockage d’enregistrements. Pour le supprimer définitivement plus tôt, supprimez-le de la corbeille à l’aide de POST /v1/recordings/{recordingId}/purge: RTC répond 202
(status: "deleting"), la suppression s’effectue rapidement et recording.purged
suit.
CHAMPREP conserve les enregistrements pendant la durée de conservation prévue par votre forfait ; à l’expiration de celle-ci, l’ enregistrement est transféré dans la corbeille de la même manière. Sur les forfaits qui incluent cette fonctionnalité, RTC copie également chaque enregistrement terminé dans votre propre compartiment de stockage, et ces copies ne sont jamais supprimées par RTC. Voir Supprimer un enregistrement et Apportez votre propre espace de stockage.
Téléchargez en toute sécurité
Section intitulée « Téléchargez en toute sécurité »Votre backend utilise une clé avec recordings:read pour demander l’URL de téléchargement d’un morceau sélectionné. L’API vérifieAPI les droits d’accès au projet pour l’enregistrement et la clé. Elle renvoie ensuite une URL du domaine RTC qui expire au bout de cinq minutes.
Toute personne en possession de cette URL temporaire peut l’utiliser tant qu’elle reste valide. Aucune connexion distincte au navigateur n’est requise. Ne la communiquez qu’à un utilisateur que votre application a autorisé, ou diffusez le fichier via votre propre backend authentifié si vous souhaitez que chaque téléchargement soit lié à la session de votre application.
- Ne placez pas d’URL de téléchargement dans des pages publiques, des outils d’analyse, des journaux ou des messages partagés.
- Récupérez l’URL exactement telle qu’elle vous est renvoyée plutôt que de construire un chemin d’accès à l’objet.
- Si elle expire, demandez-en une nouvelle après avoir vérifié à nouveau les droits d’accès.
- La révocation de la cléAPI d’émission invalide ses autorisations de téléchargement en cours.
- Le téléchargement d’une copie autorisée ne rend pas cette copie enregistrée révocable.
Utilisation Webhooks pour signaler à votre application que le traitement est terminé sans demander à plusieurs reprises des autorisations de téléchargement.