Snabbstart: Skapa en HoloLens-app med Azure Object Anchors, i Unity

I den här snabbstarten skapar du en Unity HoloLens app som använder Azure Object Anchors. Azure Object Anchors är en hanterad molntjänst som konverterar 3D-tillgångar till AI-modeller som möjliggör objektmedvetna upplevelser med mixad verklighet för HoloLens. När du är klar har du en app HoloLens som skapats med Unity och som kan identifiera objekt i den fysiska världen.

Du lär dig följande:

Förutsättningar

Kontrollera att du har följande så att du kan utföra den här snabbstarten:

• Ett fysiskt objekt i din miljö och dess 3D-modell (antingen CAD eller scannat).
• En Windows-dator med följande installerat:
  • Git för Windows
  • Visual Studio 2019 med arbets belastningen universell Windows-plattform utveckling och Windows 10 SDK-komponenten (10.0.18362.0 eller senare)
  • Unity 2019,4
• En HoloLens 2-enhet som är aktuell och har utvecklarläge aktiverat.
  • Om du vill uppdatera till den senaste versionen av HoloLens öppnar du appen Inställningar , går till Uppdatera & säkerhet och väljer sedan Sök efter uppdateringar.

Skapa ett Object Anchors konto

Först måste du skapa ett konto med Object Anchors tjänsten.

1. Gå till Azure Portal och välj Skapa en resurs.

   

2. Sök efter Object Anchors resurs.

   Sök efter "Object Anchors".

   

   På Object Anchors i sökresultatet väljer du Skapa -> Object Anchors.

   

3. I dialogrutan Object Anchors konto:

   • Ange ett unikt resursnamn.
   • Välj den prenumeration som du vill koppla resursen till.
   • Skapa eller använda en befintlig resursgrupp.
   • Välj den region som du vill att resursen ska finnas i.

   

   Välj Skapa för att börja skapa resursen.

4. När resursen har skapats väljer du Gå till resurs.

   

5. På översiktssidan:

   Anteckna kontodomänen. Du behöver det senare.

   

   Anteckna konto-ID:t. Du behöver det senare.

   

   Gå till sidan Åtkomstnycklar och anteckna primärnyckeln. Du behöver det senare.

   

Konfigurera enheten

Om du vill distribuera appar till din HoloLens måste du koppla din HoloLens till din dator.

1. I din HoloLens navigerar du till Inställningar-> uppdatera & Security-> för utvecklare.
2. Klicka på par och lämna skärmen öppen tills du anger PIN-koden i Visual Studio under din första distribution.

Upload din modell

Innan du kör appen måste du göra dina modeller tillgängliga för appen. Om du inte redan har en modell Object Anchors följer du anvisningarna i Skapa en modell för att skapa en. Gå sedan tillbaka hit.

När din HoloLens på och ansluten till utvecklingsenheten (PC) följer du dessa steg för att ladda upp en modell till mappen 3D-objekt på HoloLens:

1. Markera och kopiera de modeller som du vill arbeta med genom att trycka på Ctrl-tangenten och C tillsammans (Ctrl + C).

2. Tryck Windows logo och E tillsammans (Win + E) för att starta Utforskaren. Du bör se HoloLens listas med andra enheter och mappar i den vänstra rutan.

   

3. Tryck på HoloLens länken för att visa lagringen HoloLens enheten i den högra rutan.

   

4. I Utforskaren går du till Internt Storage > 3D-objekt. Nu kan du klistra in dina modeller i mappen 3D-objekt genom att trycka på Ctrl-tangenten och V tillsammans (Ctrl + V).

   

Öppna exempelprojektet

Klona exempel lagrings platsen genom att köra följande kommandon:

git clone https://github.com/Azure/azure-object-anchors.git

cd ./azure-object-anchors

Nästa steg är att ladda ned Azure Object Anchors för Unity.

npm pack com.microsoft.azure.object-anchors.runtime@<version_number> --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry/

npm view com.microsoft.azure.object-anchors.runtime --registry https://pkgs.dev.azure.com/aipmr/MixedReality-Unity-Packages/_packaging/Unity-packages/npm/registry/ versions

Öppna projektet i quickstarts/apps/unity/basic Unity.

Konfigurera kontoinformationen

Nästa steg är att konfigurera appen så att den använder din kontoinformation. Du antecknade värdena för Kontonyckel, Konto-ID och Kontodomän i avsnittet "Skapa ett Object Anchors-konto".

I fönstret Project du till Assets\AzureObjectAnchors.SDK\Resources .

Välj ObjectAnchorsConfig. I fönstret Kontroll anger du som värde för Object Anchors-kontonyckel , som värde för Account Key Account ID Object Anchors-konto-ID och som värde Account Domain för Object Anchors Account Domain.

Kompilera och köra appen

Bygg exempel scenen

I Unity-redigeraren navigerar du till till gångar/MixedReality. AzureObjectAnchors/scener och öppnar AOASampleScene och lägger till den i en scen versions lista.

Välj File -> Building Settings (Arkiv -> Skapa inställningar). Välj Universell Windows-plattform och välj sedan Växla plattform. Om Unity-redigeraren säger att du måste ladda ned vissa komponenter först laddar du ned och installerar dem. Följ skärmbilden nedan för att konfigurera bygginställningarna. Kontrollera att endast AOASampleScene har en bockmarkering bredvid sig: alla andra scener bör inte inkluderas.

Välj Skapa och välj en utdatamapp. Nu kan du generera ett VS-projekt i utdatamappen.

Skapa och distribuera appen

Öppna .sln filen som genererats av Unit. Ändra build-konfigurationen till följande.

Därefter måste du konfigurera den fjärranslutna datorns IP-adress för att distribuera och felsöka appen.

Högerklicka på App-projektet och välj Egenskaper. På sidan Egenskaper väljer du konfigurations egenskaper-> fel sökning. Ändra värdet för dator namn till din HoloLens-enhets IP-adress och klicka på Använd.

Stäng egenskaps sidan. Klicka på fjärran sluten dator. Appen ska börja bygga och distribuera till din fjärranslutna enhet. Kontrol lera att enheten är aktiv.

Efter välkomstskärmen i Unity visas ett meddelande om att objektobservatör har initierats.

Appen söker efter objekt i det aktuella visningsfältet och spårar dem när de har identifierats. En instans tas bort när den är 6 meter från användarens plats. Felsökningstexten visar information om en instans, t.ex. ID, uppdaterad tidsstämpel och yttäckningsförhållande.

Felsökning

Tips

Om ditt objekt inte identifieras kan du prova följande steg:

1. Kontrol lera att du använder rätt modell för ditt objekt.
2. Visualisera Sök fältet och se till att det täcker målobjektet.
3. Försök att minska MinSurfaceCoverage .
4. I Windows Device portal klickar du på vyer-> 3D-vyer och kontrollerar om genomsökningen är klar.

Nästa steg