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

Dispositivos NDI detectados

Usa Dispositivos NDI detectados para encontrar las fuentes NDI visibles actualmente para esta instancia de Callaba y comprobar si cada una está activa.

Qué haceEncontrar una fuente NDI en la red

Elige este módulo cuandoNecesitas saber qué fuentes NDI detecta actualmente esta instancia de Engine.

Usa otro módulo cuandoUsa Configuración NDI para cambiar el descubrimiento; usa Adaptadores NDI para publicar una fuente de Callaba como NDI.

1Detecta dispositivos2Revisa la fuente3Selecciona el dispositivo
POST /api/devices/getAll
6 endpoints

Antes de empezar

Todos los métodos requieren un x-access-token válido. Configura primero las interfaces NDI y los servidores de descubrimiento de Engine.

Qué puedes hacer

  • sync actualiza el inventario de dispositivos con los resultados de descubrimiento actuales.
  • getAll, getCount y getById consultan las entradas detectadas.
  • update modifica los campos compatibles del registro.
  • getStat indica si un dispositivo está detectado en ese momento.
  • remove elimina una entrada guardada obsoleta.

Flujo de ejemplo

  1. Ejecuta sync cuando todos los emisores previstos estén online.
  2. Enumera los dispositivos y compara sus nombres NDI con el plan de producción.
  3. Llama a getStat para cualquier entrada que aparezca de forma intermitente.
  4. Elimina las entradas guardadas de emisores retirados o renombrados.

Casos de uso habituales

  • Validar el patch de cámaras y gráficos antes de un programa.
  • Distinguir un emisor activo de una entrada antigua guardada.
  • Eliminar de la lista de descubrimiento los dispositivos temporales de un evento.

Límites y resolución de problemas

Una entrada guardada no demuestra que el emisor sea accesible ahora; usa getStat. Una fuente puede faltar por la selección de interfaces, la conectividad con el servidor de descubrimiento, el enrutamiento, el firewall o la configuración del emisor. Eliminar una entrada no detiene el emisor NDI.

Siguientes pasos

Crea un Adaptador NDI cuando necesites publicar una fuente gestionada por Callaba como una salida NDI con nombre propio.

Receta de solución REST

Inventariar fuentes NDI detectadas

Lista los dispositivos, selecciona la fuente por id y revisa su actividad antes de crear un adaptador.

  1. Listar fuentes NDIConsulta el inventario actual de dispositivos.POST /api/devices/getAll
  2. Comprobar actividadRevisa el estado antes de usar la fuente downstream.POST /api/devices/getStat

El descubrimiento refleja la vista actual de red. Confirma nombre, dirección y disponibilidad en el segmento de producción.

POST
/api/devices/getAll
Requiere token de API

Usa Listar dispositivos detectados para consultar las fuentes NDI conocidas por Callaba Engine.

Aplica un filtro por tipo cuando sea necesario y actualiza la lista para reflejar cambios recientes en el descubrimiento.

Parámetros del cuerpo de la solicitud
limit
integer
Copiar enlace directo

Tamaño de página opcional para la lista de dispositivos.

skip
integer
Copiar enlace directo

Desplazamiento opcional para recorrer la lista paginada.

sort
object
Copiar enlace directo

Criterio de ordenación opcional. La interfaz usa { created: 1 }.

filter
object
Copiar enlace directo

Las consultas de la lista NDI para operadores suelen filtrarse por type: DEVICE_TYPE_NDI.

Listar dispositivos detectados
Copiar código
curl --request POST \
--url http://localhost/api/devices/getAll \
--header 'x-access-token: <your_api_token>' \
--header 'Content-Type: application/json' \
--data '{
"limit": 10,
"skip": 0,
"sort": {
"created": 1
},
"filter": {
"type": "DEVICE_TYPE_NDI"
}
}'
Respuesta
array of discovered device objects
array
Copiar enlace directo

El backend devuelve directamente una matriz con los registros guardados de dispositivos detectados.

discovered_last_time
string
Copiar enlace directo

Marca de tiempo de la última actualización de este dispositivo realizada por el servicio de detección.

Respuesta: Listar dispositivos detectados
JSON
Copiar código
[
{
"_id": "67f100000000000000000001",
"id": "67f100000000000000000001",
"name": "Studio Camera A",
"type": "DEVICE_TYPE_NDI",
"ndi_name": "Studio Camera A",
"url_address": "192.168.10.41:5960",
"created": "2026-03-24T10:00:00.000Z",
"discovered_last_time": "2026-03-24T10:00:05.000Z",
"success": true
}
]
POST
/api/devices/getCount
Requiere token de API
POST
/api/devices/getById
Requiere token de API
POST
/api/devices/getStat
Requiere token de API
POST
/api/devices/update
Requiere token de API
DELETE
/api/devices/remove
Requiere token de API