Konfigurieren des Connectors für ONVIF

In Azure IoT Operations können Sie mit dem Connector für ONVIF eine ONVIF-konforme Kamera ermitteln und verwenden, die mit Ihrem Azure IoT Operations-Cluster verbunden ist.

Eine Ressource in Azure IoT Operations ist eine logische Entität, die Sie erstellen, um eine physische Ressource oder ein Gerät darzustellen. Ein Azure IoT Operations-Objekt kann benutzerdefinierte Eigenschaften, Datenpunkte, Datenströme und Ereignisse aufweisen, die sein Verhalten und seine Merkmale beschreiben. Ein Objekt ist einem oder mehreren Geräten zugeordnet. Azure IoT Operations speichert Objektdefinitionen in der Azure Device Registry.

Ein Gerät in Azure IoT Operations ist eine logische Entität, die die Verbindungen mit physischen Ressourcen oder Geräten definiert. Ohne ein Gerät können Daten nicht von einem physischen Gerät oder einer Ressource an den MQTT-Broker fließen. Wenn Sie ein Gerät und eine Anlage konfigurieren, wird eine Verbindung zu den physischen Anlagen oder Geräten hergestellt, und die Datenpunktwerte, Ereignisse und Datenströme gelangen in die Azure IoT Operations-Instanz. Ein Gerät verfügt über einen oder mehrere eingehende Endpunkte. Azure IoT Operations speichert Gerätedefinitionen in der Azure Device Registry.

Der Connector verbindet ONVIF-Kameras mit Ihrer Azure IoT Operations-Instanz und registriert sie in der Azure Device Registry. Der Verbinder ermittelt dann automatisch Folgendes:

• Die Funktionen, z. B. Schwenkneigungszoom (PTZ), des ONVIF-Geräts.
• Die Medienendpunkte, die vom ONVIF-Gerät verfügbar gemacht werden.
• Details zu den Mediendatenströmen wie Framerate, Auflösung und Codierung.

Nach der Registrierung der Kamera umfassen Beispiele für Verwaltungsvorgänge:

• Abrufen und Aktualisieren der Konfiguration der Kamera zum Anpassen der Ausgabebildkonfiguration.
• Steuerung von Schwenken, Neigen und Zoomen (PTZ) der Kamera.

Der Medienconnector kann auf die von diesen Kameras verfügbar gemachten Medienquellen zugreifen.

Zusammen ermöglichen Ihnen der Medienanschluss, der Anschluss für ONVIF, Azure IoT Einsatz und Begleitdienste die Verwendung von Azure IoT Einsatz zum Implementieren von Anwendungsfällen wie den folgenden:

• Warte- und Verweilzeitverfolgung, um die Zeit zu verfolgen, die Kunden in der Warteschlange verbringen.
• Bestellgenauigkeit, um nachzuverfolgen, dass die richtigen Bestellungen verpackt werden, indem Artikel mit POS-Beleg verglichen werden.
• Fehlererkennung und Qualitätssicherung durch Kameras, um Mängel in Produkten an der Montagelinie zu erkennen.
• Sicherheitsüberwachung wie Kollisionserkennung, Sicherheitszonenerkennung und Erkennung von persönlichen Sicherheitsgeräten.

In diesem Artikel wird beschrieben, wie Sie die Web-Benutzeroberfläche für das Operations-Management und die Azure CLI verwenden, um:

• Fügen Sie ein Gerät hinzu, das über einen ONVIF-Endpunkt für eine kompatible Kamera verfügt.
• Zeigen Sie die Objekte und Geräte an, die am ONVIF-Endpunkt ermittelt wurden.
• Erstellen Sie ein Gerät, das die Medienendpunkte darstellt, die von der ONVIF-Kamera verfügbar gemacht werden.
• Erstellen Sie eine Ressource, die Momentaufnahmen vom Medienendpunkt erfasst, und veröffentlicht sie im MQTT-Broker.

Der Connector für ONVIF unterstützt die folgenden Authentifizierungsmethoden:

• Benutzername/Kennwortauthentifizierung
• Anonymer Zugriff zu Testzwecken

Um eine TLS-Verbindung mit der ONVIF-Kamera herzustellen, können Sie eine Zertifikatvertrauensliste für den Connector konfigurieren.

Voraussetzungen

Eine bereitgestellte Instanz von Azure IoT Operations mit aktivierten Ressourcensynchronisierungsregeln. Um Ressourcensynchronisierungsregeln zu aktivieren, führen Sie den folgenden Befehl in Ihrer Azure IoT Operations-Instanz aus. Mit diesem Befehl werden auch die erforderlichen Berechtigungen für den benutzerdefinierten Speicherort festgelegt:

az iot ops enable-rsync -n <my instance> -g <my resource group>

Für die Anmeldung bei der Einsatz-Webbenutzeroberfläche benötigen Sie ein Microsoft Entra ID-Konto mit mindestens Mitwirkendenberechtigungen für die Ressourcengruppe, die Ihre Kubernetes – Azure Arc-Instanz enthält. Sie können sich nicht mit einem Microsoft-Konto (MSA) anmelden. Weitere Informationen finden Sie unter Problembehandlung beim Zugriff auf die Web-Oberfläche für den Betriebsablauf.

Eine ONVIF-kompatible Kamera, die Sie über Ihren Azure IoT Einsatz-Cluster erreichen können.

ONVIF-Kompatibilität

ONVIF verfügt über mehrere Kategorien für die Compliance, z. B. Ermittlung, Gerät, Medien, Imageerstellung, Analyse, Ereignisse und PTZ-Dienste (Pan-Tilt-Zoom). Weitere Informationen finden Sie unter ONVIF – Profile, Add-Ons und Spezifikationen.

Der Connector für ONVIF in Azure IoT Operations konzentriert sich auf die Unterstützung von Kamerageräten, die die folgenden Profile implementieren:

• Profil S für grundlegendes Videostreaming
• Profil T für erweitertes Videostreaming

Der Connector ermöglicht die Unterstützung für die folgenden Funktionen:

• Ermittlung von Geräteinformationen und -funktionen.
• Ereignisse von Geräten überwachen.
• Ermitteln der Medien-URIs, die von einem Gerät verfügbar gemacht werden. Der Konnektor für ONVIF stellt diese URIs für den Medienkonnektor zur Verfügung.
• Bildverarbeitungssteuerung wie Filter und Empfangen von Bewegungs- und Manipulationsereignissen.
• Steuern des Geräts PTZ.

Bereitstellen des Connectors für ONVIF

Wenn Sie Azure IoT Operations bereitstellen, umfasst die Bereitstellung verschiedene Connectors. Bevor Sie die Connectors (etwa ONVIF, Medien und HTTP/REST) auf der Einsatz-Webbenutzeroberfläche verwenden können, muss ein Admin Ihrer Azure IoT Einsatz-Instanz Connectorvorlageninstanzen hinzufügen.

Alle Connectors können erfasste Daten im MQTT-Broker veröffentlichen.

So fügen Sie Ihrer Azure IoT Operations-Instanz eine Connectorvorlageninstanz hinzu:

1. Wechseln Sie im Azure-Portal zu Ihrer Azure IoT Operations-Instanz, wählen Sie Connectorvorlagen aus, und wählen Sie dann Connectorvorlageninstanzen hinzufügen aus:

   

2. Wählen Sie auf der ersten Seite des Assistenten zum Hinzufügen einer Akri-Connectorvorlage den Typ und die Version der Connectorvorlage aus, die Sie hinzufügen möchten, z. B. ONVIF, Medien, HTTP/REST, SSE oder MQTT. Wählen Sie dann "Metadaten" aus.

   

3. Übernehmen Sie auf der Seite "Metadaten" die Standardwerte, und wählen Sie dann den Typ des eingehenden Endpunkts "Gerät" aus.

4. Akzeptieren Sie auf der Seite "Geräteeingangsendpunkttyp " die Standardwerte, und wählen Sie dann "Diagnosekonfigurationen" aus.

5. Übernehmen Sie auf der Seite "Diagnosekonfigurationen " die Standardwerte, und wählen Sie dann die Laufzeitkonfiguration aus.

6. Übernehmen Sie auf der Seite "Laufzeitkonfiguration " die Standardwerte, und wählen Sie dann "Überprüfen" aus.

7. Überprüfen Sie auf der Seite " Überprüfen " die Details der Connectorvorlageninstanz, und wählen Sie dann "Erstellen" aus, um die Connectorvorlageninstanz zu erstellen.

OT-Benutzer können nun die Einsatz-Webbenutzeroberfläche verwenden, um ein Gerät mit einem Connectorendpunkt zu erstellen.

Erstellen eines Geräts mit einem ONVIF-Endpunkt

Fügen Sie ein Gerät hinzu, das über einen ONVIF-Endpunkt für eine kompatible Kamera verfügt.

az iot ops ns device create -n onvif-connector-cli -g {your resource group name} --instance {your instance name}

az iot ops ns device endpoint inbound add onvif --device onvif-connector-cli -g {your resource group name} -i {your instance name}  --name onvif-connector-cli-0 --endpoint-address http://myonvifcam:2020/onvif/device_service

param aioNamespaceName string = '<AIO_NAMESPACE_NAME>'
param customLocationName string = '<CUSTOM_LOCATION_NAME>'

resource device 'Microsoft.DeviceRegistry/namespaces/devices@2025-10-01' = {
  name: 'onvif-connector'
  parent: namespace
  location: resourceGroup().location
  extendedLocation: {
    type: 'CustomLocation'
    name: customLocation.id
  }
  properties: {
    endpoints: {
      outbound: {
        assigned: {}
      }
      inbound: {
        'onvif-connector-0': {
          endpointType: 'Microsoft.Onvif'
          address: 'http://myonvifcam:2020/onvif/device_service'
        }
      }
    }
  }
}

Konfigurieren eines Geräts für die Verwendung eines Benutzernamens und Kennworts

Im vorherigen Beispiel wird der Authentifizierungsmodus Anonymous verwendet. Dieser Modus erfordert weder einen Benutzendennamen noch ein Kennwort.

Führen Sie die folgenden Schritte aus, um den Authentifizierungsmodus Username password zu verwenden:

Weitere Sicherheitsoptionen

Informationen zum Verwalten der Liste vertrauenswürdiger Zertifikate für den Connector für ONVIF finden Sie unter Verwalten von Zertifikaten für die externe Kommunikation.

Wenn Sie den eingehenden Endpunkt in der Betriebsumgebung erstellen, können Sie auch die folgenden Optionen auf der Registerkarte "Erweitert" auswählen:

Anzeigen der ermittelten Objekte und Geräte

Nachdem Sie ein Gerät mit einem ONVIF-Endpunkt erstellt haben, ermittelt der Connector für ONVIF automatisch die ONVIF-Ressourcen und Mediengeräte, die am Endpunkt verfügbar sind. Um die ermittelten Objekte und Geräte in der Einsatz-Benutzeroberfläche anzuzeigen, wählen Sie im linken Navigationsbereich Ermittlung aus:

• Wählen Sie „Importieren und Asset erstellen“ aus dem ermittelten ONVIF-Asset aus, um ein Asset zu erstellen, das die Fähigkeiten der ONVIF-konformen Kamera darstellt. Sie können z. B. eine Ressource erstellen, die Ereignisse von der ONVIF-Kamera erfasst, oder Sie können die ONVIF-Kamera steuern. Weitere Informationen finden Sie im Abschnitt Erstellen einer ONVIF-Ressource für die Ereignisverwaltung und -steuerung.

• Wählen Sie Importieren und Gerät erstellen vom ermittelten ONVIF-Gerät, um ein Gerät zu erstellen, das eine Verbindung zu den Medienendpunkten herstellt, die von der ONVIF-kompatiblen Kamera verfügbar gemacht werden. Nachdem Sie das Mediengerät erstellt haben, können Sie Medienressourcen erstellen, die Momentaufnahmen oder Videostreams von den Medienendpunkten erfassen. Weitere Informationen finden Sie im Abschnitt "Erstellen eines Geräts mit Medienendpunkten".

Erstellen eines Geräts mit Medienendpunkten

Führen Sie die folgenden Schritte aus, um ein Gerät mit Medienendpunkten vom ermittelten Gerät zu erstellen:

1. Wählen Sie in der Einsatz-Benutzeroberfläche im linken Navigationsbereich die Option Ermittlung aus. Wählen Sie dann Ermittelte Geräte aus.

2. Wählen Sie das gefundene Mediengerät aus, z. B. my-onvif-camera. Wählen Sie dann Importieren und Gerät erstellen aus.

3. Auf der Seite "Gerätedetails " werden alle ermittelten Medien-eingehenden Endpunkte angezeigt. Geben Sie einen Namen für das Gerät ein, z. B. my-onvif-camera-media und wählen Sie eine Authentifizierungsmethode für jeden Endpunkt aus:

   

   Tipp

   Sie können einen eingehenden Endpunkt entfernen, den Sie nicht benötigen, indem Sie ihn auswählen und dann den eingehenden Endpunkt entfernen.

   Wählen Sie dann Weiter aus.

4. Auf der Seite " Benutzerdefinierte Eigenschaft hinzufügen " können Sie die ermittelten Eigenschaften sehen. Optional können Sie dem Gerät benutzerdefinierte Eigenschaften aktualisieren, entfernen oder hinzufügen. Wählen Sie Weiter aus, wenn Sie fertig sind.

5. Überprüfen Sie auf der Seite Zusammenfassung die Details des Geräts. Wählen Sie Erstellen aus, um das Gerät zu erstellen. Nach ein paar Minuten zeigt die Seite "Geräte" das neue Mediengerät an.

   

Erstellen einer Medienressource zum Erfassen von Momentaufnahmen

Sie können nun das ermittelte Mediengerät verwenden, um eine Ressource zu erstellen, die Momentaufnahmen von der Kamera erfasst und im MQTT-Broker veröffentlicht. Führen Sie die folgenden Schritte aus, um die Medienressource zu erstellen:

1. Wählen Sie in der Einsatz-Benutzeroberfläche im linken Navigationsbereich die Option Objekte aus. Wählen Sie dann Asset erstellen aus.

2. Geben Sie auf der Seite Objektdetails einen Namen für die Ressource ein, z. B. my-onvif-camera-media-asset. Wählen Sie dann den ermittelten Endpunkt aus, den Sie zum Erfassen von Momentaufnahmen verwenden möchten.

   

   Aktualisieren Sie alle benutzerdefinierten Eigenschaften für die Medienressource, und wählen Sie dann Weiter aus.

3. Wählen Sie auf der Seite Streams die Option Stream hinzufügen aus. Verwenden Sie die folgenden Einstellungen, um einen Beispieldatenstrom zu konfigurieren, der Snapshots im MQTT-Broker veröffentlicht:

   • Streamname: myassetvideo
   • Ziel: MQTT
   • Thema: myassetvideo
   • Aufgabentyp: snapshot-to-mqtt

   Tipp

   Das hier ausgewählte Thema wird automatisch unter azure-iot-operations/data/<asset-name>/ geschachtelt, wenn der Anschluss für ONVIF die Momentaufnahmen an den MQTT-Broker übermittelt.

   Behalten Sie die übrigen Standardeinstellungen bei. Wählen Sie dann Hinzufügen aus. Der Datenstrom wird der Ressourcenkonfiguration hinzugefügt:

   

4. Wählen Sie "Weiter" aus, um zur Seite " Überprüfen " zu wechseln. Überprüfen Sie die Details der Ressource, und wählen Sie dann Erstellen aus, um die Ressource zu erstellen. Nach ein paar Minuten zeigt die Seite Objekte das neue Objekt an.

   

Die Medienressource ist jetzt so konfiguriert, dass Momentaufnahmen von der ONVIF-kompatiblen Kamera aufgenommen und im MQTT-Broker veröffentlicht werden.

Erstellen einer ONVIF-Ressource für die Ereignisverwaltung und -steuerung

ONVIF-kompatible Kameras können Ereignisse wie die Bewegungserkennung generieren und auf Steuerungsbefehle wie Schwenken, Neigen und Zoom reagieren. Sie können eine ONVIF-Ressource aus dem ermittelten ONVIF-Gerät erstellen, das diese Ereignisse erfasst und es Ihnen ermöglicht, die Kamera zu steuern.

Nachdem Sie ein ONVIF-Gerät in der Einsatz-Benutzeroberfläche hinzugefügt haben, wird automatisch eine ermittelte ONVIF-Ressource erstellt:

So erstellen Sie eine ONVIF-Ressource für die Ereignisverwaltung und -steuerung:

1. Wählen Sie das ermittelte Objekt aus, und wählen Sie dann Importieren und Ressource erstellen aus.

2. Geben Sie auf der Seite Ressourcendetails einen Namen und eine Beschreibung für die Ressource ein. Der eingehende Endpunkt des Geräts ist bereits für Sie ausgewählt, und die benutzerdefinierten Eigenschaften werden aus der ermittelten Ressource vorab aufgefüllt:

   

   Klicken Sie auf Weiter, um fortzufahren.

3. Wählen Sie auf der Seite "Ereignisgruppen " die Ereignisgruppe aus, um die ermittelten Ereignisse zu überprüfen. Sie können alle Ereignisse entfernen, die Sie nicht verwenden möchten:

   

4. Konfigurieren Sie für jede von Ihnen beibehaltene Ereignisgruppe das MQTT-Thema, das für die Veröffentlichung verwendet wird:

   

   Klicken Sie auf Weiter, um fortzufahren.

5. Konfigurieren Sie auf der Seite "Verwaltungsgruppen " die Aktionen wie Schwenken, Neigen und Zoomen, die Sie zum Steuern der ONVIF-Kamera verwenden möchten.

   

   Weitere Informationen zum Konfigurieren von Verwaltungsgruppen finden Sie unter Verwalten und Steuern der Kamera.

   Klicken Sie auf Weiter, um fortzufahren.

6. Überprüfen Sie die Zusammenfassung der ONVIF-Ressourcenkonfiguration, und wählen Sie dann Erstellen aus, um die Ressource zu erstellen. Nach ein paar Minuten zeigt die Seite Objekte das neue Objekt an.

Verwalten und Steuern der Kamera

Um mit der ONVIF-Kamera zu interagieren, können Sie MQTT-Nachrichten veröffentlichen, die der Anschluss für ONVIF abonniert. Das Nachrichtenformat basiert auf den Spezifikationen der ONVIF-Netzwerkschnittstelle.

Der Azure IoT Operations Connector für die ONVIF PTZ-Demo-Anwendung zeigt, wie Sie den Connector für ONVIF verwenden:

• Verwenden Sie die Medienobjektdefinition, um ein Profiltoken aus dem Mediendienst der Kamera abzurufen.
• Verwenden Sie das Profiltoken, wenn Sie die PTZ-Funktionen der Kamera verwenden, um ihre Position und Ausrichtung zu steuern.

Die Beispielanwendung verwendet den Azure IoT Operations MQTT-Broker, um Befehle zu senden, um mit dem Connector für ONVIF zu interagieren. Weitere Informationen finden Sie unter Veröffentlichen und Abonnieren von MQTT-Nachrichten mithilfe des MQTT-Brokers.