Quickstart: Een nieuw Object Anchors maken van een 3D-model

Azure Object Anchors is een beheerde cloudservice die 3D-modellen converteert naar AI-modellen die objectbewuste mixed reality voor de HoloLens. In deze quickstart wordt be behandelt hoe u een Object Anchors maakt op basis van een 3D-model met behulp van de Azure Object Anchors Conversion SDK voor .NET.

U leert het volgende:

Vereisten

Zorg ervoor dat u over het volgende beschikt om deze snelstart te voltooien:

• Een Windows machine met Visual Studio 2019.
• Git voor Windows.
• De .NET Core 3.1-SDK.

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

Een Object Anchors maken

Eerst moet u een account maken met de Object Anchors service.

1. Ga naar de Azure Portal selecteer Een resource maken.

   

2. Zoek de Object Anchors resource.

   Zoek naar 'Object Anchors'.

   

   Selecteer op Object Anchors resource in de zoekresultaten Maken -> Object Anchors.

   

3. In het Object Anchors account:

   • Voer een unieke resourcenaam in.
   • Selecteer het abonnement waar u de resource aan wilt koppelen.
   • Maak of gebruik een bestaande resourcegroep.
   • Selecteer de regio waarin u uw resource wilt hebben.

   

   Selecteer Maken om te beginnen met het maken van de resource.

4. Zodra de resource is gemaakt, selecteert u Naar de resource gaan.

   

5. Op de overzichtspagina:

   Noteer het accountdomein. U hebt deze later nodig.

   

   Noteer de account-id. U hebt deze later nodig.

   

   Ga naar de pagina Toegangssleutels en noteer de primaire sleutel. U hebt deze later nodig.

   

Het voorbeeldproject op te halen

Voer de volgende opdrachten uit om de opslagplaats met voorbeelden te klonen:

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

cd ./azure-object-anchors

Een 3D-model converteren

Nu kunt u uw 3D-model gaan converteren.

1. Open quickstarts/conversion/Conversion.sln in Visual Studio. Deze oplossing bevat een C#-consoleproject.

2. Open het Configuration.cs bestand in de hoofdmap van het project en vervang de set-me waarden in de volgende velden:

   Veld	Beschrijving
   AccountDomain	Het accountdomein van het Object Anchors account dat hierboven is gemaakt.
   AccountId	De account-id van het Object Anchors account dat hierboven is gemaakt.
   AccountKey	De primaire sleutel van het Object Anchors account dat hierboven is gemaakt

   Er zijn vier extra velden die moeten worden geverifieerd:

   Veld	Beschrijving
   InputAssetPath	Het absolute pad naar een 3D-model op uw lokale computer. Ondersteunde bestandsindelingen fbx zijn , , , en ply obj glb gltf .
   AssetDimensionUnit	De maateenheid van uw 3D-model. Alle ondersteunde maateenheden zijn toegankelijk met behulp van Azure.MixedReality.ObjectAnchors.Conversion.AssetLengthUnit de -enumeratie.
   Zwaartekracht	De richting van de ernstvector van het 3D-model. Deze 3D-vector geeft de omlaag richting in het coördinatensysteem van uw model. Als negatief bijvoorbeeld de omlaag richting in de 3D-ruimte van het y model vertegenwoordigt, zou deze waarde Vector3(0.0f, -1.0f, 0.0f) zijn.

3. Bouw het project en voer het uit om uw 3D-model te uploaden, registreer een nieuwe conversie job bij de service en wacht tot deze is voltooid. Zodra de taak is voltooid, wordt Object Anchors het model gedownload naast het bestand dat is opgegeven in InputAssetPath de . Als het goed is, ziet u iets dat lijkt op de volgende console-uitvoer:

    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!
   

   Noteer de taak-id voor toekomstig gebruik. Dit kan handig zijn bij het oplossen van fouten of het oplossen van problemen.

4. Zodra de taak is voltooid, ziet u een bestand met de indeling <Model-Filename-Without-Extension>_<JobID>.ou in de opgegeven uitvoerlocatie. Als de bestandsnaam van uw 3D-model bijvoorbeeld is en uw taak-id de bestandsnaam is, wordt de uitvoer van de chair.ply 00000000-0000-0000-0000-000000000000 service chair_00000000-0000-0000-0000-000000000000.ou .

Foutcodes

Raadpleeg de pagina met conversiefoutcodes voor meer informatie over de verschillende foutcodes die kunnen worden veroorzaakt door een mislukte assetconversie en hoe u deze kunt afhandelen.

Resources opschonen

In de voorgaande stappen hebt u Azure-resources in een resourcegroep gemaakt. Als u deze resources in de toekomst waarschijnlijk niet nodig hebt, kunt u ze verwijderen door de resourcegroep te verwijderen.

Selecteer Resourcegroepen in het menu of op de beginpagina van de Azure-portal. Selecteer myResourceGroup op de pagina Resourcegroepen.

Controleer op de pagina myResourceGroup of de weergegeven resources de resources zijn die u wilt verwijderen.

Selecteer Resourcegroep verwijderen, typ myResourceGroup in het tekstvak om dit te bevestigen en selecteer Verwijderen.

Volgende stappen

In deze quickstart hebt u een Object Anchors gemaakt en een 3D-model geconverteerd om een Object Anchors maken. Als u wilt weten hoe u dat model integreert met de Object Anchors SDK in uw mixed reality-app, gaat u verder met een van de volgende artikelen: