Snelstart: beschikbare ruimten zoeken met behulp van Azure Digital Twins

Met de Azure Digital Twins-service kunt u opnieuw een digitale kopie van uw fysieke omgeving maken. U kunt vervolgens een melding ontvangen van gebeurtenissen in uw omgeving en uw reacties hierop aanpassen.

In deze snelstart wordt een paar .NET-voorbeelden gebruikt om een denkbeeldig kantoorgebouw te digitaliseren. Hiermee kunt u zien hoe u beschikbare ruimten in dat gebouw kunt vinden. Met Digital Twins kunt u vele sensoren koppelen aan uw omgeving. U kunt met behulp van een gesimuleerde sensor voor koolstofdioxide ook vaststellen of de luchtkwaliteit van de beschikbare ruimte optimaal is. Door een van de voorbeeldtoepassingen worden willekeurige sensorgegevens gegenereerd, zodat u dit scenario beter kunt visualiseren.

In de volgende video vindt u een overzicht van de Quick Start-instellingen:

Vereisten

  1. Als u geen Azure-account hebt, maak dan een gratis account aan voordat u begint.

  2. De twee consoletoepassingen die u uitvoert in deze snelstart zijn geschreven in C#. Installeer .NET Core SDK-versie 2.1.403 of hoger op uw ontwikkelcomputer. Als u de .NET Core-SDK hebt geïnstalleerd, controleert u de huidige versie van C# op uw ontwikkelmachine. Voer dotnet --version in een opdrachtprompt uit.

  3. Download het C#-voorbeeldproject. Pak het archief digital-twins-samples-csharp-master.zip uit.

Een Digital Twins-exemplaar maken

Maak een nieuw exemplaar van Digital Twins in de portal door de stappen in deze sectie te volgen.

  1. Meld u aan bij de Azure-portal.

  2. Selecteer de balk aan de linkerkant en klik vervolgens op een resource maken.

    Vouw de balk aan de linkerkant uit en selecteer + een resource maken

  3. Zoek naar Digital apparaatdubbelsen selecteer Digital apparaatdubbels.

    Selecties voor het maken van een nieuw Digital Twins-exemplaar

    U kunt ook Internet of Thingsselecteren en Digital apparaatdubbels (preview) selecteren.

  4. Selecteer Maken om het implementatieproces te starten.

    De implementatie van de resource maken en bevestigen

  5. In het deelvenster Digital Twins voert u de volgende informatie in:

    • Resourcenaam: geef uw instantie van Digital Twins een unieke naam.

    • Abonnement: kies het abonnement dat u wilt gebruiken om deze instantie van Digital Twins te maken.

    • Resourcegroep: selecteer of maak een resourcegroep voor de instantie van Digital Twins.

    • Locatie: selecteer de locatie die het dichtst bij uw apparaten in de buurt is.

      Digital Twins-deelvenster met ingevoerde gegevens

  6. Controleer uw Digital Twins-gegevens en selecteer Maken. Het kan een paar minuten duren voordat uw instantie van Digital Twins is gemaakt. U kunt de voortgang bewaken via het deelvenster Meldingen.

  7. Open het deelvenster Overzicht van de instantie van Digital Twins. Zoals u ziet, wordt er een koppeling weergegeven onder Beheer API. De URL van de beheer-API is opgemaakt als:

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

    Deze URL leidt u naar de documentatie van de REST API van Azure Digital Twins, die van toepassing is op uw instantie. Zie Het gebruik van Azure Digital Twins Swagger voor informatie over hoe u deze API-documentatie dient te lezen en gebruiken. Kopieer de API-URL voor beheer en wijzig deze in deze indeling:

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

    Uw toepassing gebruikt de aangepaste URL als de basis-URL voor toegang tot uw instantie. Kopieer deze gewijzigde URL naar een tijdelijk bestand. U hebt deze URL nodig in de volgende sectie.

    Overzicht van beheer-API

Machtigingen instellen voor uw app

In deze sectie registreert u uw voorbeeldtoepassing in Azure Active Directory (Azure AD), zodat deze toegang heeft tot uw Digital Twins-exemplaar. Als u al over een app-registratie van Azure AD beschikt, kunt u deze opnieuw gebruiken voor uw voorbeeld. Controleer of deze is geconfigureerd zoals beschreven in deze sectie.

Notitie

Deze sectie bevat instructies voor de registratie van Azure AD-apps.

  1. Open in de Azure Portal Azure Active Directory in het menu uitbreidbaar links en open vervolgens het app-registraties deel venster.

    Het deel venster Azure Active Directory selecteren

  2. Selecteer de knop + nieuwe registratie .

    Selecteer de knop nieuwe registratie

  3. Geef een beschrijvende naam voor deze app-registratie op in het vak Naam.

    1. Typ in het tekstvak onder omleidings-URI (optioneel) https://microsoft.com .

    2. Controleer welke accounts en tenants worden ondersteund door uw Azure Active Directory-app.

    3. Selecteer Registreren.

    Deelvenster maken

  4. De Blade verificatie specificeert belang rijke instellingen voor verificatie configuratie.

    1. Voeg omleidings-uri's toe en configureer toegangs tokens door + een platform toe te voegen.

    2. Selecteer Ja om op te geven dat de app een open bare clientis.

    3. Controleer welke accounts en tenants worden ondersteund door uw Azure Active Directory-app.

    Configuratie-instelling voor de open bare client

  5. Nadat u het juiste platform hebt geselecteerd, configureert u de omleidings-uri's en toegangs tokens in het deel venster aan de rechter kant van de gebruikers interface.

    1. Omleidings-uri's moeten overeenkomen met het adres dat is opgegeven door de verificatie aanvraag:

      • Voor apps die worden gehost in een lokale ontwikkel omgeving selecteert u open bare client (mobiele & bureau blad). Zorg ervoor dat de open bare client is ingesteld op Ja.
      • Voor apps met één pagina die worden gehost op Azure App Service, selecteert u Web.
    2. Bepaal of een Afmeldings-URL geschikt is.

    3. Schakel de impliciete toekennings stroom in door toegangs tokens of id-tokenste controleren.

    Omleidings-Uri's configureren

    Klik op configurerenen vervolgens op Opslaan.

  6. Open het deel venster overzicht van de geregistreerde app en kopieer de waarden van de volgende entiteiten naar een tijdelijk bestand. U gebruikt deze waarden om uw voorbeeld toepassing te configureren in de volgende secties.

    • (Client-)id van de app
    • (Tenant-)id van de map

    Azure Active Directory toepassings-ID

  7. Open het deel venster API-machtigingen voor de registratie van uw app. Selecteer + een machtigings knop toevoegen . Selecteer in het deel venster API-machtigingen voor aanvragen de api's mijn organisatie tabblad gebruikt en zoek vervolgens een van de volgende opties:

    1. Azure Digital Twins. Selecteer de Azure Digital apparaatdubbels -API.

      Zoek-API of Azure Digital Apparaatdubbels

    2. U kunt ook zoeken naar Azure Smart Spaces Service . Selecteer de Azure Smart Spaces-service -API.

      Zoek-API voor Azure Smart Spaces

    Belangrijk

    De naam en ID van de Azure AD-API die wordt weer gegeven, is afhankelijk van uw Tenant:

    • Test Tenant-en klant accounts moeten zoeken naar Azure Digital Twins .
    • Andere micro soft-accounts moeten zoeken Azure Smart Spaces Service .
  8. Een van de API'S wordt weer gegeven als Azure Digital apparaatdubbels in het deel venster API-machtigingen voor aanvragen nadat het is geselecteerd. Selecteer de vervolg keuzelijst lezen en schakel vervolgens het selectie vakje lezen. schrijven in. Selecteer de knop Toestemmingen toevoegen.

    API-machtigingen toevoegen

  9. Afhankelijk van de instellingen van uw organisatie moet u mogelijk extra stappen uitvoeren om beheerders toegang tot deze API te verlenen. Neem contact op met de beheerder voor meer informatie. Zodra de beheerders toegang is goedgekeurd, worden in het deel venster API- machtigingen uw machtigingen weer gegeven in de kolom Administrator toestemming vereist .

    Goed keuring van beheerders toestemming

    Controleer of Azure Digital apparaatdubbels wordt weer gegeven.

Toepassing bouwen

Volg deze stappen om de bezettingstoepassing te bouwen.

  1. Open een opdrachtprompt. Ga naar de map waar uw digital-twins-samples-csharp-master.zip-bestanden zijn uitgepakt.

  2. Voer cd occupancy-quickstart/src uit.

  3. Voer dotnet restore uit.

  4. Bewerk appSettings.json om de volgende variabelen bij te werken:

    • ClientId: voer de toepassings-id van uw Azure AD-app-registratie in, die u in de voorgaande sectie hebt genoteerd.
    • Tenant: voer de map-id van uw Azure AD-tenant in, die u ook in de vorige sectie hebt genoteerd.
    • BaseUrl: de URL van de beheer-API van uw Digital Twins-exemplaar wordt weergegeven in de indeling https://yourDigitalTwinsName.yourLocation.azuresmartspaces.net/management/api/v1.0/. Vervang de tijdelijke aanduidingen in deze URL door de waarden voor uw exemplaar uit de vorige sectie.

    Sla het bijgewerkte bestand op.

Grafiek inrichten

In deze stap wordt uw ruimtelijke Digital Twins-grafiek ingericht met:

  • Diverse ruimten.
  • Eén apparaat.
  • Twee sensoren.
  • Een aangepaste functie.
  • Een roltoewijzing.

De ruimtelijke grafiek wordt ingericht met behulp van het bestand provisionSample.yaml.

  1. Voer dotnet run ProvisionSample uit.

    Notitie

    Het programma voor apparaataanmelding van de Azure CLI wordt gebruikt om de gebruiker bij Azure AD te verifiëren. De gebruiker moet een bepaalde code invoeren om zich te verifiëren met behulp van de Microsoft-aanmeldingspagina. Nadat de code is ingevoerd, volgt u de stappen om te verifiëren. De gebruiker moet zich verifiëren als het hulpprogramma wordt uitgevoerd.

    Tip

    Als u deze stap uitvoert, controleert u of de variabelen correct zijn gekopieerd als u dit foutbericht ziet: EXIT: Unexpected error: The input is not a valid Base-64 string ...

  2. De inrichtingsstap kan enkele minuten duren. Er wordt ook een IoT Hub binnen uw Digital Twins-exemplaar ingericht. Het inrichten blijft doorlopen totdat de status van de IoT Hub gelijk is aan Running.

    Het voor beeld (status) inrichten = uitvoeren

  3. Aan het einde van de uitvoering, kopieert u de ConnectionString van het apparaat voor gebruik in de voorbeeldapparaatsimulator. Kopieer alleen de tekenreeks die wordt beschreven in deze afbeelding.

    De verbindingsreeks kopiëren

    Tip

    U kunt de ruimtelijke grafiek bekijken en aanpassen met de Graph Viewer voor Azure Digital Twins.

Houd het console venster geopend voor gebruik later opnieuw.

Sensorgegevens verzenden

Bouw en voer de app voor sensor Simulator uit door de volgende stappen uit te voeren.

  1. Open een nieuwe opdrachtprompt. Ga naar het project dat u hebt gedownload in de digital-twins-samples-csharp-master map.

  2. Voer cd device-connectivity uit.

  3. Voer dotnet restore uit.

  4. Bewerk appsettings.json om DeviceConnectionString bij te werken met de vorige ConnectionString. Sla het bijgewerkte bestand op.

  5. Voer dotnet run uit om te beginnen met het verzenden van gegevens. Het wordt verzonden naar Azure Digital Apparaatdubbels, zoals wordt weer gegeven in de volgende afbeelding.

    Connectiviteit van apparaten

  6. Voer deze simulator uit, zodat u de resultaten naast de actie van de volgende stap kunt bekijken. In dit venster kunt u zien dat de gesimuleerde sensorgegevens naar Digital Twins zijn verzonden. In de volgende stap wordt in realtime naar beschikbare ruimte met frisse lucht gezocht.

    Tip

    Als u deze stap uitvoert, controleert u of DeviceConnectionString correct is gekopieerd als u dit foutbericht ziet: EXIT: Unexpected error: The input is not a valid Base-64 string ...

