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 för mixad verklighet för HoloLens. När du är klar har du en HoloLens-app skapad med Unity som kan identifiera objekt i den fysiska världen.

Du lär dig att:

• Förbered Unity-bygginställningar.
• Exportera HoloLens Visual Studio-projektet.
• Distribuera appen och kör den på en HoloLens 2-enhet.

Förutsättningar

Kontrollera att du har följande för genomföra den här snabbstarten:

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

Skapa ett Object Anchors-konto

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

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

   

2. Sök efter object anchors-resursen.

   Sök efter "Object Anchors".

   

   På resursen Object Anchors i sökresultatet väljer du Skapa –> Objektfästpunkter.

   

3. I dialogrutan Object Anchors Account (Objektankarkonto):

   • Ange ett unikt resursnamn.
   • Välj den prenumeration som du vill koppla resursen till.
   • Skapa eller använd 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 din enhet

Om du vill distribuera appar till holoLens måste du para ihop Dina HoloLens med datorn.

1. I HoloLens navigerar du till Inställningar –> Uppdatera och säkerhet –> 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.

Ladda upp 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 Object Anchors-modell följer du anvisningarna i Skapa en modell för att skapa en. Gå sedan tillbaka hit.

När HoloLens är aktiverat och anslutet till utvecklingsenheten (PC) följer du dessa steg för att ladda upp en modell till mappen 3D Objects på HoloLens:

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

2. Tryck på Windows-tangenten och E tillsammans (Win + E) för att starta Istraživač datoteka. Du bör se dina HoloLens med andra enheter och mappar i det vänstra fönstret.

   

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

   

4. I Istraživač datoteka går du till 3D-objekt för intern lagring>. Nu kan du klistra in dina modeller i mappen 3D-objekt genom att trycka på Ctrl och V tillsammans (Ctrl + V).

   

Öppna exempelprojektet

Klona exempellagringsplatsen 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-paketet för Unity.

Webbnedladdning

Leta upp Azure Object Anchors-paketet för Unity (com.microsoft.azure.object-anchors.runtime) här. Välj den version du vill ha och ladda ned paketet med knappen Ladda ned .

NPM-nedladdning

Det här steget kräver att NPM är installerat och tillgängligt.

Kör följande kommando som <version_number> ersätter med den version av Azure Object Anchors som du vill ladda ned:

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/

Kommentar

Kör följande om du vill visa en lista över tillgängliga versioner av Azure Object Anchors-paketet:

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

Azure Object Anchors-paketet laddas ned till mappen där du körde kommandot.

Funktionsverktyg för Mixad verklighet (beta)

Fortsätt till nästa steg. Du använder funktionsverktyget för Mixed Reality i ett senare steg.

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

Webbnedladdning

Följ anvisningarna här för att importera Azure Object Anchors-paketet som du laddade ned till Unity-projektet med hjälp av Unity-Upravljač za pakete.

NPM-nedladdning

Följ anvisningarna här för att importera Azure Object Anchors-paketet som du laddade ned till Unity-projektet med hjälp av Unity-Upravljač za pakete.

Funktionsverktyg för Mixad verklighet (beta)

Det här steget kräver att funktionsverktyget för Mixed Reality laddas ned och är tillgängligt.

Kommentar

Funktionsverktyget för Mixad verklighet stöder för närvarande endast Windows.

1. Följ dokumentationen för Funktionsverktyg för Mixad verklighet för att konfigurera verktyget och lära dig hur du använder det.
2. Installera funktionspaketet "Microsoft Azure Object Anchors" i Unity-projektmappen.

Konfigurera kontoinformationen

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

I fönstret Projekt går du till Assets\AzureObjectAnchors.SDK\Resources.

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

Kompilera och köra appen

Skapa exempelscenen

I Unity Editor navigerar du till Tillgångar/MixedReality.AzureObjectAnchors/Scenes och öppnar AOASampleScene och lägger till det i scenversionslistan.

Välj 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. Se till att endast AOASampleScene har en bockmarkering bredvid sig: alla andra scener ska inte inkluderas.

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

Skapa och distribuera appen

.sln Öppna filen som genereras av Unity. Ändra byggkonfigurationen till följande.

Därefter måste du konfigurera IP-adressen för fjärrdatorn för att distribuera och felsöka appen.

Högerklicka på appprojektet och välj Egenskaper. På egenskapssidan väljer du Konfigurationsegenskaper –> Felsökning. Ändra värdet Datornamn till din HoloLens-enhets IP-adress och klicka på Använd.

Stäng egenskapssidan. Klicka på Fjärrdator. Appen bör börja skapa och distribuera till din fjärrenhet. Kontrollera att enheten är aktiv.

Efter unity-välkomstskärmen visas ett meddelande som anger att objektobservatören har initierats.

Appen söker efter objekt i det aktuella visningsfältet och spårar dem sedan 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, till exempel ID, uppdaterad tidsstämpel och yttäckningsförhållande.

Felsökning

Tips

Om objektet inte identifieras kan du prova följande steg:

1. Kontrollera att du använder rätt modell för objektet.
2. Visualisera sökområdet och se till att det täcker målobjektet.
3. Försök att minska MinSurfaceCoverage.
4. I Windows-enhetsportalen klickar du på Vyer –> 3D-vyer och kontrollerar om genomsökningen är klar.

Nästa steg

Unity HoloLens med MRTK

Begrepp: Översikt över SDK

Vanliga frågor och svar

Konverterings-SDK

Felsöka objektidentifiering