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

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 med Unity 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/mrtk 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.

När dialogrutan TMP Importer uppmanar dig att importera TextMesh Pro resurser väljer du "Importera TMP Essentials" för att göra det.

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 Unity-välkomstskärmen bör du se en vit begränsningsruta. Du kan använda din hand för att flytta, skala eller rotera begränsningsrutan. Placera rutan för att täcka det objekt som du vill identifiera.

Öppna menyn och välj Lås sökningOmråde för att förhindra ytterligare förflyttning av begränsningsrutan. Välj Starta sökning för att starta objektidentifiering. När objektet identifieras återges ett nät på objektet. Information om en upptäckt instans visas på skärmen, till exempel uppdaterad tidsstämpel och yttäckningsförhållande. Välj Stoppa sökning för att stoppa spårningen så tas alla identifierade instanser bort.

Appmenyerna

Du kan också utföra andra åtgärder med hjälp av handmenyn.

Primär meny

• Starta sökning/stoppa sökning – startar eller stoppar objektidentifieringsprocessen.

• Växla spatial mappning – Visa/dölj rendering av rumslig mappning. Det här alternativet kan användas för att felsöka om genomsökningen är klar eller inte.

• Tracker Inställningar – Aktiverar menyn för spårningsinställningar.

• Search Area Inställningar – Aktiverar inställningsmenyn för sökområdet.

• Starta spårning – Samla in diagnostikdata och spara dem på enheten. Mer information finns i Avsnittet Problem med felsökningsidentifiering och Capture Diagnostics.

• Upload Tracing – Upload diagnostikdata till Object Anchors tjänsten.

  

Inställningsmeny för spårare

• Hög noggrannhet – en experimentell funktion som används för att få en mer exakt attityd. Om du aktiverar det här alternativet krävs fler systemresurser under objektidentifiering. Objektnätet renderas i rosa i det här läget. Välj den här knappen igen för att växla tillbaka till normalt spårningsläge.

• Avslappnad lodrät justering – När det här alternativet är aktiverat kan ett objekt identifieras i en icke-lodrät vinkel. Användbart för att identifiera objekt på ramper.

• Tillåt skalningsändring – Tillåter att spåraren ändrar storleken på det identifierade objektet baserat på miljöinformation.

• Skjutreglaget för täckningsgrad – Justerar andelen punkter som måste matcha för att spåraren ska kunna identifiera ett objekt. Med lägre värden kan spåraren bättre identifiera objekt som är svåra för HoloLens att identifiera, till exempel mörka objekt eller objekt med hög igenkänning. Högre värden minskar frekvensen för falska identifieringar.

  

Inställningsmeny för sökområde

• Lås sökområdet – Lås områdesreningsrutan för att förhindra oavsiktlig förflyttning av händerna.

• Justera sökområdet automatiskt – Tillåter att sökområdet flyttar sig självt under objektidentifieringen.

• Cycle Mesh – cykler genom visualisering av de inlästa näten i sökområdet. Det här alternativet kan hjälpa användarna att justera sökrutan efter objekt som är svåra att identifiera.

  

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