Snabbstart: Skapa en HoloLens med Azure Object Anchors, i C++/WinRT och DirectX
Den här snabbstarten beskriver hur du skapar en HoloLens-app med Azure Object Anchors i C++/WinRT och DirectX. 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 HoloLens-app som kan identifiera ett objekt och dess attityd i ett Holographic DirectX 11-program (Universal Windows).
Du lär dig följande:
- Skapa och läsa in ett HoloLens program
- Identifiera ett objekt och visualisera dess modell
Om du inte har en Azure-prenumerationkan du skapa ett kostnads fritt konto innan du börjar.
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 genomsökt).
- En Windows dator med följande installerat:
- Git för Windows
- Visual Studio 2019 med arbetsbelastningen Universal Windows Platform Development och Windows 10 SDK-komponenten (10.0.18362.0 eller nyare)
- En HoloLens 2-enhet som är uppdaterad och har aktiverat utvecklarläge.
- Om du vill uppdatera till den senaste versionen HoloLens du appen Inställningar, går till Uppdatera & Security 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.
Gå till Azure Portal och välj Skapa en resurs.
Sök efter Object Anchors resurs.
Sök efter "Object Anchors".
På Object Anchors i sökresultatet väljer du Skapa -> Object Anchors.
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.
När resursen har skapats väljer du Gå till resurs.
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.
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:
Markera och kopiera de modeller som du vill arbeta med genom att trycka på Ctrl-tangenten och C tillsammans (Ctrl + C).
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.
Tryck på HoloLens länken för att visa lagringen HoloLens enheten i den högra rutan.
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
Öppna quickstarts/apps/directx/DirectXAoaSampleApp.sln i Visual Studio.
Ändra Lösningskonfiguration till Version, ändra Lösningsplattform till ARM64 och välj Enhet bland distributionsmålalternativen.
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 Object Anchors ett konto".
Öppna Assets\ObjectAnchorsConfig.json.
Leta upp AccountId fältet och ersätt med ditt Set me konto-ID.
Leta upp AccountKey fältet och ersätt med din Set me kontonyckel.
Leta upp AccountDomain fältet och ersätt med din Set me kontodomän.
Skapa nu AoaSampleApp-projektet genom att högerklicka på projektet och välja Skapa.
Distribuera appen till HoloLens
När du har kompilerat exempelprojektet kan du distribuera appen till HoloLens.
Se till HoloLens enheten är påslagen och ansluten till datorn via en USB-kabel. Kontrollera att Enhet är det valda distributionsmålet (se ovan).
Högerklicka på AoaSampleApp-projektet och klicka sedan på Distribuera på popup-menyn för att installera appen. Om inget fel visas Visual Studio i fönstret Utmatning installeras appen på HoloLens.
Innan du startar appen bör du ha laddat upp en objektmodell, t.ex. till mappen 3D-objekt på din HoloLens. Om du inte har gjort det följer du anvisningarna i avsnittet "Upload din modell".
Om du vill starta och felsöka appen väljer du > starta felsökning.
Mata in objektmodellen och identifiera dess instans
AoaSampleApp-appen körs nu på din HoloLens enhet. Gå nära (inom 2 meter avstånd) till målobjektet (avslutas) och skanna det genom att titta på det från flera perspektiv. Du bör se en rosa markeringsruta runt objektet med några gula punkter som återges nära objektets yta, vilket indikerar att det har identifierats.
Bild: en upptäckt återgivning med sin avgränsade ruta (rosa), punktmoln (gult) och ett sökområde (stor gul ruta).
Du kan definiera ett sökutrymme för objektet i appen genom att fingerklicka i luften med antingen höger eller vänster hand. Sökutrymmet växlar mellan en sfär med radie på 2 meter, en begränsningsruta på 4 m^3 och en vy frustum. För större objekt, till exempel bilar, är det bästa valet vanligtvis att använda vyn frustum när du står mot ett hörn av objektet på ungefär ett 2-mätaravstånd. Varje gång sökområdet ändras tar appen bort instanser som håller på att spåras och försöker sedan hitta dem igen i det nya sökområdet.
Den här appen kan spåra flera objekt samtidigt. Det gör du genom att ladda upp flera modeller till mappen 3D-objekt på enheten och ange ett sökområde som omfattar alla målobjekt. Det kan ta längre tid att identifiera och spåra flera objekt.
Appen anpassar en 3D-modell till sin fysiska motsvarighet nära. En användare kan trycka i luften med vänster hand för att aktivera spårningsläget med hög precision, vilket beräknar en mer exakt attityd. Det här är fortfarande en experimentell funktion som förbrukar mer systemresurser och kan resultera i högre jitter i den uppskattade attityden. Tryck i luften igen med vänster hand för att växla tillbaka till det normala spårningsläget.