Retransmisiones
Usa Retransmisiones para distribuir simultáneamente una entrada en directo a plataformas de streaming y endpoints privados. Haz remux cuando los formatos coincidan; si no, transcodifica, cambia el tamaño, ajusta el audio o añade overlays.
Elige este módulo cuandoUna fuente en directo debe llegar a otra plataforma o protocolo, con transcodificación, cambio de tamaño, audio u overlays opcionales.
Usa otro módulo cuandoUsa Rutas SRT para reenviar SRT o UDP sin cambios; usa Reproductores web para la audiencia.
/api/restream/createAntes de empezar
Todos los métodos requieren un x-access-token válido. Crea primero los módulos de entrada referenciados y confirma que el destino acepta el protocolo, códec, resolución, bitrate y credenciales seleccionados.
Qué puedes hacer
createyupdateconfiguran la entrada, la salida, la transcodificación, las modificaciones multimedia y los overlays.getAll,getCountygetByIdconsultan los procesos.startystopcontrolan el pipeline en directo.getStatdevuelve el bitrate, la cadencia y el estado del proceso disponibles.removeelimina un proceso.
Flujo de ejemplo
- Selecciona una entrada gestionada o una fuente por URL compatible.
- Define un destino RTMP, SRT, RIST u otro destino compatible.
- Activa la transcodificación o los cambios multimedia solo si la salida los necesita.
- Inicia el proceso y usa
getStatpara confirmar que la señal está circulando. - Detén el proceso antes de cambiar las credenciales o los ajustes del destino.
Casos de uso habituales
- Enviar una señal de contribución SRT a un destino de distribución RTMP.
- Recibir o entregar una señal RIST dentro de un flujo de distribución en directo.
- Transcodificar, cambiar el tamaño, ajustar el audio o añadir un overlay antes de la entrega.
- Mantener estable la entrada mientras cambian los destinos downstream entre eventos.
Límites y resolución de problemas
Una retransmisión guardada puede tener la entrada offline o un destino que rechaza la conexión; comprueba su estado en directo después de iniciarla. La transcodificación requiere mucha más capacidad de CPU o GPU que el remux. Para entregar por RIST, usa una URL RIST compatible y una señal MPEG-TS, y comprueba en ambos extremos el perfil RIST y los ajustes de seguridad.
Siguientes pasos
Valida el destino y añade después supervisión o entrega en el navegador mediante Reproductores web cuando sea necesario.
Enviar una entrada en directo a varios destinos
Crea un proceso de restream por destino desde la misma entrada verificada, inicia los procesos y supervisa cada salida por separado.
- Crear cada destinoReutiliza la entrada e indica el protocolo, las credenciales y la URL de cada destino.
POST /api/restream/create - Iniciar la entregaInicia cada proceso guardado cuando su fuente upstream esté estable.
POST /api/restream/start - Supervisar cada salidaCompara el bitrate y el estado por destino en lugar de tratar el fan-out como un único estado.
POST /api/restream/getStat
Una respuesta de creación correcta confirma la configuración, no el estado del medio. Inicia el recurso y comprueba sus estadísticas antes de enviar tráfico de producción.
Transcodificar un stream en directo para su destino
Crea un restream con el códec, bitrate, resolución o conversión de audio necesarios y confirma después el ritmo del proceso en sus estadísticas.
- Definir la transcodificaciónElige los presets de entrada y salida y configura solo los campos de procesamiento necesarios.
POST /api/restream/create - Iniciar el procesamientoInicia tras validar códecs, resolución, bitrate y credenciales del destino.
POST /api/restream/start - Comprobar el procesoObserva bitrate, cadencia y estado para detectar bloqueos o falta de capacidad.
POST /api/restream/getStat
Activa solo el procesamiento que necesita el destino. La transcodificación consume mucha más CPU o GPU que el remuxing.
Ejecutar playout continuo de un archivo hacia un destino en directo
Registra o sube el recurso, úsalo como entrada de archivo en bucle para un restream y supervisa la salida permanente.
- Preparar el archivoSube la fuente y conserva el id devuelto para la entrada de playout.
POST /api/files/uploadFile - Crear el playout en bucleUsa la entrada de archivo en bucle y configura el destino y el procesamiento necesarios.
POST /api/restream/create - Supervisar el canalComprueba el proceso y el bitrate de destino como parte del control continuo.
POST /api/restream/getStat
El tipo de entrada en bucle verificado es INPUT_TYPE_FILE_VIDEO_INFINITY y input_module_id debe identificar un archivo gestionado existente.
Crea un pipeline multimedia gestionado con origen, destino, transcodificación opcional, ajustes de audio o vídeo, overlays y estado activo inicial. Envía el JWT generado en el panel mediante la cabecera x-access-token.
Para una URL RIST, usa INPUT_TYPE_RIST_URL en input.input_type o OUTPUT_TYPE_RIST_URL en output.output_type. Una salida RIST envía MPEG-TS a output_stream_url.
Ejemplos de solicitud
Elige la plantilla que corresponda al origen y al destino y añade solo el procesamiento necesario.
Casos de uso habituales
- Volver a publicar una señal de contribución en una red social o CDN.
- Conectar SRT, RTMP, RIST, HLS u otro transporte compatible.
- Transcodificar, añadir overlays o distribuir una fuente entre varias salidas.
Usa este preajuste para reenviar una contribución SRT entrante a un destino RTMP, como una plataforma social u otro destino RTMP administrado.
Es el flujo de restream más habitual: recibe por SRT, mantén la transcodificación desactivada o al mínimo y envía el resultado a una salida RTMP.
Usa este preajuste cuando la tarea deba conectar una fuente SRT con otro destino SRT y conservar la canalización como un proceso administrado.
Resulta útil para desacoplar la entrada y la entrega sin sacarlas de una misma tarea de restream activa.
Usa este preajuste para leer HLS como entrada y ejecutar la canalización multimedia con fines de monitorización, pruebas o medición, sin reenviar la salida a otro destino.
Usa esta configuración para comprobaciones controladas de reproducción y flujos de sondeo creados a partir de una tarea de restream.
Nombre legible de la tarea. El panel lo valida como campo obligatorio.
Definición de entrada creada con los controles InputSource del panel. Este objeto determina el transporte de origen o la conexión con otro módulo. Una entrada RIST mediante URL usa INPUT_TYPE_RIST_URL con input_stream_url.
Definición de salida creada con los controles OutputSource del panel. Este objeto determina dónde envía o expone el resultado la canalización. Una salida RIST mediante URL usa OUTPUT_TYPE_RIST_URL con output_stream_url; Callaba Engine emite MPEG-TS por esta ruta.
Perfil de transcodificación opcional de la canalización FFmpeg. El panel siempre envía este bloque, incluso cuando la transcodificación está desactivada.
Ajustes opcionales para modificar el audio. El panel envía un objeto en estado desactivado cuando no se solicita ninguna modificación.
Ajustes opcionales para modificar el vídeo. Pueden permanecer desactivados en las tareas que dejan pasar la señal sin cambios.
Ajustes opcionales de superposición. El flujo de creación puede enviar explícitamente un objeto de superposición desactivado.
Determina si la tarea queda activa después de aprovisionarla.
Id de recurso que se devuelve al crear o listar el proceso de restream.
Alias práctico de _id.
Nombre guardado para la tarea de restream.
Objeto u objetos de entrada vinculados a la canalización, con sus relaciones cargadas.
Objeto u objetos de salida vinculados a la canalización, con sus relaciones cargadas.
Ajustes de procesamiento guardados en el objeto de la tarea.
Estado de activación actual de la tarea de restream.
Marcas de tiempo administradas por el backend.
El modelo incluye success: true como campo virtual en las respuestas correctas.