Ir al contenido
Documentation

Grabaciones de RTC

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.

  1. Únase a una sala abierta y publique el contenido de audio o vídeo deseado.
  2. Seleccione Iniciar grabación en los controles de la llamada.
  3. Abrir Grabaciones para examinar el trabajo. Utilice Actualizar para actualizar el estado.
  4. Seleccione Detener en la grabación activa una vez finalizada, o cierre la sala.
  5. 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.

EstadoSignificado
queuedSe ha aceptado la solicitud de inicio
recordingLa captura está activa o se está iniciando
processingLa captura ha finalizado y se está ultimando la salida
readyLos archivos de las pistas están disponibles para su descarga autorizada
failedLa 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.

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 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.

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.