Rychlý Start: vytvoření modelu ukotvení objektů z 3D model

Kotvy objektů Azure je spravovaná cloudová služba, která převádí 3D modely na modely AI, které umožňují objektově pracujícím hybridnímu zobrazení realit pro HoloLens. V tomto rychlém startu se dozvíte, jak vytvořit model ukotvení objektů z 3D model pomocí sady Azure pro převod kotev objektů pro .NET.

Dozvíte se, jak provést tyto akce:

Požadavky

Abyste mohli absolvovat tento rychlý start, ujistěte se, že máte následující:

Pokud ještě nemáte předplatné Azure,vytvořte si bezplatný účet před tím, než začnete.

Vytvoření účtu pro kotvy objektů

Nejprve je třeba vytvořit účet se službou kotvy objektů.

  1. Otevřete Azure Portal a vyberte vytvořit prostředek.

    Vytvořit nový prostředek

  2. Vyhledejte prostředek kotvy objektů .

    Vyhledejte "kotvy objektů".

    Vyberte prostředek ukotvení objektů.

    Ve výsledcích hledání objektu kotvy objektů vyberte kotvy objektů Create->.

    Vytvoření prostředku ukotvení objektů

  3. V dialogovém okně účet kotvy objektů :

    • Zadejte jedinečný název prostředku.
    • Vyberte předplatné, ke kterému chcete prostředek připojit.
    • Vytvořte nebo použijte existující skupinu prostředků.
    • Vyberte oblast, ve které se má prostředek vyskytovat.

    Zadejte podrobnosti účtu zdroje kotev objektů.

    Vyberte vytvořit a začněte vytvářet prostředek.

  4. Jakmile bude prostředek vytvořen, vyberte Přejít k prostředku.

    Přejít k prostředku

  5. Na stránce Přehled:

    Poznamenejte si doménu účtu. Budete ho potřebovat později.

    Zkopírujte doménu účtu pro prostředek ukotvení objektu.

    Poznamenejte si ID účtu. Budete ho potřebovat později.

    Zkopírujte ID účtu pro prostředek ukotvení objektu.

    Přejděte na stránku přístupové klíče a poznamenejte si primární klíč. Budete ho potřebovat později.

    Zkopírujte klíč účtu pro prostředek ukotvení objektu.

Získání ukázkového projektu

Naklonujte úložiště ukázek spuštěním následujících příkazů:

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

cd ./azure-object-anchors

Převést 3D model

Nyní můžete pokračovat a převést 3D model.

  1. Otevřete quickstarts/conversion/Conversion.sln v Visual Studio. Toto řešení obsahuje projekt konzoly jazyka C#.

  2. Otevřete Configuration.cs soubor umístěný v kořenovém adresáři projektu a nahraďte set-me hodnoty v následujících polích:

    Pole Description
    AccountDomain Doména účtu účtu kotvy objektů byla vytvořena výše.
    AccountId ID účtu účtu ukotvení objektu, který byl vytvořen výše.
    AccountKey Primární klíč účtu ukotvení objektu, který byl vytvořen výše

    Existují čtyři další pole, která je třeba ověřit:

    Pole Description
    InputAssetPath Absolutní cesta k 3D model v místním počítači. Podporované formáty souborů jsou fbx , ply ,, a obj glb gltf .
    AssetDimensionUnit Jednotka měření 3D model. Ke všem podporovaným jednotkám měření se dá dostat pomocí Azure.MixedReality.ObjectAnchors.Conversion.AssetLengthUnit výčtu.
    Gravitace Směr vektoru gravitace 3D model. Tento 3D vektor poskytuje směr směrem dolů v systému souřadnic vašeho modelu. Například pokud záporná y představuje směr směrem dolů v prostorovém prostoru modelu, tato hodnota by byla Vector3(0.0f, -1.0f, 0.0f) .
  3. Sestavte a spusťte projekt, abyste nahráli 3D model, zaregistrujte novou úlohu převodu se službou a počkejte, než se dokončí. Po dokončení úlohy se model ukotvení objektu stáhne vedle souboru zadaného v InputAssetPath . Měl by se zobrazit něco podobného jako u následujícího výstupu konzoly:

     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!
    

    Poznamenejte si ID úlohy pro budoucí referenci. Může být užitečné při ladění nebo řešení potíží.

  4. Po úspěšném dokončení úlohy by se měl <Model-Filename-Without-Extension>_<JobID>.ou v zadaném umístění výstupu zobrazit soubor s formátem. Pokud je například název souboru 3D model chair.ply a ID úlohy je, bude se 00000000-0000-0000-0000-000000000000 jednat o název souboru, který bude obsahovat výstupy služby chair_00000000-0000-0000-0000-000000000000.ou .

Kódy chyb

Podrobnosti o různých chybových kódech, které mohou být výsledkem úlohy převodu neúspěšného assetu a způsobu jejich zpracování, najdete na stránce kódy chyb převodu.

Vyčištění prostředků

V předchozích krocích jste vytvořili prostředky Azure ve skupině prostředků. Pokud předpokládáte, že už tyto prostředky nebudete potřebovat, můžete je odstranit tak, že odstraníte skupinu prostředků.

V nabídce Azure Portal nebo na domovské stránce vyberte skupiny prostředků. Pak na stránce skupiny prostředků vyberte myResourceGroup.

Na stránce myResourceGroup se ujistěte, že uvedené prostředky jsou ty, které chcete odstranit.

Vyberte Odstranit skupinu prostředků, do textového pole zadejte myResourceGroup a pak vyberte Odstranit.

Další kroky

V tomto rychlém startu jste vytvořili účet ukotvení objektu a převedli 3D model pro vytvoření modelu ukotvení objektů. Chcete-li se dozvědět, jak tento model integrovat se sadou SDK ukotvení objektů v aplikaci hybridní reality, pokračujte některým z následujících článků: