rychlý start: vytvoření aplikace Unity HoloLens, která používá prostorové kotvy Azure

v tomto rychlém startu vytvoříte aplikaci Unity HoloLens, která používá prostorové kotvy Azure. Prostorové ukotvení je služba pro vývojáře napříč platformami, která umožňuje vytvářet hybridní prostředí realit s objekty, které v průběhu času trvale uchovávají jejich umístění v rámci zařízení. až budete hotovi, budete mít HoloLens aplikaci vytvořenou v Unity, která může uložit a odvolat prostorovou kotvu.

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

  • Vytvořte účet prostorových kotev.
  • Připravte nastavení sestavení Unity.
  • Nakonfigurujte identifikátor účtu prostorových ukotvení a klíč účtu.
  • exportujte projekt HoloLens Visual Studio.
  • nasaďte aplikaci a spusťte ji na zařízení HoloLens.

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

Požadavky

K provedení kroků v tomto kurzu Rychlý start je potřeba:

  • potřebujete zařízení HoloLens s povoleným vývojářským režimem . v zařízení musí být nainstalovaná aktualizace Windows 10 2020 nebo novější . pokud chcete aktualizovat na nejnovější verzi na HoloLens, otevřete aplikaci Nastavení , vyhledejte aktualizace & zabezpečení a pak vyberte vyhledat aktualizace.
  • potřebujete Windows počítač s nainstalovaným Visual Studio 2019 nebo novějším. instalace Visual Studio musí zahrnovat úlohu vývoj Univerzální platforma Windows a komponentu Windows 10 SDK (10.0.18362.0 nebo novější) . je také nutné nainstalovat git pro Windows a git LFS.
  • Musíte mít nainstalovanou Unity. Podporované verze a požadované funkce najdete na stránce nastavení projektu Unity.
  • v aplikaci musíte povolit virtuální realitu podporovanou sadou Windows Mixed Reality SDK. toto nastavení je v sestavách Nastavení > Player Nastavení > XR Nastavení.

Vytvoření Spatial Anchors prostředků

Přejděte na Azure Portal.

V levém podokně vyberte Vytvořit prostředek.

Pomocí vyhledávacího pole vyhledejte Spatial Anchors.

Snímek obrazovky zobrazující výsledky hledání Spatial Anchors

Vyberte Spatial Anchors a pak vyberte Vytvořit.

V Spatial Anchors Účet proveďte následující:

  • Zadejte jedinečný název prostředku pomocí běžných alfanumerických znaků.

  • Vyberte předplatné, ke které chcete prostředek připojit.

  • Vytvořte skupinu prostředků výběrem možnosti Vytvořit novou. Pojmechte ji myResourceGroup a pak vyberte OK.

    Skupina prostředků je logický kontejner, ve kterém se nasazují a spravují prostředky Azure, jako jsou webové aplikace, databáze a účty úložiště. Později se například můžete rozhodnout odstranit celou skupinu prostředků v jednom jednoduchém kroku.

  • Vyberte umístění (oblast), do kterého chcete prostředek umístit.

  • Výběrem možnosti Vytvořit zahajte vytváření prostředku.

Snímek obrazovky Spatial Anchors pro vytvoření prostředku

Po vytvoření prostředku se v Azure Portal zobrazí, že je vaše nasazení dokončené.

Snímek obrazovky znázorňující dokončení nasazení prostředku

Vyberte Přejít k prostředku. Teď můžete zobrazit vlastnosti prostředku.

Zkopírujte hodnotu ID účtu prostředku do textového editoru pro pozdější použití.

Snímek obrazovky s podoknem vlastností prostředku

Zkopírujte také hodnotu Domény účtu prostředku do textového editoru pro pozdější použití.

Snímek obrazovky zobrazující hodnotu domény účtu prostředku

V části Nastavení vyberte Přístupový klíč. Zkopírujte hodnotu Primární klíč, Klíč účtu, do textového editoru pro pozdější použití.

Snímek obrazovky s podoknem Klíče pro účet

Stáhněte a otevřete vzorový projekt Unity.

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

git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples

podle pokynů zde stáhněte a importujte balíčky služby ASA SDK vyžadované pro HoloLens platformu.

V Unity otevřete projekt ve složce Unity . Unity vás může vyzvat k rozdílu mezi verzí v projektu a verzí, která je na vašem počítači nainstalovaná. Toto upozornění je v pořádku, pokud je vaše verze editoru Unity novější než ta, ve které byl projekt vytvořen. Pokud je vaše verze novější, vyberte pokračovat. Pokud je vaše verze starší než ta, kterou projekt potřebuje, vyberte možnost ukončit a upgradujte svůj Editor Unity.

Snímek obrazovky s podoknem Unity

otevřete Nastavení sestavení tak, že vyberete soubor > sestavení Nastavení.

v části platforma vyberte Univerzální platforma Windows. Změňte cílové zařízení na HoloLens.

vyberte přepínač platforma pro změnu platformy na Univerzální platforma Windows. Unity vás může vyzvat k instalaci komponent podpory UWP, pokud chybí.

okno Nastavení sestavení Unity

zavřete okno Build Nastavení .

Konfigurace informací o účtu

Dalším krokem je konfigurace aplikace, aby používala informace o účtu. Dříve jste zkopírovali klíč účtu, ID účtu a hodnoty domény účtu do textového editoru, v části vytvoření prostředku prostorových kotev .

V podokně projekt , přejít na Assets\AzureSpatialAnchors.SDK\Resources .

Vyberte SpatialAnchorConfig. V podokně inspektor zadejte Account Key jako hodnotu klíč účtu prostorových kotev jako hodnotu Account ID ID účtu prostorových kotev a Account Domain jako hodnotu pro doménu účtu prostorových kotev.

exportovat projekt HoloLens Visual Studio

Otevřete nastavení sestavení výběrem File > nastavení sestavení souboru.

V části scény v sestavení zajistěte, aby všechny scény měly vedle sebe značku zaškrtnutí.

Vyberte sestavení. v dialogovém okně vyberte složku, do které chcete exportovat HoloLens Visual Studio projektu.

po dokončení exportu se zobrazí složka obsahující exportovaný HoloLens projekt.

nasazení aplikace HoloLens

Ve složce poklikejte na HELLOAR U3D. sln a otevřete projekt v Visual Studio.

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

pokud používáte HoloLens 2, použijte jako platformu řešení ARM64 místo x86.

Konfigurace sady Visual Studio

zapněte zařízení HoloLens, přihlaste se a připojte zařízení k počítači pomocí kabelu USB.

Vyberte ladit > Spustit ladění pro nasazení aplikace a spuštění ladění.

V aplikaci vyberte BasicDemo pomocí šipek a pak stiskněte tlačítko Přejít. tlačítko pro spuštění ukázky. Použijte pokyny k umístění a odvolání kotvy.

Snímek obrazovky 1 snímek obrazovky 2 snímek obrazovky   3  snímek obrazovky 4

v Visual Studio zastavte aplikaci tak, že vyberete buď zastavit ladění , nebo Shift + F5.

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 prostorových kotev. Pak jste nakonfigurovali a nasadili aplikaci, která bude ukládat a vracet prostorové kotvy. Pokud se chcete dozvědět víc o tom, jak aplikaci zlepšit, aby mohla sdílet prostorové kotvy s ostatními zařízeními, pokračujte k dalšímu kurzu.