Documentación de Callaba Engine
Usa la API de Callaba Engine para automatizar flujos de vídeo en directo de principio a fin: recibe señales SRT o RTMP, enrútalas o transcodifícalas, grábalas y publica la reproducción en el navegador. Elige la sección que corresponda a la tarea que quieres automatizar.
Elige este módulo cuandoConoces el resultado de vídeo, pero no sabes qué recurso de Callaba debes crear.
Usa otro módulo cuandoAbre directamente un módulo si ya sabes qué recurso es responsable de la tarea.
Elige un módulo según el resultado
| Objetivo | Empieza por | Añade después | Elige otra opción cuando |
|---|---|---|---|
| Recibir OBS u otro emisor RTMP | Servidores RTMP | Grabación, Retransmisión o Reproductor web | La fuente envía SRT en lugar de RTMP |
| Recibir una señal SRT resiliente | Servidores SRT | Multiview, Grabación o Retransmisión | Solo necesitas reenviar SRT sin modificar la señal |
| Enviar una fuente en directo a plataformas o a otro protocolo | Retransmisiones | Reproductor web o Grabación | La entrega continúa por SRT y no requiere procesamiento |
| Supervisar varias señales en directo a la vez | Multiview | Failover SRT o Grabación | La página está dirigida a la audiencia y no a operadores |
| Convertir una fuente en directo en un archivo | Grabaciones | Archivos y Almacenamientos | El contenido ya existe como archivo |
| Publicar reproducción en el navegador | Reproductores web | Grupos de reproductores web | Los operadores necesitan un multiviewer |
| Incorporar invitados remotos a la producción | Videollamadas | Adaptador NDI o Grabación | El colaborador envía la señal desde un encoder |
Antes de empezar
- Despliega o inicia una instancia de Callaba Engine y anota su URL base.
- Crea un token de API en Ajustes generales.
- Envía el token en la cabecera
x-access-tokena través de HTTPS. - Mantén el token en el backend o en otro entorno de confianza.
Qué puedes hacer
- Ingesta: recibe señales con servidores SRT, servidores RTMP, streams o videollamadas.
- Enrutamiento y procesamiento: usa rutas SRT, retransmisiones, adaptadores NDI y grabaciones.
- Almacenamiento y entrega: gestiona archivos y almacenamientos y publica el resultado con reproductores web o grupos de reproductores.
- Operación: inicia, detén, actualiza, elimina y consulta estadísticas de ejecución cuando el módulo las ofrezca.
Flujo de ejemplo
- Crea un servidor SRT o RTMP para la señal de contribución.
- Crea una grabación o retransmisión que use ese servidor como entrada.
- Crea un reproductor web si el resultado debe verse en un navegador.
- Inicia los recursos en el orden de sus dependencias y comprueba su estado de ejecución.
- Detén los procesos downstream antes de eliminar el recurso de ingesta.
Casos de uso habituales
- Preparar contribución, grabación y reproducción repetibles para eventos recurrentes.
- Conectar una plataforma de reservas, una sala de control o un portal de clientes con las operaciones de vídeo en directo.
- Gestionar varias instancias de Callaba con la misma lógica de despliegue y supervisión.
Límites y resolución de problemas
Valida los identificadores, valores enum, puertos y objetos anidados obligatorios antes de enviar una solicitud. Guardar un recurso no demuestra que su proceso multimedia funcione correctamente: comprueba las estadísticas de ejecución después de iniciarlo. Respeta las dependencias; una entrada deja de funcionar si su recurso upstream se detiene o se elimina.
Siguientes pasos
Consulta Instalación o inicio instantáneo y después Autorización. A continuación, abre el módulo que corresponda a la primera etapa de tu flujo.
Combinar ingesta, monitorización, grabación y entrega
Construye un plano de control en orden de dependencias: recibe la contribución, muéstrala a operadores, grábala y crea salidas observables por separado para cada destino.
- Crear la ingesta de contribuciónDefine listener, latencia, política de acceso y hosts principal/respaldo aprobados.
POST /api/srt-servers/create - Iniciar y verificar la fuenteDeja estable el límite upstream antes de iniciar cualquier recurso dependiente.
POST /api/srt-servers/start - Crear la monitorizaciónAñade la fuente verificada a un diseño autenticado de operación.
POST /api/multiview/create - Iniciar el muro de operaciónVerifica visualmente la contribución antes de abrir las ramas de captura y entrega.
POST /api/multiview/start - Crear la rama de archivoVincula el preset SRT documentado con el formato y la retención necesarios.
POST /api/recording/create - Iniciar la capturaInicia el archivo cuando la monitorización confirme que el medio es utilizable.
POST /api/recording/start - Crear cada rama de entregaCrea un proceso por destino con solo el remuxing o transcodificación necesarios.
POST /api/restream/create - Iniciar la entrega downstreamInicia las salidas por separado para que un destino no bloquee los demás.
POST /api/restream/start - Observar cada salidaCompara estado, bitrate y cadencia por rama durante el evento.
POST /api/restream/getStat
Los ids de módulos no son intercambiables. Usa el preset y source_id exactos de cada método downstream, inicia primero las dependencias y revierte solo la rama fallida.
Recibir SRT, grabarlo y publicarlo para reproducción web
Combina ingesta, control de rutas, grabación y reproducción web en una sola API de Callaba. Construye en orden de dependencias y amplía el flujo con almacenamiento, multiview o restream en cloud o self-hosted.
- Crear la ingesta SRTConfigura el listener, la latencia, las reglas de acceso y el enrutamiento de la fuente.
POST /api/srt-servers/create - Iniciar y verificar la ingestaInicia el servidor antes de crear procesos que dependan de su entrada en directo.
POST /api/srt-servers/start - Crear el proceso de archivoElige el preset de entrada del servidor SRT y la salida continua o segmentada necesaria.
POST /api/recording/create - Iniciar la grabaciónInicia la captura solo cuando la entrada de contribución esté estable.
POST /api/recording/start - Crear la entrega para navegadorUsa el preset de entrada del servidor SRT y configura HLS o DASH junto con el acceso de los espectadores.
POST /api/vod/create - Iniciar y probar la reproducciónInicia el reproductor, comprueba su estado y prueba la URL para espectadores.
POST /api/vod/start
Cada respuesta de creación devuelve el id de recurso que necesita su llamada de inicio. Usa el preset de entrada documentado por el módulo downstream y no lo sustituyas por un id de otro tipo de recurso.
Llevar un servicio religioso de la ingesta al multistreaming, la grabación y la reproducción
Crea un flujo repetible en orden de dependencias: recibe la señal, inicia cada destino, conserva el servicio y publica la reproducción web.
- Crear la ingesta del servicioConfigura el punto de entrada RTMP que utilizará el encoder de la iglesia.
POST /api/rtmp-servers/create - Iniciar y verificar la ingestaInicia el servidor antes de conectar el encoder y confirma que la fuente está estable.
POST /api/rtmp-servers/start - Crear cada destino de plataformaCrea un restream por plataforma desde la entrada de programa verificada.
POST /api/restream/create - Iniciar la distribución multistreamInicia los destinos por separado para que una plataforma no oculte el estado de otra.
POST /api/restream/start - Crear la grabación del servicioVincula una grabación a la misma fuente de programa aprobada.
POST /api/recording/create - Iniciar la captura del archivoInicia la captura cuando la ingesta sea estable y conserva el id de grabación devuelto.
POST /api/recording/start - Crear la reproducción para la web de la iglesiaConfigura el reproductor web y el acceso previsto para espectadores.
POST /api/vod/create - Iniciar y probar la reproducciónInicia el reproductor y prueba la URL para espectadores antes de publicarla.
POST /api/vod/start
Crea e inicia cada recurso con el id devuelto por su propio módulo. Verifica la entrada antes de activar destinos, grabación o reproducción.
Llevar un evento deportivo de la monitorización al paywall y al replay
Compón un flujo de recinto que mantenga el programa visible, grabe el evento, publique la reproducción web e inicie el acceso controlado por grupo.
- Crear la ingesta del recintoConfigura el punto de entrada RTMP para el programa aprobado del evento.
POST /api/rtmp-servers/create - Iniciar la ingesta del programaInicia el servidor y confirma la contribución antes de crear recursos downstream.
POST /api/rtmp-servers/start - Crear la monitorización del operadorAñade el programa y las salidas críticas a un Multiview del evento.
POST /api/multiview/create - Iniciar la vista de operaciónInicia el mural y verifica cada fuente necesaria antes de abrir el acceso.
POST /api/multiview/start - Crear la grabación del eventoConfigura la captura desde la entrada de programa aprobada.
POST /api/recording/create - Iniciar la captura del eventoInicia la grabación cuando la contribución y la monitorización estén estables.
POST /api/recording/start - Finalizar la grabaciónDetén la captura de forma controlada cuando termine el evento.
POST /api/recording/stop - Consultar el medio de replayConsulta recordedFiles de la grabación finalizada antes de crear el replay.
POST /api/recording/getById - Crear la reproducción del eventoConfigura el reproductor live o replay con los ajustes de acceso previstos.
POST /api/vod/create - Iniciar la reproducciónInicia el reproductor y verifica su URL y estado de ejecución.
POST /api/vod/start - Crear el acceso controladoAgrupa el reproductor bajo la política revisada de paywall o acceso.
POST /api/vod-group/create - Iniciar el grupo de accesoInicia el grupo cuando la reproducción y las comprobaciones externas estén listas.
POST /api/vod-group/start
Detén y consulta la grabación antes de usarla como replay. Un grupo controla el acceso a reproductores configurados; no sustituye la validación externa de pagos o derechos.