Rychlý start: Vytvoření HoloLens aplikace pomocí Azure Object Anchors v Unity

V tomto rychlém startu vytvoříte aplikaci Unity pro HoloLens, která používá Azure Object Anchors. Azure Object Anchors je spravovaná cloudová služba, která převádí 3D prostředky na modely AI, které umožňují prostředí hybridní reality podporující objekty pro HoloLens. Až budete hotovi, budete mít aplikaci vytvořenou HoloLens Unity, která dokáže detekovat objekty ve fyzickém světě.

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

  • Příprava nastavení sestavení Unity
  • Exportujte projekt HoloLens Visual Studio.
  • Nasaďte aplikaci a spusťte ji na zařízení HoloLens 2.

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ý).
  • Počítač se systémem Windows s následujícím nainstalovaným:
  • Zařízení HoloLens 2, které je aktuální a má povolený režim pro vývojáře .
    • Chcete-li provést aktualizaci na nejnovější verzi na HoloLens, otevřete aplikaci Nastavení , pokračujte na 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.

Nastavení zařízení

K nasazení aplikací do HoloLens je potřeba spárovat svůj HoloLens s vaším počítačem.

  1. V pracovním HoloLens přejděte do Nastavení-> Update & Security-> pro vývojáře.
  2. Klikněte na spárovat a nechte obrazovku otevřenou, dokud do sady Visual Studio během prvního nasazení NEZADÁTE kód PIN.

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ření 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

Dalším krokem je stažení balíčku Azure Object Anchors pro Unity.

Najděte Azure Object Anchors pro Unity ( com.microsoft.azure.object-anchors.runtime ) tady. Vyberte požadovanou verzi a stáhněte balíček pomocí tlačítka Stáhnout.

V Unity otevřete quickstarts/apps/unity/basic projekt.

postupujte podle pokynů uvedených tady a importujte balíček kotev objektů Azure, který jste stáhli do projektu unity, pomocí Správce balíčků Unity.

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ů .

v podokně Project přejít na Assets\AzureObjectAnchors.SDK\Resources .

Vyberte ObjectAnchorsConfig. V podokně inspektor zadejte Account Key hodnotu jako hodnota pro klíč účtu kotvy objektů, Account ID jako hodnotu ID účtu kotvy objektu a Account Domain jako hodnotu pro doménu účtu kotvy objektů.

Sestavte a spusťte aplikaci.

Sestavení ukázkové scény

V editoru Unity přejděte na assets/MixedReality. AzureObjectAnchors/scénys a otevřete AOASampleScene a přidejte ho do seznamu sestavení scény.

Vyberte soubor – > sestavování nastavení. Vyberte Univerzální platforma Windows a pak vyberte přepínač platforma. Pokud Editor Unity říká, že potřebujete nejdřív stáhnout některé součásti, Stáhněte si je a nainstalujte. Pomocí níže uvedeného snímku obrazovky nakonfigurujte nastavení sestavení. Zajistěte , aby se u AOASampleScene zavedlo zaškrtnutí na všechny ostatní scény.

nastavení sestavení

Vyberte sestavení a vyberte výstupní složku. Nyní můžete vygenerovat projekt VS ve výstupní složce.

Sestavení a nasazení aplikace

Otevřete .sln soubor vygenerovaný Unity. Změňte konfiguraci buildu na následující.

konfigurace sestavení

V dalším kroku budete muset nakonfigurovat IP adresu vzdáleného počítače pro nasazení a ladění aplikace.

Klikněte pravým tlačítkem na projekt aplikace a vyberte vlastnosti. Na stránce Vlastnosti vyberte možnost Vlastnosti konfigurace-> ladění. Změňte hodnotu název počítače na IP adresu vašeho zařízení HoloLens a klikněte na použít.

vzdálené ladění

Zavřete stránku vlastností. Klikněte na vzdálený počítač. Aplikace by měla začít sestavovat a nasazovat na vzdálené zařízení. Ujistěte se, že je zařízení aktivní.

Po úvodní obrazovce Unity se zobrazí zpráva oznamující inicializaci pozorovatele objektů.

Aplikace hledá objekty v aktuálním poli zobrazení a po zjištění je sleduje. Instance se odebere, když se nachází 6 metrů od polohy uživatele. Text ladění zobrazuje podrobnosti o instanci, jako je ID, aktualizované časové razítko a poměr pokrytí plochy.

Řešení potíží

Tipy

Pokud se objekt nedetekuje, můžete vyzkoušet následující postup:

  1. Dvakrát ověřte, že používáte správný model pro váš objekt.
  2. Vizualizujte oblast hledání a ujistěte se, že pokrývá cílový objekt.
  3. Zkuste snížit MinSurfaceCoverage .
  4. Na portálu zařízení s Windows klikněte na zobrazení-> prostorové zobrazení a ověřte, jestli se kontrola dokončila.

Další kroky