Beschikbare ruimten met frisse lucht zoeken

Het sensorvoorbeeld simuleert willekeurige gegevenswaarden voor twee sensoren. Deze zijn beweging en koolstofdioxide. In het voorbeeld worden beschikbare ruimten met frisse lucht gedefinieerd door geen aanwezigheid in de ruimte. Ze worden ook gedefinieerd door een koolstofdioxidegehalte van minder dan 1000 ppm. Als niet aan de voorwaarde wordt voldaan, is de ruimte niet beschikbaar of is de luchtkwaliteit slecht.

  1. Open de opdracht prompt die u hebt gebruikt om de inrichtings stap eerder uit te voeren.

  2. Voer dotnet run GetAvailableAndFreshSpaces uit.

  3. Bekijk deze opdrachtprompt en de opdrachtprompt voor sensorgegevens naast elkaar.

    Met de opdracht prompt voor sensor gegevens worden gesimuleerde bewegings-en kooldioxyde-gegevens naar digitale-Apparaatdubbels elke vijf seconden verzonden. Met de andere opdracht prompt wordt de grafiek in realtime gelezen om beschik bare ruimten met verse lucht te ontdekken op basis van wille keurige gesimuleerde gegevens. Een van deze voorwaarden wordt bijna in realtime weergegeven op basis van de sensorgegevens die de laatste keer zijn verzonden:

    • Room is available and air is fresh

    • Room is not available or air quality is poor

      Beschikbare ruimten met frisse lucht ophalen

Open Visual Studio code met het code werkruimte project in voor meer informatie over wat er is gebeurd in deze Snelstartgids en welke api's werden genoemd digital-twins-samples-csharp . Gebruik de volgende opdracht:

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

In de zelfstudies wordt diep op de code ingegaan. U komt te weten hoe u configuratiegegevens kunt wijzigen en welke API's worden aangeroepen. Ga voor meer informatie over beheer-API's naar de pagina van Digital Twins Swagger:

https://YOUR_INSTANCE_NAME.YOUR_LOCATION.azuresmartspaces.net/management/swagger
Naam Vervangen door
YOUR_INSTANCE_NAME De naam van uw Digital Twins-exemplaar
YOUR_LOCATION De server regio waar uw exemplaar wordt gehost

Of ga naar Digital Twins Swagger.

Resources opschonen

In de zelfstudies wordt ook in detail ingegaan op:

  • Het bouwen van een toepassing voor facility managers om de productiviteit van de aanwezigen te verhogen.
  • Het gebouw efficiënter leiden.

Als u doorgaat naar de zelfstudies, verwijder dan niet de resources die u in deze snelstart hebt gemaakt. Als u niet doorgaat, verwijdert u alle resources die u in deze snelstart hebt gemaakt.

  1. Verwijder de map die is gemaakt bij het downloaden van de opslagplaats met voorbeelden.

  2. Selecteer Alle resources in het menu aan de linkerkant van de Azure-portal. Selecteer vervolgens uw Digital Twins-resource. Selecteer boven aan het deelvenster Alle resources de optie Verwijderen.

    Tip

    Als u eerder problemen hebt ondervonden bij het verwijderen van uw digitale Apparaatdubbels-exemplaar, is er een service-update met de oplossing geïmplementeerd. Probeer opnieuw of u het exemplaar kunt verwijderen.

Volgende stappen

In deze Quick Start hebt u een eenvoudige scenario en voorbeeld toepassingen gebruikt om te laten zien hoe digitale Apparaatdubbels kan worden gebruikt om te zoeken naar ruimten met goede werk omstandigheden. Lees deze zelf studie voor uitgebreide analyse van dit scenario: