Grabaciones de RTC
Antes de la grabación
Sección titulada «Antes de la grabación»Asegúrese de que la grabación esté incluida en el RTC del espacio de trabajo plan. Informe a los participantes y obtenga cualquier consentimiento necesario para su caso de uso. Su aplicación debe proporcionar su propio indicador visible de grabación y su propio proceso de obtención de consentimiento.
Los participantes ya deben estar publicando las pistas que desea capturar cuando comience la grabación. La versión actual captura las pistas seleccionadas; no añade automáticamente nuevos participantes ni pistas que empiecen a publicarse posteriormente. Una sesión silenciosa o vacía no constituye una prueba de grabación útil.
Grabe en la consola
Sección titulada «Grabe en la consola»- Únase a una sala abierta y publique el contenido de audio o vídeo deseado.
- Seleccione Iniciar grabación en los controles de la llamada.
- Abrir Grabaciones para examinar el trabajo. Utilice Actualizar para actualizar el estado.
- Seleccione Detener en la grabación activa una vez finalizada, o cierre la sala.
- Espere hasta que la tarea se haya
ready, y, a continuación, utilice sus botones de descarga de pistas.
Salir de su propia llamada no equivale a detener explícitamente la grabación ni a cerrar la sala. Para las integraciones, utilice el grabación API. Para convertir el audio de una grabación en texto, consulte transcripción.
Ciclo de vida
Sección titulada «Ciclo de vida»| Estado | Significado |
|---|---|
queued | Se ha aceptado la solicitud de inicio |
recording | La captura está activa o se está iniciando |
processing | La captura ha finalizado y se está ultimando la salida |
ready | Los archivos de las pistas están disponibles para su descarga autorizada |
failed | La captura o el procesamiento no se han completado correctamente |
Solo puede existir un trabajo en cola, en grabación o en procesamiento para una sala a la vez. No trate un 202 una respuesta de inicio o una solicitud de detención completada con éxito. Utilice la lista de grabaciones o el archivo firmado recording.ready evento.
Salida y restricciones actuales
Sección titulada «Salida y restricciones actuales»El resultado es pistas MKV individuales, no un único vídeo compuesto de la reunión. Cada pista identifica su tipo de medio, fuente, participante, tamaño e ID de pista. La compatibilidad de reproducción varía; utilice un reproductor compatible o su propio flujo de trabajo de procesamiento de medios cuando necesite otro formato o una disposición combinada.
La versión actual de la grabación limita la captura a una hora y aproximadamente 1 GiB por pista. No captura automáticamente las pistas de quienes se incorporan más tarde.
Eliminar, conservar o entregar grabaciones
Sección titulada «Eliminar, conservar o entregar grabaciones»Eliminar una grabación con DELETE /v1/recordings/{recordingId}: se envía a la Papelera, se elimina automáticamente tras 30 días y puede recuperarla hasta entonces mediante
POST /v1/recordings/{recordingId}/restore. Una grabación en la Papelera sigue contando para su espacio de almacenamiento de grabaciones. Para eliminarla definitivamente antes, bórrela de la Papelera con POST /v1/recordings/{recordingId}/purge: RTC responde 202
(status: "deleting"), la eliminación finaliza en breve y recording.purged
se envían a continuación.
CHAMPREP se conservan durante el periodo de retención de su plan; cuando este finaliza, la grabación se envía a la Papelera de la misma forma. En los planes que lo incluyen, RTC también copia cada grabación finalizada a su propio depósito, y RTC nunca elimina dichas copias. Consulte Eliminar una grabación y utilice su propio almacenamiento.
Descarga segura
Sección titulada «Descarga segura»Su backend utiliza una clave con recordings:read para solicitar la URL de descarga de una pista seleccionada. La API APIcomprueba el acceso del proyecto a la grabación y a la clave. A continuación, devuelve una URL del dominio RTC que caduca al cabo de cinco minutos.
Cualquier persona que disponga de esta URL temporal podrá utilizarla mientras siga siendo válida. No es necesario iniciar sesión por separado en el navegador. Facílitela únicamente a un usuario que su aplicación haya autorizado, o transmita el archivo a través de su propio servidor autenticado si necesita que cada descarga esté vinculada a la sesión de su aplicación.
- No incluya las URL de descarga en páginas públicas, herramientas de análisis, registros ni mensajes compartidos.
- Obtenga la URL tal y como se devuelve, en lugar de construir una ruta de objeto.
- Si caduca, solicite una nueva tras volver a comprobar los permisos de acceso.
- La revocación de la claveAPI emisora invalida sus autorizaciones de descarga pendientes.
- La descarga de una copia autorizada no hace que dicha copia guardada sea revocable.
Uso webhooks para notificar a su aplicación que el procesamiento ha finalizado sin solicitar repetidamente autorizaciones de descarga.