Multiview
Multiview supervisa entradas RTSP, SRT, RTMP y NDI en un mismo panel basado en navegador. Las cámaras RTSP y las URL de servidores de medios se pueden añadir directamente; no se requiere una etapa de conversión SRT o RTMP solo para mostrarlas.
Crea y actualiza un panel
Usa x-access-token para la gestión y las sesiones autenticadas de espectador. create guarda diseño, visibilidad y entradas iniciales; una lista vacía es válida. update aplica la lista completa de entradas y el diseño deseados, de modo que las entradas omitidas se desvinculan. Lee el objeto actual antes de reemplazar una lista que no esté vacía.
Inicia, únete e inspecciona
start y stop controlan la ejecución de monitorización. getAll, getCount y getById leen los paneles guardados. join devuelve una sesión de espectador autorizado; mantén su token de participante fuera de los registros y del almacenamiento persistente del navegador. Un panel puede estar disponible mientras una entrada esté offline, así que comprueba por separado el estado en directo de cada una.
El acceso público es deliberado
Cuando visibility es PUBLIC, cualquiera que tenga el ID de Multiview puede usar los métodos públicos de lectura, estadísticas y unión. Comparte los ID públicos solo con el alcance previsto y aplica límites de velocidad perimetrales a las uniones públicas. Añade un pipeline de procesamiento solo cuando una fuente necesite transcodificación, cambio de tamaño, cambios de audio o un protocolo de entrega distinto.
Crea un Multiview y, salvo que active sea false, inicia sus entradas y la conferencia. El usuario se obtiene del token de API; no envíes user_id.
Siguiente llamada: usa getById para consultar las entradas guardadas y después join para emitir un token de operador.
Los errores de validación devuelven { success: false, status, code, message, details } con estado 400.
Nombre obligatorio que se muestra a los operadores, de 1–120 caracteres.
Identificador opcional de la disposición. Callaba Engine usa 4-tiles de forma predeterminada.
Configuración opcional de superposición que se guarda con el muro de vídeo.
Definiciones opcionales de las entradas. Los tipos de fuente admitidos en ejecución incluyen RTSP directo y variantes SRT, RTMP y NDI; usa una matriz vacía si quieres crear el muro de vídeo antes de conectar las señales.
Valor opcional: PRIVATE o PUBLIC. El valor predeterminado es PRIVATE.
Estado inicial de ejecución opcional. Se considera activo salvo que se establezca explícitamente en false.
curl --request POST \
--url http://localhost/api/multiview/create \
--header 'x-access-token: <your_api_token>' \
--header 'Content-Type: application/json' \
--data '{
"name": "Master control multiview",
"layout_id": "4-tiles",
"visibility": "PRIVATE",
"overlay_settings": {},
"inputs": [],
"active": true
}'Identificador estable del recurso de multiview.
Nombre que se muestra al operador.
Disposición de mosaicos seleccionada, por ejemplo 4-tiles.
Entradas de vídeo normalizadas y sus vinculaciones en ejecución.
PRIVATE o PUBLIC.
Conferencia que proporciona la vista utilizada por el operador.
Indica si la instancia de multiview debe estar activa.
{
"_id": "6b0011223344556677889900",
"id": "6b0011223344556677889900",
"name": "Master control multiview",
"conference_id": "6b1011223344556677889900",
"layout_id": "4-tiles",
"visibility": "PRIVATE",
"overlay_settings": {},
"inputs": [
{
"id": "camera-a",
"name": "Camera A",
"source_kind": "INPUT_TYPE_SRT_SOFTWARE",
"source_id": "6b2011223344556677889900",
"participant_name": "Camera A",
"resolution": "1920x1080",
"video_codec": "libx264",
"video_bitrate": 1350,
"tile_index": 0,
"muted": false,
"hidden": false,
"volume": 1
}
],
"active": true,
"created": "2026-06-25T10:00:00.000Z",
"modified": "2026-06-25T10:00:01.000Z",
"success": true
}Ejemplos de flujos de trabajo y ayuda
Crear y gestionar un multiview de operación
Crea el mosaico con entradas verificadas, actualiza el diseño sin sustituir su identidad, inícialo y revisa el recurso guardado antes de compartir una sala pública.
- Crear el mosaicoDefine las fuentes, el diseño, la visibilidad y los ajustes del operador.
POST /api/multiview/create - Actualizar fuentes y diseñoEnvía el id existente con el estado completo de sala, fuentes, visibilidad y diseño que necesites.
POST /api/multiview/update - Iniciar el mosaicoInicia el multiview cuando sus recursos de entrada estén disponibles.
POST /api/multiview/start - Consultar el mosaico gestionadoConfirma las fuentes y la visibilidad desde el recurso autenticado antes de exponer un id público.
POST /api/multiview/getById - Consultar el estadoUsa la consulta pública solo para una sala intencionadamente pública.
POST /api/multiview-public/getStat
Trata el id de un multiview público como material de acceso compartible. Mantén los muros privados tras los métodos autenticados.
Ingerir una señal, supervisarla en Multiview y grabarla
Aprovisiona primero la ingesta SRT, conecta el id devuelto a un mosaico privado de Multiview y reutiliza la misma fuente estable en una grabación.
- Crear la ingestaConfigura listener, acceso, latencia y enrutamiento; conserva el id del servidor SRT.
POST /api/srt-servers/create - Iniciar la ingestaInicia el listener y confirma la conexión de la fuente antes de crear recursos downstream.
POST /api/srt-servers/start - Crear el mosaico privadoCrea la base de Multiview con diseño, visibilidad y overlays.
POST /api/multiview/create - Conectar el mosaico SRTAsigna el id del servidor SRT a source_id y usa el tipo de fuente SRT software documentado.
POST /api/multiview/update - Iniciar la supervisiónInicia el mosaico actualizado y accede mediante la ruta autenticada de operador.
POST /api/multiview/start - Crear el proceso de archivoSelecciona el mismo servidor mediante el preset SRT de grabación y elige formato y modo.
POST /api/recording/create - Iniciar la capturaInicia la grabación cuando la ingesta y el mosaico estén estables.
POST /api/recording/start - Verificar la capturaSupervisa bitrate, cadencia, tiempo de salida, velocidad y progreso de forma independiente.
POST /api/recording/getStat
Multiview se crea actualmente con una lista inputs vacía. Añade el mosaico SRT con update, usando INPUT_TYPE_SRT_SOFTWARE como source_kind y el id del servidor SRT como source_id. La creación de la grabación necesita su propio preset SRT; el id de Multiview no es un id de fuente de grabación.