Rövid útmutató: Object Anchors modell létrehozása 3D modellből

Azure Object Anchors egy felügyelt felhőszolgáltatás, amely 3D-s modelleket alakít át AI-modellekké, amelyek lehetővé teszik az objektumalapú vegyes valóságú élményeket a HoloLens. Ez a rövid útmutató bemutatja, hogyan hozhat létre Object Anchors modellt egy 3D-modellből a .NET-hezkészült Azure Object Anchors Conversion SDK használatával.

A következőket fogja megtanulni:

  • Hozzon létre egy Object Anchors fiókot.
  • Konvertál egy 3D-s modellt egy Object Anchors modell létrehozásához a .NET-hez készült Azure Object Anchors Conversion SDK(NuGet) használatával.

Előfeltételek

A rövid útmutató elvégzéséhez győződjön meg arról, hogy rendelkezik az alábbiakkal:

Ha nem rendelkezik Azure- előfizetéssel, a Kezdés előtt hozzon létre egy ingyenes fiókot .

Új Object Anchors létrehozása

Először létre kell hoznia egy fiókot a Object Anchors szolgáltatással.

  1. Az erőforrás Azure Portal válassza az Erőforrás létrehozása lehetőséget.

    Új erőforrás létrehozása

  2. Keresse meg a Object Anchors erőforrást.

    Keressen rá a "Object Anchors" kifejezésre.

    Válassza ki a Object Anchors erőforrást

    A keresési Object Anchors erőforrásban válassza a Create -> Object Anchors lehetőséget.

    Erőforrás Object Anchors létrehozása

  3. A Fiók Object Anchors párbeszédpanelen:

    • Adjon meg egy egyedi erőforrásnevet.
    • Válassza ki azt az előfizetést, amelyhez csatolni szeretné az erőforrást.
    • Hozzon létre vagy használjon egy meglévő erőforráscsoportot.
    • Válassza ki azt a régiót, ahol az erőforrást meg szeretné létezni.

    Adja Object Anchors erőforrásfiók adatait

    Az erőforrás létrehozásának megkezdéséhez válassza a Létrehozás lehetőséget.

  4. Ha az erőforrás már létre lett hozva, válassza az Erőforrás megnyitása lehetőséget.

    Erőforrás megnyitása

  5. Az áttekintési oldalon:

    Jegyezze fel a fiók tartományát. Erre később még szüksége lesz.

    Másolja ki a fiók tartományát a Object Anchors erőforráshoz

    Jegyezze fel a fiókazonosítót. Erre később még szüksége lesz.

    Másolja ki a fiókazonosítót a Object Anchors erőforráshoz

    A Hozzáférési kulcsok lapon jegyezze fel az Elsődleges kulcsot. Erre később még szüksége lesz.

    Másolja ki a fiókkulcsot a Object Anchors erőforráshoz

A mintaprojekt lekérte

A minták tárházának klónozásához futtassa a következő parancsokat:

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

cd ./azure-object-anchors

3D-s modell konvertálása

Most már átalakíthatja a 3D-s modellt.

  1. Nyissa quickstarts/conversion/Conversion.sln meg a Visual Studio. Ez a megoldás egy C#-konzolprojektet tartalmaz.

  2. Nyissa meg a projekt gyökerében található fájlt, és cserélje le Configuration.cs set-me a következő mezők értékeit:

    Mező Leírás
    AccountDomain (Fióktartomány) A fent létrehozott Object Anchors fiók fióktartománya.
    AccountId A fent létrehozott Object Anchors fiók fiókazonosítója.
    AccountKey (Fiókkulcs) A fent létrehozott Object Anchors elsődleges kulcsa

    Négy további mezőt kell ellenőrizni:

    Mező Leírás
    InputAssetPath A helyi gépen található 3D modell abszolút elérési útja. Támogatott fájlformátumok: fbx , , , és ply obj glb gltf .
    AssetDimensionUnit A 3D modell mértékegysége. A támogatott mértékegységek az Azure.MixedReality.ObjectAnchors.Conversion.AssetLengthUnit enumerálással érhetők el.
    Gravitációs A 3D modell vektorának iránya. Ez a 3D-s vektor a modell koordinátarendszerében a lefelé irányuló irányt adja. Ha például a negatív érték a modell 3D-térben a lefelé irányuló irányt jelöli, ez y az érték Vector3(0.0f, -1.0f, 0.0f) lesz.
  3. Buildelje és futtassa a projektet a 3D-modell feltöltéséhez, regisztráljon egy új konverziós feladatot a szolgáltatásban, és várjon, amíg befejeződik. A feladat befejezése után a Object Anchors a fájl mellett lesz InputAssetPath letöltve. Az alábbi konzolkimenethez hasonlónak kell lennie:

     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!
    

    Jegyezze fel a feladatazonosítót későbbi referenciaként. Ez hasznos lehet hibakereséshez vagy hibaelhárításhoz.

  4. Ha a feladat sikeresen befejeződött, egy fájlnak kell lennie a megadott kimeneti <Model-Filename-Without-Extension>_<JobID>.ou helyen. Ha például a 3D-modell fájlneve , a feladat azonosítója pedig , akkor a szolgáltatás kimenete a következő chair.ply 00000000-0000-0000-0000-000000000000 fájlnév chair_00000000-0000-0000-0000-000000000000.ou lesz: .

Hibakódok

A sikertelen eszközkonverziós feladatból eredő különböző hibakódokkal és azok kezelésének részleteivel kapcsolatban tekintse meg az átalakítási hibakódokat tartalmazó oldalt.

Az erőforrások eltávolítása

Az előző lépésekben Azure-erőforrásokat hozott létre egy erőforráscsoportban. Ha várhatóan nincs szüksége ezekre az erőforrásokra a későbbiekben, az erőforráscsoport eltávolításával törölheti őket.

Az Azure Portal menüben vagy a kezdőlapon válassza az erőforráscsoportok lehetőséget. Ezután az erőforráscsoportok lapon válassza a myResourceGroup lehetőséget.

A myResourceGroup lapon győződjön meg arról, hogy a felsorolt erőforrások közül azokat törölni kívánja.

Válassza az erőforráscsoport törlése elemet, írja be a myResourceGroup szöveget a megerősítéshez, majd válassza a Törlés lehetőséget.

Következő lépések

Ebben a rövid útmutatóban létrehozott egy Object Anchors-fiókot, és egy 3D-s modellt konvertált egy Object Anchors létrehozásához. Ha meg szeretne ismerkedni azzal, hogyan integrálhatja ezt a modellt a Object Anchors SDK-val a vegyes valóságú alkalmazásba, folytassa a következő cikkekkel: