Snabbstart: Hitta tillgängliga rum med hjälp av Azure Digital Twins

  • Artikel
  • 8 minuter för att läsa

Med tjänsten Azure Digital Twins kan du återskapa en digital bild av den fysiska miljön. Du kan sedan få ett meddelande via händelser i din miljö och anpassa dina svar efter dem.

I den här snabbstarten används ett par .NET-exempel för att digitalisera en tänkt kontorsbyggnad. Här visas hur du hittar tillgängliga rum i byggnaden. Du kan associera många sensorer med Digital Twins med din miljö. Du kan även få reda på om luftkvaliteten i det tillgängliga rummet är optimalt med hjälp av en simulerad koldioxidsensor. Ett av exempelprogrammen genererar slumpmässiga sensordata som hjälper dig att visualisera det här scenariot.

Följande video sammanfattar installations programmet för snabb start:

Krav

  1. Om du inte har något Azure-konto skapar du ett kostnadsfritt konto innan du börjar.

  2. De två konsolprogram som du kör i den här snabbstarten skrivs med C#. Installera .NET Core SDK version 2.1.403 eller senare på utvecklingsdatorn. Om du har .NET Core SDK installerat verifierar du den aktuella versionen av C# på utvecklingsdatorn. Kör dotnet --version i en kommandotolk.

  3. Ladda ned C#-exempelprojektet. Extrahera arkivet digital-twins-samples-csharp-master.zip.

Skapa en Digital Twins-instans

Använd stegen i det här avsnittet för att skapa en ny instans av Digital Twin i portalen.

  1. Logga in på Azure-portalen.

  2. Välj fältet start sida och sedan + skapa en resurs.

    Expandera fältet start sida och välj sedan + skapa en resurs

  3. Sök efter digitala dubblaoch välj digitala dubbla.

    Val för att skapa en ny Digital Twins-instans

    Du kan också välja Sakernas Internetoch välja digitala dubbla (för hands version).

  4. Välj Skapa för att starta distributionsprocessen.

    Skapa och bekräfta distributionen av resursen

  5. I fönstret Digital Twins anger du följande information:

    • Resursnamn: Skapa ett unikt namn på Digital Twins-instansen.

    • Prenumeration: Välj den prenumeration som du vill använda för att skapa Digital Twins-instansen.

    • Resursgrupp: Välj eller skapa en resursgrupp för Digital Twins-instansen.

    • Plats: Välj den plats som är närmast enheten.

      Digital Twins-fönstret med angiven information

  6. Granska din Digital Twins-information och välj sedan Skapa. Det kan ta några minuter för Digital Twins-instansen att skapas. Du kan övervaka förloppet i meddelandefönstret.

  7. Öppna översiktsfönstret för Digital Twins-instansen. Observera länken under Hanterings-API. URL: en för hanterings-API : n formateras som:

    https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/swagger

    Denna URL tar dig till dokumentationen för Azure Digital Twins REST API som gäller för din instans. Läs om hur du använder Azure Digital Twins Swagger för att få reda på hur du läser och använder den här API-dokumentationen. Kopiera och ändra hanterings-API -URL: en till det här formatet:

    https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/

    Programmet använder den ändra URL:en som bas-URL för att få åtkomst till instansen. Kopiera denna ändrade URL till en temporär fil. Du behöver URL:en i nästa avsnitt.

    Översikt över hanterings-API

Ange behörigheter för din app

Det här avsnittet registrerar ditt exempelprogram till Azure Active Directory (Azure AD), så att det kan komma åt din Digital Twins-instans. Om du redan har en Azure AD-appregistrering kan du återanvända den för ditt exempel. Kontrollera att den är konfigurerad enligt beskrivningen i det här avsnittet.

Anteckning

Det här avsnittet innehåller anvisningar för registrering av Azure AD-appar.

  1. Öppna Azure Active Directory från den expanderade vänstra menyn i Azure Portaloch öppna sedan fönstret Appregistreringar .

    Välj fönstret Azure Active Directory

  2. Välj knappen + ny registrering .

    Välj knappen ny registrering

  3. Ge appregistreringen ett eget namn i rutan Namn.

    1. Under omdirigerings-URI (valfritt) anger https://microsoft.com du i text rutan.

    2. Kontrol lera vilka konton och klienter som stöds av din Azure Active Directory-app.

    3. Välj Registrera.

    Skapa fönster

  4. Bladet autentisering anger viktiga konfigurations inställningar för autentisering.

    1. Lägg till omdirigerings-URI: er och konfigurera åtkomsttoken genom att välja + Lägg till en plattform.

    2. Välj Ja om du vill ange att appen är en offentlig klient.

    3. Kontrol lera vilka konton och klienter som stöds av din Azure Active Directory-app.

    Konfigurations inställning för offentlig klient

  5. När du har valt en lämplig plattform konfigurerar du omdirigerings-URI: er och åtkomsttoken på sido panelen till höger om användar gränssnittet.

    1. Omdirigerings-URI: er måste matcha adressen som anges av autentiseringsbegäran:

      • För appar som finns i en lokal utvecklings miljö väljer du offentlig klient (mobil & Desktop). Se till att ange en offentlig klient till Ja.
      • För appar på en sida som finns på Azure App Service väljer du webb.

    2. Avgör om en utloggnings-URL är lämplig.

    3. Aktivera det implicita tilldelnings flödet genom att kontrol lera åtkomsttoken eller ID-token.

    Konfigurera omdirigerings-URI: er

    Klicka på Konfigureraoch sedan på Spara.

  6. Öppna översikts fönstret för din registrerade app och Kopiera värdena för följande entiteter till en temporär fil. Du använder dessa värden för att konfigurera exempel programmet i följande avsnitt.

    • Program-ID (klient)
    • Katalog-ID (klient)

    ID för Azure Active Directory-programmet

  7. Öppna fönstret API-behörigheter för din app-registrering. Välj + Lägg till en behörighet -knapp. I rutan begär API-behörigheter väljer du fliken API: er min organisation använder och söker sedan efter något av följande:

    1. Azure Digital Twins. Välj Azure Digitals dubbla API: er.

      Sök-API eller digitala Azure-dubbla

    2. Du kan också söka efter Azure Smart Spaces Service . Välj API för Azure Smart Spaces-tjänsten .

      Sök-API för Azure Smart Spaces

    Viktigt

    Det API-namn och ID för Azure AD som visas beror på din klient organisation:

    • Testa klient organisation och kund konton bör söka efter Azure Digital Twins .
    • Andra Microsoft-konton bör söka efter Azure Smart Spaces Service .

  8. Antingen visas API: et som Azure Digitals dubbla i samma begär ande-API-behörigheter när det är markerat. Välj List rutan Läs och markera kryss rutan Läs. Skriv . Välj knappen Lägg till behörigheter .

    Lägg till API-behörigheter

  9. Beroende på organisationens inställningar kan du behöva vidta ytterligare åtgärder för att bevilja administratörs åtkomst till det här API: et. Kontakta administratören om du vill ha mer information. När administratörs åtkomsten har godkänts visas din behörighet i kolumnen Administratörs medgivande i rutan API-behörigheter .

    Godkännande av administratörs medgivande

    Kontrol lera att Azure Digital-dubbla visas.

Skapa program

Skapa beläggningsprogrammet med hjälp av följande steg.

  1. Öppna en kommandotolk. Gå till mappen där dina digital-twins-samples-csharp-master.zip-filer har extraherats.

  2. Kör cd occupancy-quickstart/src.

  3. Kör dotnet restore.

  4. Redigera appSettings.json för att uppdatera följande variabler:

    • ClientId: Ange program-ID för din Azure AD-appregistrering som beskrevs i föregående avsnitt.
    • Klient: Ange katalog-ID för din Azure AD-klient, som också beskrevs i föregående avsnitt.
    • BaseUrl: URL:en för API för hantering för Digital Twins-instansen har formatet https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/. Ersätt platshållarna i webbadressen med värden för din instans från föregående avsnitt.

    Spara den uppdaterade filen.

Etablera graf

I det här steget etableras den rumsliga Digital Twins-grafen med:

  • Flera utrymmen.
  • En enhet.
  • Två sensorer.
  • En anpassad funktion.
  • En rolltilldelning.

En rumslig graf etableras med hjälp av filen provisionSample.yaml.

  1. Kör dotnet run ProvisionSample.

    Anteckning

    Azure CLI-verktyget Inloggning på enhet används för att autentisera användaren för Azure AD. Användaren måste ange en viss kod för att autentisera med hjälp av Microsofts inloggningssida. När du har angett koden följer du stegen för att autentisera. Användaren måste autentiseras när verktyget körs.

    Tips

    När du kör det här steget kontrollerar du att variablerna har kopierats om följande felmeddelande visas: EXIT: Unexpected error: The input is not a valid Base-64 string ...

  2. Etableringssteget kan ta några minuter. En IoT-hubb etableras också i Digital Twins-instansen. Den loopas tills IoT-hubben visar Status=Running.

    Etablera exempel status = körs

  3. I slutet av körningen kopierar du enhetens ConnectionString för användning i exemplet med enhetssimulatorn. Kopiera den sträng som beskrivs i den här bilden.

    Kopiera anslutningssträngen

    Tips

    Du kan visa och ändra ett spatialt diagram med hjälp av Visningsprogrammet för Azure Digital Twins Graph.

Låt konsol fönstret vara öppet för användning igen senare.

Skicka sensordata

Skapa och kör programmet sensor simulator enhet genom att följa dessa steg.

  1. Öppna en ny kommandotolk. Gå till det projekt som du laddade ned i digital-twins-samples-csharp-master mappen.

  2. Kör cd device-connectivity.

  3. Kör dotnet restore.

  4. Redigera appsettings.json för att uppdatera DeviceConnectionString med föregående ConnectionString. Spara den uppdaterade filen.

  5. Kör dotnet run för att börja skicka sensordata. Den skickas till Azure Digital-dubbla, som du ser i följande bild.

    Enhets anslutning

  6. Låt den här simulatorn köras så att du kan visa resultat sida vid sida med nästa steg. I det här fönstret visas de simulerade sensordata som skickats till Digital Twins. I nästa steg ställs frågor i realtid för att hitta tillgängliga rum med frisk luft.

    Tips

    När du kör det här steget kontrollerar du att DeviceConnectionString har kopierats om följande felmeddelande visas: EXIT: Unexpected error: The input is not a valid Base-64 string ...

Hitta tillgängliga utrymmen med frisk luft

Sensorexemplet simulerar slumpmässiga datavärden för två sensorer. Det är rörelse och koldioxid. Tillgängliga utrymmen med frisk luft definieras i exemplet av ingen närvaro i rummet. De definieras även av en koldioxidnivå på under 1 000. Om villkoret inte uppfylls är utrymmet inte tillgängligt eller så är luftkvaliteten dålig.

  1. Öppna kommando tolken som du använde för att köra etablerings steget tidigare.

  2. Kör dotnet run GetAvailableAndFreshSpaces.

  3. Titta på den här kommandotolken och sensordatas kommandotolk sida vid sida.

    Kommando tolken för sensor data skickar simulerade rörelse-och koldioxid data till digitala dubbla sekunder var femte sekund. Den andra kommando tolken läser grafen i real tid för att ta reda på tillgängliga rum med färsk luft baserat på slumpmässiga simulerade data. Den visar ett av dessa villkor i nära realtid baserat på sensordata som skickades senast:

    • Room is available and air is fresh

    • Room is not available or air quality is poor

      Hämta tillgängliga utrymmen med frisk luft

Om du vill förstå vad som hände i den här snabb starten och vilka API: er som anropades öppnar du Visual Studio Code med projektet kod arbets yta i digital-twins-samples-csharp . Ange följande kommando:

<path>\occupancy-quickstart\src>code ..\..\digital-twins-samples.code-workspace

Självstudierna går på djupet i koden. Du lär dig hur du ändrar konfigurationsdata och vilka API:er som anropas. Mer information om API:er för hantering finns på Digital Twins Swagger-sidan:

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/swagger
Name Ersätt med
YOUR_INSTANCE_NAME Namnet på Digital Twins-instansen
YOUR_LOCATION Den server region där din instans finns

Eller för att göra det enkelt kan du bläddra till Digital Twins Swagger.

Rensa resurser

Självstudierna visar i detalj hur du:

  • Skapar ett program för förvaltningsansvariga för att öka beläggningsproduktiviteten.
  • Driver byggnaden effektivare.

Om du vill fortsätta med självstudierna ska du inte rensa resurserna som du skapade i den här snabbstarten. Om du inte planerar att fortsätta tar du bort alla resurser som har skapats i den här snabbstarten.

  1. Ta bort mappen som skapades när du laddade ned exempellagringsplatsen.

  2. Välj Alla resurser på menyn på vänster sida av Azure-portalen. Välj sedan din Digital Twins-resurs. Välj Ta bort överst i fönstret Alla resurser.

    Tips

    Om du tidigare fick problem med att ta bort en digital-datainstans har en tjänst uppdatering distribuerats med korrigeringen. Försök att ta bort instansen igen.

Nästa steg

I den här snabb starten användes ett enkelt scenario och exempel program för att visa hur digitala enheter kan användas för att hitta rum med lämpliga arbets förhållanden. För djupgående analys av det här scenariot, Läs den här självstudien:

Självstudie: Distribuera Azure Digital Twins och konfigurera ett spatialt diagram