media server logo
PreiseAnmeldenLaunch NDI streamingEmpfohlene Region: Frankfurt.
API-DokumentationÜbersicht
Erkannte NDI-Geräte
NDI-Adapter
NDI-Konfiguration
Multiview
Videoanrufe
Dokumentationsnavigation ein- oder ausblenden
Callaba-Startseite

Erkannte NDI-Geräte

Verwenden Sie Erkannte NDI-Geräte, um die NDI-Quellen zu finden, die für diese Callaba-Instanz derzeit sichtbar sind, und den Aktivitätsstatus jeder Quelle zu prüfen.

FunktionNDI-Quelle im Netzwerk finden

Geeignet, wennSie möchten sehen, welche NDI-Quellen diese Engine aktuell erkennt.

Anderes Modul verwenden, wennVerwenden Sie die NDI-Konfiguration für Discovery-Einstellungen oder NDI-Adapter, um eine Callaba-Quelle als NDI auszugeben.

1Geräte erkennen2Quelle prüfen3Gerät auswählen
POST /api/devices/getAll
6 Endpunkte

Voraussetzungen

Alle Methoden erfordern einen gültigen x-access-token. Konfigurieren Sie zuerst die NDI-Schnittstellen und Discovery-Server der Engine.

Funktionen

  • sync aktualisiert das Geräteinventar aus aktuellen Entdeckungsergebnissen.
  • getAll, getCount und getById prüfen erkannte Einträge.
  • update ändert unterstützte Datensatzfelder.
  • getStat meldet, ob ein Gerät gerade entdeckt wird.
  • remove löscht einen veralteten gespeicherten Geräteeintrag.

Beispiel-Workflow

  1. Führen Sie sync aus, nachdem alle erwarteten Sender online sind.
  2. Listen Sie Geräte auf und passen Sie ihre NDI-Namen mit dem Produktionsplan ab.
  3. Rufen Sie getStat für jeden Eintrag auf, der nur zeitweise erscheint.
  4. Entfernen Sie gespeicherte Einträge für außer Betrieb genommene oder umbenannte Sender.

Typische Anwendungsfälle

  • Validieren Sie den Kamera- und Grafik-Patch vor einer Show.
  • Unterscheiden Sie einen aktiven Sender von einem veralteten gespeicherten Geräteeintrag.
  • Entfernen Sie temporäre Veranstaltungsgeräte aus der Discovery-Liste.

Einschränkungen und Fehlerbehebung

Ein gespeicherter Geräteeintrag belegt nicht, dass der Sender aktuell erreichbar ist; verwenden Sie getStat. Fehlende Quellen können durch die Schnittstellenauswahl, die Erreichbarkeit des Discovery Servers, das Routing, Firewall-Regeln oder die Senderkonfiguration verursacht werden. Das Entfernen eines Eintrags stoppt den NDI-Sender nicht.

Nächste Schritte

Erstellen Sie einen NDI-Adapter, wenn eine verwaltete Callaba-Quelle als benannte NDI-Ausgabe veröffentlicht werden muss.

REST-Lösungsrezept

Erkannte NDI-Quellen inventarisieren

Listen Sie erkannte Geräte auf, wählen Sie die Quelle per ID und prüfen Sie ihre Discovery-Aktivität vor dem Adapter.

  1. NDI-Quellen auflistenLesen Sie das aktuelle Inventar erkannter Geräte.POST /api/devices/getAll
  2. Aktivität prüfenPrüfen Sie den Discovery-Status vor der Downstream-Nutzung.POST /api/devices/getStat

Discovery spiegelt die aktuelle Netzwerksicht. Prüfen Sie Quellenname, Adresse und Verfügbarkeit im Produktionssegment.

Callaba-NDI-Produkt öffnenLive-Operator-Demo öffnen
POST
/api/devices/getAll
API-Token erforderlich

Verwenden Sie Alle erkannten Geräte abrufen, um die der Callaba Engine bekannten NDI-Quellen aufzulisten.

Filtern Sie die Liste bei Bedarf nach Gerätetyp und rufen Sie sie erneut ab, wenn eine Operator-Ansicht die neuesten Discovery-Ergebnisse anzeigen soll.

Parameter im Request-Body
limit
integer
Direktlink kopieren

Optionale Seitengröße für die Geräteliste.

skip
integer
Direktlink kopieren

Optionaler Offset für die paginierte Liste.

sort
object
Direktlink kopieren

Die Benutzeroberfläche verwendet { created: 1 }.

filter
object
Direktlink kopieren

Betreiberseitige NDI-Listenaufrufe filtern normalerweise nach type: DEVICE_TYPE_NDI.

Alle erkannten NDI-Geräte abrufen
Code kopieren
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"
  }
}'
Antwort
array of discovered device objects
array
Direktlink kopieren

Das Backend gibt ein einfaches Array von gespeicherten Einträgen erkannter Geräte zurück.

discovered_last_time
string
Direktlink kopieren

Zeitstempel der letzten Aktualisierung dieses Geräts durch die NDI-Erkennung.

Antwort: Alle erkannten NDI-Geräte abrufen
JSON
Code kopieren
[
  {
    "_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
API-Token erforderlich
POST
/api/devices/getById
API-Token erforderlich
POST
/api/devices/getStat
API-Token erforderlich
POST
/api/devices/update
API-Token erforderlich
DELETE
/api/devices/remove
API-Token erforderlich
Zurück zuSRT-RoutenWeiter zuNDI-Adapter