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

Azure Object Anchors is een beheerde cloudservice waarmee 3D-modellen worden geconverteerd naar AI-modellen die objectbewuste mixed reality-ervaringen voor de HoloLens mogelijk maken. In deze quickstart wordt beschreven hoe u een Object Anchors-model 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:

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

Een Object Anchors-account maken

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

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

    Create a new resource

  2. Zoek naar de objectankerresource .

    Zoek naar 'Objectankers'.

    Select the Object Anchors Resource

    Selecteer In de resource Object Anchors in de zoekresultaten de optie Maken -> Objectankers.

    Create an Object Anchors Resource

  3. In het dialoogvenster Objectankeraccount :

    • Voer een unieke resourcenaam in.
    • Selecteer het abonnement waaraan u de resource wilt koppelen.
    • Maak of gebruik een bestaande resourcegroep.
    • Selecteer de regio waarin u de resource wilt opnemen.

    Enter Object Anchors resource account details

    Selecteer Maken om de resource te maken.

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

    Go to resource

  5. Op de overzichtspagina:

    Noteer het accountdomein. U hebt deze later nodig.

    Copy the account domain for your Object Anchors resource

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

    Copy the account ID for your Object Anchors resource

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

    Copy the account key for your Object Anchors resource

Het voorbeeldproject ophalen

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

U kunt nu uw 3D-model 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 waarden in de set-me volgende velden:

    Veld Beschrijving
    AccountDomain Het accountdomein van het objectankeraccount dat hierboven is gemaakt.
    AccountId De account-id van het objectankeraccount dat hierboven is gemaakt.
    AccountKey De primaire sleutel van het objectankeraccount 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 zijnfbx, plyen objglb.
    AssetDimensionUnit De maateenheid van uw 3D-model. Alle ondersteunde maateenheden kunnen worden geopend met behulp van de Azure.MixedReality.ObjectAnchors.Conversion.AssetLengthUnit opsomming.
    Zwaartekracht De richting van de zwaartekrachtvector van het 3D-model. Deze 3D-vector geeft de neerwaartse richting in het coördinaatsysteem van uw model. Als bijvoorbeeld negatief y de neerwaartse richting in de 3D-ruimte van het model aangeeft, zou deze waarde zijn Vector3(0.0f, -1.0f, 0.0f).
    DisableDetectScaleUnits Vanaf Azure.MixedReality.ObjectAnchors.Conversion 0.3.0-beta.6worden ingesloten schaaleenheden standaard gebruikt wanneer deze beschikbaar zijn voor fbx bestanden. Dit gedrag kan worden uitgeschakeld door de waarde in te stellen op true. Deze optie wordt genegeerd voor andere bestandsindelingen dan fbx.
  3. Bouw het project en voer het uit om uw 3D-model te uploaden, registreer een nieuwe conversietaak bij de service en wacht totdat het is voltooid. Zodra de taak is voltooid, wordt het Object Anchors-model gedownload naast het bestand dat is opgegeven in de InputAssetPath. U ziet iets vergelijkbaars met 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 toekomstige naslaginformatie. Dit kan handig zijn bij het opsporen 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 op de opgegeven uitvoerlocatie. Als de bestandsnaam van uw 3D-model bijvoorbeeld is chair.ply en uw taak-id is 00000000-0000-0000-0000-000000000000 , is chair_00000000-0000-0000-0000-000000000000.oude bestandsnaam de uitvoer van de service.

Foutcodes

Voor meer informatie over de verschillende foutcodes die kunnen voortvloeien uit een mislukte assetconversietaak en hoe u deze kunt verwerken, raadpleegt u de pagina met conversiefoutcodes.

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-account gemaakt en een 3D-model geconverteerd om een Object Anchors-model te 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: