Snabbstart: Skapa en Object Anchors från en 3D-modell

Azure Object Anchors är en hanterad molntjänst som konverterar 3D-modeller till AI-modeller som möjliggör objektmedvetna upplevelser med mixad verklighet för HoloLens. Den här snabbstarten beskriver hur du skapar en Object Anchors-modell från en 3D-modell med hjälp Azure Object Anchors-konverterings-SDK för .NET.

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:

• En Windows dator med Visual Studio 2019.
• Git för Windows.
• .NET Core 3.1 SDK.

Om du inte har en Azure-prenumerationkan du skapa ett kostnads fritt konto innan du börjar.

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.

   

Hämta 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

Konvertera en 3D-modell

Nu kan du konvertera din 3D-modell.

1. Öppna quickstarts/conversion/Conversion.sln i Visual Studio. Den här lösningen innehåller ett C#-konsolprojekt.

2. Öppna filen Configuration.cs som finns i projektroten och ersätt set-me värdena i följande fält:

   Fält	Beskrivning
   AccountDomain	Kontodomänen för det Object Anchors-konto som skapades ovan.
   AccountId	Konto-ID för den Object Anchors som skapades ovan.
   AccountKey	Primärnyckeln för det Object Anchors kontot som skapades ovan

   Det finns ytterligare fyra fält som måste verifieras:

   Fält	Beskrivning
   InputAssetPath	Den absoluta sökvägen till en 3D-modell på den lokala datorn. Filformat som stöds är fbx , , , och ply obj glb gltf .
   AssetDimensionUnit	Måttenheten för din 3D-modell. Alla måttenheter som stöds kan nås med Azure.MixedReality.ObjectAnchors.Conversion.AssetLengthUnit hjälp av uppräkningen.
   Gravitation	Riktningen för 3D-modellens allvarlighetsvektor. Den här 3D-vektorn ger den nedåtriktade riktningen i modellens koordinatsystem. Om till exempel negativt y representerar den nedåtriktade riktningen i modellens 3D-utrymme är det här värdet Vector3(0.0f, -1.0f, 0.0f) .

3. Skapa och kör projektet för att ladda upp 3D-modellen, registrera ett nytt konverteringsjobb med tjänsten och vänta tills det har slutförts. När jobbet har slutförts laddas Object Anchors modell ned bredvid filen som anges i InputAssetPath . Du bör se något som liknar följande konsolutdata:

    Asset   : ***********
    Gravity : ***********
    Unit    : ***********
    Attempting to upload asset...
    Attempting to create asset conversion job...
    Successfully created asset conversion job. Job ID: ***********
    Waiting for job completion...
   
    Asset conversion job completed successfully.
    Attempting to download result as '***********'...
    Success!
   

   Anteckna jobb-ID:t för framtida bruk. Det kan vara användbart vid felsökning eller felsökning.

4. När jobbet har slutförts bör du se en fil med formatet på <Model-Filename-Without-Extension>_<JobID>.ou den angivna utdataplatsen. Om ditt 3D-modellfilnamn till exempel är och ditt jobb-ID är det filnamn som chair.ply tjänsten matar ut blir 00000000-0000-0000-0000-000000000000 chair_00000000-0000-0000-0000-000000000000.ou .

Felkoder

Mer information om de olika felkoder som kan uppstå från ett misslyckat tillgångskonverteringsjobb och hur du hanterar var och en finns på sidan med felkoder för konvertering.

Rensa resurser

I de föregående stegen skapade du Azure-resurser i en resursgrupp. Om du inte tror att du behöver dessa resurser i framtiden, kan du ta bort dem genom att ta bort resursgruppen.

Från Azure Portal-menyn eller Start sidan väljer du resurs grupper. På sidan resurs grupper väljer du sedan myResourceGroup.

På sidan myResourceGroup kontrollerar du att de listade resurserna är de som du vill ta bort.

Välj ta bort resurs grupp, Skriv myResourceGroup i text rutan för att bekräfta och välj sedan ta bort.

Nästa steg

I den här snabbstarten skapade du ett Object Anchors konto och konverterade en 3D-modell för att skapa en Object Anchors modell. Om du vill lära dig hur du integrerar modellen Object Anchors SDK i din mixed reality-app fortsätter du med någon av följande artiklar: