media server logo
Mostrar u ocultar la navegación
Inicio de Callaba

Configuración NDI

Usa Configuración NDI para seleccionar las interfaces de red y los servidores de descubrimiento que Callaba utiliza para encontrar y publicar fuentes NDI.

Qué haceConfigurar el descubrimiento NDI

Elige este módulo cuandoNecesitas elegir interfaces o servidores de descubrimiento NDI, especialmente entre redes enrutadas.

Usa otro módulo cuandoUsa Dispositivos NDI detectados para consultar fuentes; no cambies el descubrimiento global solo para seleccionar una.

1Define la red2Aplica el descubrimiento3Comprueba las fuentes
POST /api/devices/updateNDIConfiguration

Antes de empezar

El método de actualización requiere un x-access-token válido. Debes conocer las direcciones de las interfaces, el nombre de la máquina y las direcciones de los servidores de descubrimiento accesibles desde el host de Engine.

Qué puedes hacer

update aplica a la instancia el nombre de máquina NDI, las interfaces IP seleccionadas y la configuración de los servidores de descubrimiento.

Flujo de ejemplo

{
  "machine_name": "Callaba Studio Gateway",
  "ip_addresses": ["192.168.10.20"],
  "discovery_servers": ["192.168.10.10"]
}
  1. Aplica la configuración con una interfaz accesible desde la red NDI.
  2. Sincroniza Dispositivos NDI detectados.
  3. Confirma que aparecen los emisores previstos y que informan de actividad actual.

Casos de uso habituales

  • Asignar una identidad NDI predecible a un gateway de estudio.
  • Restringir el tráfico NDI a la interfaz de producción de un host con varias interfaces.
  • Acceder a emisores de redes enrutadas mediante un servidor de descubrimiento NDI.

Límites y resolución de problemas

Una interfaz o un servidor de descubrimiento inaccesibles impiden que aparezcan las fuentes previstas. También se aplican el enrutamiento de red, la política multicast, la compatibilidad de versiones NDI y las reglas del firewall del host. Repite el descubrimiento después de cada cambio de red.

Siguientes pasos

Abre Dispositivos NDI detectados para comprobar la visibilidad y crea después un Adaptador NDI para una salida gestionada.

Receta de solución REST

Configurar el descubrimiento NDI para la red prevista

Aplica la configuración de descubrimiento revisada y confirma después el inventario en el módulo de dispositivos.

  1. Aplicar ajustes de descubrimientoEnvía la configuración revisada para la red de la instancia.POST /api/devices/updateNDIConfiguration
  2. Verificar fuentes detectadasConfirma que aparece solo el inventario esperado.POST /api/devices/getAll

Siguen aplicándose visibilidad de red, multicast y controles NDI. Guardar la configuración no garantiza el descubrimiento entre segmentos.

POST
/api/devices/updateNDIConfiguration
Requiere token de API

Usa Actualizar la configuración NDI para aplicar ajustes globales como el nombre del equipo, servidores de descubrimiento, IP de red explícitas o una configuración JSON completa.

Una sola operación puede cambiar cómo se comporta toda la instancia en el entorno NDI, no solo un elemento de una lista.

Úsala para definir un descubrimiento NDI coherente y conservarlo después de guardar.

Configuración global de la aplicación

Usa esta opción cuando basten los campos visibles del formulario y quieras mantener el editor JSON sincronizado con sus valores.

Actualización desde el formulario

Reproduce el flujo habitual de la interfaz, que mantiene alineados los cambios del formulario y del JSON antes de guardar.

Actualización desde el formulario
Copiar código
curl --request POST \
--url http://localhost/api/devices/updateNDIConfiguration \
--header 'x-access-token: <your_api_token>' \
--header 'Content-Type: application/json' \
--data '{
"machinename": "CALLABA CLOUD STUDIO",
"ips": "192.168.10.41, 192.168.10.52",
"discovery": "192.168.10.20:5959",
"json": {
"ndi": {
"machinename": "CALLABA CLOUD STUDIO",
"networks": {
"discovery": "192.168.10.20:5959",
"ips": "192.168.10.41, 192.168.10.52"
}
}
}
}'
Actualización mediante JSON completo

Corresponde al flujo de edición en vivo e importación de la interfaz.

Actualización mediante JSON completo
Copiar código
curl --request POST \
--url http://localhost/api/devices/updateNDIConfiguration \
--header 'x-access-token: <your_api_token>' \
--header 'Content-Type: application/json' \
--data '{
"machinename": "CALLABA CLOUD STUDIO",
"ips": "192.168.10.41, 192.168.10.52",
"discovery": "192.168.10.20:5959, 192.168.10.21:5959",
"json": {
"ndi": {
"machinename": "CALLABA CLOUD STUDIO",
"networks": {
"discovery": "192.168.10.20:5959, 192.168.10.21:5959",
"ips": "192.168.10.41, 192.168.10.52"
}
}
}
}'
Parámetros del cuerpo de la solicitud
Campos del formulario
machinename
string
Copiar enlace directo

Etiqueta en el panel: Nombre de la máquina.

Valor opcional que sustituye el nombre de máquina anunciado en la red NDI.

discovery
string
Copiar enlace directo

Etiqueta en el panel: Detección.

Lista de servidores de detección separados por comas. La ayuda de la interfaz permite incluir explícitamente números de puerto en los valores.

ips
string
Copiar enlace directo

Etiqueta en el panel: IP de red.

Lista de direcciones IP de origen explícitas, separadas por comas, para detectar dispositivos entre subredes.

Editor JSON
json
object
Copiar enlace directo

Modelo del editor JSON en vivo. La interfaz mantiene este objeto sincronizado con los campos visibles del formulario y con los archivos de configuración importados.

Actualizar configuración NDI
Copiar código
curl --request POST \
--url http://localhost/api/devices/updateNDIConfiguration \
--header 'x-access-token: <your_api_token>' \
--header 'Content-Type: application/json' \
--data '{
"machinename": "CALLABA CLOUD STUDIO",
"ips": "192.168.10.41, 192.168.10.52",
"discovery": "192.168.10.20:5959",
"json": {
"ndi": {
"machinename": "CALLABA CLOUD STUDIO",
"networks": {
"discovery": "192.168.10.20:5959",
"ips": "192.168.10.41, 192.168.10.52"
}
}
}
}'
Respuesta
Resultado de la operación
success
boolean
Copiar enlace directo

El backend devuelve { success: true } después de validar, escribir y aplicar la configuración NDI actualizada.

Aplicación de cambios
side effects
config write + apply path
Copiar enlace directo

El backend escribe la configuración compilada, guarda ndi_settings en el objeto de la aplicación y activa la ruta de entrada y aplicación con la que Callaba Engine adopta el nuevo comportamiento NDI.

Respuesta: Actualizar configuración NDI
JSON
Copiar código
{
"success": true
}