rychlý start: vytvoření aplikace HoloLens s použitím kotev objektů Azure v C++/WinRT a DirectX

tento rychlý start popisuje, jak vytvořit aplikaci HoloLens pomocí kotev objektů Azure v C++/WinRT a DirectX. Kotvy objektů Azure je spravovaná cloudová služba, která převádí 3D prostředky na modely AI, které umožňují objektově pracujícím prostředím pro HoloLens. až budete hotovi, budete mít HoloLens aplikaci, která dokáže detekovat objekt a jeho pozice v holografické aplikaci rozhraní DirectX 11 (Universal Windows).

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

  • vytvoření a navýšení zátěže HoloLens aplikace
  • Zjištění objektu a vizualizace jeho modelu

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

Požadavky

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

  • Fyzický objekt ve vašem prostředí a jeho 3D model (buď CAD, nebo naskenovaný).
  • Windows počítač s následujícím nainstalovaným:
  • zařízení HoloLens 2, které je aktuální a má povolený režim pro vývojáře .
    • pokud chcete aktualizovat na nejnovější verzi na HoloLens, otevřete aplikaci Nastavení , vyhledejte aktualizace & zabezpečení a pak vyberte vyhledat aktualizace.

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.

Upload modelu

Před spuštěním aplikace je potřeba, abyste pro aplikaci měli k dispozici modely. Pokud ještě nemáte model Object Anchors, postupujte podle pokynů v tématu Vytvoření modelu a vytvořte ho. Pak se vraťte sem.

Po HoloLens a připojení k vývojovému zařízení (PC) nahrajte model do složky 3D Objects (3D objekty) ve vašem HoloLens:

  1. Vyberte a zkopírujte modely, se které chcete pracovat, stisknutím kláves Ctrl a C společně (Ctrl + C).

  2. Stisknutím Windows Logo a E společně (Win + E) spusťte Průzkumník souborů. V levém podokně by HoloLens vaše zařízení uvedená s dalšími disky a složkami.

    Průzkumník souborů

  3. Klepnutím na odkaz HoloLens zobrazíte úložiště na HoloLens zařízení v pravém podokně.

    open HoloLens interní úložiště

  4. V Průzkumník souborů části Interní objekty Storage > 3D objekty. Teď můžete modely vložit do složky 3D Objects (3D objekty) stisknutím kombinace kláves Ctrl a V (Ctrl +V).

    Vložení modelů do složky 3D Objects

Otevřete vzorový projekt

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

Otevřete quickstarts/apps/directx/DirectXAoaSampleApp.sln v Visual Studio.

Změňte konfiguraci řešení na release, změňte platformu řešení na ARM64 a vyberte zařízení z možností cíle nasazení.

Konfigurace informací o účtu

Dalším krokem je konfigurace aplikace, aby používala informace o účtu. Poznamenali jste klíč účtu, ID účtu a hodnoty domény účtu v části Vytvoření účtu kotev objektů .

Otevřete Assets\ObjectAnchorsConfig.json.

Vyhledejte AccountId pole a nahraďte Set me ho vaším ID účtu.

Vyhledejte AccountKey pole a nahraďte Set me ho klíčem účtu.

Vyhledejte AccountDomain pole a nahraďte Set me ho svou doménou účtu.

Nyní Sestavte projekt AoaSampleApp kliknutím pravým tlačítkem myši na projekt a výběrem možnosti sestavit.

konfigurace Visual Studio projektu pro nasazení

Nasazení aplikace do HoloLens

Po úspěšném kompilování ukázkového projektu můžete aplikaci nasadit do HoloLens.

ujistěte se, že je zařízení HoloLens zapnuté a připojené k počítači přes kabel USB. Ujistěte se, že je zařízení vybraným cílem nasazení (viz výše).

Klikněte pravým tlačítkem na projekt AoaSampleApp a potom v místní nabídce klikněte na nasadit a nainstalujte aplikaci. pokud se v okno Výstup Visual Studio neobjeví žádná chyba, aplikace se nainstaluje na HoloLens.

Nasazení aplikace do HoloLens

Před spuštěním aplikace byste měli do složky 3D objektů na svém HoloLens nahrát například objektový model, židli. ou . pokud jste to neudělali, postupujte podle pokynů v části Upload váš model .

Pokud chcete aplikaci spustit a ladit, vyberte ladit > spustit ladění.

Ingestování objektového modelu a zjištění jeho instance

aplikace AoaSampleApp je teď spuštěná na vašem zařízení HoloLens. Procházení se blíží k cílovému objektu (křeslo) a prohledá ho tím, že se na něj podívá z více perspektiv. Mělo by se zobrazit růžový ohraničovací rámeček kolem objektu s některými žlutými body vykreslenými blízko k povrchu objektu, což znamená, že byl zjištěn.

Detekce křesla

Obrázek: zjištěná křesla vykreslená s jeho ohraničujícím rámečkem (růžová), Point Cloud (žlutá) a oblast hledání (velký žlutý rámeček).

Můžete definovat prostor pro hledání objektu v aplikaci tak, že prstem kliknete na Air buď přímo, nebo vlevo. Místo pro hledání se bude přepínat mezi koule poloměru 2 měřičů, ohraničovacím polem 4 m ^ 3 a frustum zobrazení. U větších objektů, jako jsou automobily, je nejlepší volbou obvykle použití zobrazení frustum výběru, zatímco se nacházíte na horním okraji objektu na vzdálenosti 2 měřiče. Pokaždé, když se oblast hledání změní, aplikace odstraní aktuálně sledované instance a pak se znovu pokusí o jejich vyhledání v nové oblasti hledání.

Tato aplikace může sledovat více objektů najednou. Provedete to tak, že nahrajete více modelů do složky 3D Objects vašeho zařízení a nastavíte oblast hledání, která pokrývá všechny cílové objekty. Zjišťování a sledování více objektů může trvat delší dobu.

Aplikace úzce zarovnává 3D model fyzickému protějšku. Uživatel může klepnout na své levé straně a zapnout režim sledování s vysokou přesností, který počítá přesnější pozici. Toto je stále experimentální funkce, která spotřebovává více systémových prostředků a může způsobit vyšší kolísání odhadované pozice. Klepnutím na Air znovu klepněte na levou stranu a přepněte zpátky do režimu normálního sledování.

Další kroky