Konfigurera anslutningsappen för ONVIF (förhandsversion)

I Azure IoT Operations gör anslutningsappen för ONVIF (förhandsversion) att du kan identifiera och använda en ONVIF-kompatibel kamera som är ansluten till ditt Azure IoT Operations-kluster.

En tillgång i Azure IoT Operations är en logisk entitet som du skapar för att representera en fysisk tillgång eller enhet. En Azure IoT Operations-tillgång kan ha anpassade egenskaper, datapunkter, strömmar och händelser som beskriver dess beteende och egenskaper. En tillgång är associerad med en eller flera enheter. Azure IoT Operations lagrar tillgångsdefinitioner i Azure Device Registry.

En enhet i Azure IoT Operations är en logisk entitet som definierar anslutningarna till fysiska tillgångar eller enheter. Utan en enhet kan data inte flöda från en fysisk enhet eller tillgång till MQTT-koordinatorn. När du konfigurerar en enhet och tillgång upprättas en anslutning till den fysiska tillgången eller enheten och datapunktsvärden, händelser och strömmar som kommer till Azure IoT Operations-instansen. En enhet har en eller flera inkommande slutpunkter. Azure IoT Operations lagrar enhetsdefinitioner i Azure Device Registry.

Anslutningsappen för ONVIF (förhandsversion) för Azure IoT Operations identifierar ONVIF-anslutna kameror som är anslutna till din Azure IoT Operations-instans och registrerar dem i Azure Device Registry. När kameran har registrerats är exempel på hanteringsåtgärder:

• Hämtar och uppdaterar kamerans konfiguration för att justera konfigurationen av utdatabilden.
• Styr kamerapannan, lutningen och zoomen (PTZ).

Medieanslutningsappen kan komma åt de mediekällor som exponeras av dessa kameror.

Med medieanslutningsappen, anslutningsappen för ONVIF, Azure IoT Operations och tillhörande tjänster kan du använda Azure IoT Operations för att implementera användningsfall som:

• Spårning av väntetid och vistelsetid för att följa den tid som kunderna spenderar i kö.
• Ordernoggrannhet för att spåra att rätt beställningar packas genom att jämföra objekt med POS-kvitto.
• Detektering av defekter och kvalitetssäkring med hjälp av kameror för att identifiera defekter i produkter på monteringslinjen.
• Säkerhetsövervakning såsom kollisionsidentifiering, identifiering av säkerhetszoner och identifiering av personlig säkerhetsutrustning.

I den här artikeln beskrivs hur du använder webbgränssnittet för driftupplevelse för att:

• Lägg till en enhet som har en ONVIF-slutpunkt för en kompatibel kamera.
• Visa de namnområdestillgångar och enheter som identifierats vid ONVIF-slutpunkten.
• Skapa en enhet som representerar medieslutpunkterna som exponeras av ONVIF-kameran.
• Skapa en tillgång som samlar in ögonblicksbilder från medieslutpunkten och publicerar dem till MQTT-asynkron meddelandekö.

Förutsättningar

För att konfigurera enheter och tillgångar behöver du en instans av Azure IoT Operations som körs.

För att logga in på webbgränssnittet för driftsupplevelsen behöver du ett Microsoft Entra-ID-konto med minst deltagarbehörighet för resursgruppen som innehåller din Kubernetes – Azure Arc-instans . Du kan inte logga in med ett Microsoft-konto (MSA). Så här skapar du ett lämpligt Microsoft Entra-ID-konto i din Azure-klientorganisation:

1. Logga in på Azure Portal med samma klient och användarnamn som du använde för att distribuera Azure IoT Operations.
2. I Azure Portal går du till avsnittet Microsoft Entra-ID och väljer Användare > + Ny användare > Skapa ny användare. Skapa en ny användare och anteckna lösenordet. Du behöver det för att logga in senare.
3. I Azure Portal går du till resursgruppen som innehåller Kubernetes – Azure Arc-instansen. På sidan Åtkomstkontroll (IAM) väljer du +Lägg till > rolltilldelning.
4. På sidan Lägg till rolltilldelning väljer du Privilegierade administratörsroller. Välj sedan Deltagare och välj sedan Nästa.
5. På sidan Medlemmar lägger du till din nya användare i rollen.
6. Välj Granska och tilldela för att slutföra konfigurationen av den nya användaren.

Du kan nu använda det nya användarkontot för att logga in på webbgränssnittet för driftupplevelse .

En ONVIF-kompatibel kamera som du kan nå från ditt Azure IoT Operations-kluster.

Hantera och kontrollera kameror

Med anslutningsappen för ONVIF kan du:

• Läs kamerainformation och funktioner.
• Identifiera medie-URI:er som exponeras av ONVIF-kameran.
• Konfigurera ONVIF-enheter, till exempel genom att uppdatera inställningen eller välja förinställningar.
• Kontrollera kamerans maskinvara med hjälp av PTZ-kommandon.

ONVIF-efterlevnad

ONVIF har flera kategorier för efterlevnad, till exempel identifiering, enhet, media, avbildning, analys, händelser och PTZ-tjänster (pan-tilt-zoom). Mer information finns i ONVIF – Profiler, tillägg och specifikationer.

Anslutningsappen för ONVIF i Azure IoT Operations fokuserar på stöd för kameraenheter som implementerar följande profiler:

• Profil S för grundläggande videouppspelning
• Profil T för avancerad videoströmning

Anslutningsappen ger stöd för följande funktioner:

• Identifiering av enhetsinformation och funktioner.
• Övervaka händelser från enheter.
• Identifiering av medie-URI:er som exponeras av en enhet. Anslutningsappen för ONVIF gör dessa URI:er tillgängliga för medieanslutningen.
• Bildkontroll, till exempel filter och mottagning av rörelse- och manipuleringshändelser.
• Styra enhetens PTZ.

Distribuera anslutningsappen för ONVIF

När du distribuerar förhandsversionen av Azure IoT Operations innehåller distributionen de tre förhandsgranskningsanslutningarna. Du kan kontrollera att du har en förhandsversion av Azure IoT Operations genom att i Azure-portalen kontrollera att förhandsversionsfunktioner är aktiverade för din instans:

Innan du kan använda förhandsgranskningsanslutningsapparna (ONVIF, media och HTTP/REST) i webbgränssnittet för driftsupplevelsen måste en administratör lägga till anslutningsmallsinstanser i din Azure IoT Operations-instans.

Alla tre förhandsversionanslutningar kan publicera insamlade data till MQTT-broker.

Så här lägger du till en mallinstans för anslutningsappen i din Azure IoT Operations-instans:

1. I Azure-portalen går du till din Azure IoT Operations-instans, väljer Anslutningsmallar och väljer sedan Lägg till anslutningsmallinstanser:

   

2. På den första sidan i guiden Lägg till en Akri-anslutningsmall väljer du den typ av anslutningsmall som du vill lägga till, till exempel ONVIF, Media eller HTTP REST. Välj sedan Metadata.

   

3. På sidan Metadata godkänner du standardvärdena och väljer sedan Typ av inkommande slutpunkt för enhet.

4. På sidan Typ av inkommande slutpunkt för enhet godkänner du standardvärdena och väljer sedan Diagnostikkonfigurationer.

5. På sidan Diagnostikkonfigurationer godkänner du standardvärdena och väljer sedan Körningskonfiguration.

6. På sidan Körningskonfiguration godkänner du standardvärdena och väljer sedan Granska:

7. På sidan Granska granskar du informationen om mallinstansen för anslutningsappen och väljer sedan Skapa för att skapa mallinstansen för anslutningsappen.

En OT-användare kan nu använda webbgränssnittet för driftupplevelse för att skapa en enhet med en slutpunkt för förhandsversionen av anslutningsappen.

Skapa en enhet med en ONVIF-slutpunkt

Så här lägger du till en enhet som innehåller en ONVIF-slutpunkt för en kompatibel kamera:

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

Visa identifierade tillgångar och enheter

När du har skapat en enhet med en ONVIF-slutpunkt identifierar anslutningsappen för ONVIF automatiskt de tillgångar och enheter som är tillgängliga på slutpunkten. Om du vill visa identifierade tillgångar och enheter i webbgränssnittet för driftupplevelse väljer du Identifiering i det vänstra navigeringsfönstret:

Om du väljer att importera och skapa en tillgång från den identifierade ONVIF-tillgången kan du skapa en tillgång som representerar funktionerna i den ONVIF-kompatibla kameran. Du kan till exempel skapa en tillgång som samlar in händelser från ONVIF-kameran eller gör att du kan styra ONVIF-kameran.

Skapa en enhet med medieslutpunkter

Följ dessa steg för att skapa en enhet med medieslutpunkter från den identifierade enheten:

1. I webbgränssnittet för driftupplevelse väljer du Identifiering i det vänstra navigeringsfönstret. Välj sedan Identifierade enheter.

2. Välj den enhet som du skapade i föregående avsnitt, till exempel my-onvif-camera. Välj sedan Importera och skapa enhet.

3. Sidan Enhetsinformation visar de identifierade medieslutpunkterna. Ange ett namn på enheten, till exempel my-onvif-camera-media, och välj en autentiseringsmetod för varje slutpunkt:

   

   Tips/Råd

   Du kan ta bort en inkommande slutpunkt som du inte vill använda genom att välja den och sedan välja Ta bort inkommande slutpunkt.

   Välj sedan Nästa.

4. På sidan Lägg till anpassad egenskap kan du uppdatera, ta bort eller lägga till anpassade egenskaper på enheten. Välj Nästa när du är klar.

5. På sidan Sammanfattning granskar du enhetens information. Välj Skapa för att skapa enheten. Efter några minuter visar sidan Enheter den nya enheten.

   

Skapa en medietillgång för att samla in ögonblicksbilder

Du kan nu använda den identifierade medieenheten för att skapa en tillgång som samlar in ögonblicksbilder från kameran och publicerar dem till MQTT-koordinatorn. Följ dessa steg för att skapa medietillgången:

1. I webbgränssnittet för driftupplevelse väljer du Tillgångar i det vänstra navigeringsfönstret. Välj sedan Skapa namnområdestillgång.

2. På sidan Tillgångsinformation anger du ett namn på tillgången, till exempel my-onvif-camera-media-asset. Välj sedan den identifierade slutpunkt som du vill använda för att avbilda ögonblicksbilder.

   

   Uppdatera eventuella anpassade egenskaper för medietillgången och välj sedan Nästa.

3. På sidan Strömmar väljer du Lägg till ström. Använd följande inställningar för att konfigurera strömmen:

   • Stream-namn: myassetvideo
   • Mål: MQTT
   • Ämne: myassetvideo
   • Aktivitetstyp
   • Strömtyp: snapshot-to-mqtt

   Lämna de andra inställningarna som standard. Välj sedan Lägg till. Strömmen läggs till i tillgångskonfigurationen:

   

4. Välj Nästa för att gå till sidan Sammanfattning . Granska informationen om tillgången och välj sedan Skapa för att skapa tillgången. Efter några minuter visar sidan Tillgångar den nya tillgången.

   

Medietillgången är nu konfigurerad för att samla in ögonblicksbilder från den ONVIF-kompatibla kameran och publicera dem till MQTT-koordinatorn.

Skapa en ONVIF-tillgång för händelsehantering och kontroll

ONVIF-kompatibla kameror kan generera händelser som rörelseidentifiering och svara på kontrollkommandon som panorering, lutning och zoomning. Du kan skapa en ONVIF-tillgång från den identifierade ONVIF-enheten som samlar in dessa händelser och gör att du kan styra kameran.

När du har lagt till en ONVIF-enhet i driftupplevelsen skapas en identifierad ONVIF-tillgång automatiskt:

Så här skapar du en ONVIF-tillgång för händelsehantering och -kontroll:

1. Välj den identifierade tillgången och välj sedan Importera och skapa tillgång.

2. På sidan Tillgångsinformation anger du ett namn och en beskrivning för tillgången. Enhetens inkommande slutpunkt har redan valts åt dig.

   

3. På sidan Händelser väljer du Hantera händelsegrupper för att välja vilka typer av händelser som ska avbildas från kameran. Du kan välja mellan händelsegrupper som rörelseidentifiering och kameramanipulering:

   

4. För varje händelsegrupp som du behåller konfigurerar du det MQTT-ämne som publiceras till:

   

5. På sidan Åtgärder väljer du Hantera hanteringsgrupper för att välja de åtgärder, till exempel panorering, lutning och zoomning, som du vill använda för att styra ONVIF-kameran.

   

6. För varje hanteringsgrupp som du behåller konfigurerar du det MQTT-ämne som den prenumererar på:

   

7. Granska sammanfattningen av ONVIF-tillgångskonfigurationen och välj sedan Skapa för att skapa tillgången. Efter några minuter visar sidan Tillgångar den nya tillgången.

Hantera och kontrollera kameran

Om du vill interagera med ONVIF-kameran kan du publicera MQTT-meddelanden som anslutningsappen för ONVIF prenumererar på. Meddelandeformatet baseras på specifikationerna för ONVIF-nätverksgränssnittet.

Azure IoT Operations-anslutningen för ONVIF PTZ Demo-exempelprogrammet visar hur du använder anslutningen för ONVIF för att:

• Använd medieobjektdefinitionen för att hämta en profiltoken från kamerans medietjänst.
• Använd profiltoken när du använder kamerans PTZ-funktioner för att styra dess position och orientering.

Exempelprogrammet använder Azure IoT Operations MQTT-koordinatorn för att skicka kommandon för att interagera med anslutningsappen för ONVIF. Mer information finns i Publicera och prenumerera på MQTT-meddelanden med MQTT-koordinator.