Spuštění ukázkové aplikace: HoloLens – Unity (C#)
V tomto rychlém startu spustíte ukázkovou aplikaci Azure Spatial Anchors pro HoloLens pomocí Unity (C#). Spatial Anchors je multiplatformní vývojářská služba, která umožňuje vytvářet prostředí hybridní reality s objekty, které v průběhu času uchovávají jejich umístění na různých zařízeních. Až budete hotovi, budete mít aplikaci HoloLens vytvořenou pomocí Unity, která dokáže uložit a odvolat prostorové ukotvení.
Získáte následující informace:
- Vytvořte účet Spatial Anchors.
- Příprava nastavení sestavení Unity
- Nakonfigurujte identifikátor účtu Spatial Anchors a klíč účtu.
- Exportujte projekt HoloLens sady 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 Azure 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 režimem vývojáře. V případě HoloLens 2 musí být na zařízení nainstalovaná aktualizace Windows 10 z května 2020 nebo novější . Pokud chcete aktualizovat na nejnovější verzi v HoloLensu, otevřete aplikaci Nastavení, přejděte na Aktualizovat a zabezpečení a pak vyberte Vyhledat aktualizace.
- Potřebujete počítač s Windows s nainstalovanou sadou Visual Studio 2019 nebo novější. Instalace sady Visual Studio musí obsahovat sadu funkcí pro vývoj Univerzální platforma Windows a sadu Windows 10 SDK (10.0.18362.0 nebo novější). Musíte také nainstalovat Git pro Windows a Git LFS.
- Musíte mít nainstalovaný Unity. Informace o podporovaných verzích a požadovaných možnostech najdete na stránce nastavení projektu Unity.
Vytvoření prostředku Spatial Anchors
Přejděte na Azure Portal.
V levém podokně vyberte Vytvořit prostředek.
Pomocí vyhledávacího pole vyhledejte Spatial Anchors.
Vyberte Spatial Anchors a pak vyberte Vytvořit.
V podokně Účet prostorových ukotvení postupujte takto:
Zadejte jedinečný název prostředku pomocí běžných alfanumerických znaků.
Vyberte předplatné, ke kterému chcete prostředek připojit.
Výběrem možnosti Vytvořit novou vytvořte skupinu prostředků. Pojmenujte ji myResourceGroup a pak vyberte OK.
Skupina prostředků je logický kontejner, do kterého 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 zahájíte vytváření prostředku.
Po vytvoření prostředku se na webu Azure Portal zobrazí, že je vaše nasazení dokončené.
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í.
Zkopírujte také hodnotu domény účtu prostředku do textového editoru pro pozdější použití.
V části Nastavení vyberte Přístupový klíč. Zkopírujte hodnotu primárního klíče Account Key (Klíč účtu) do textového editoru pro pozdější použití.
Stažení ukázkového projektu a import sady SDK
Úložiště klonování ukázek
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
Import ASA SDK
Podle zde uvedených pokynů stáhněte a naimportujte balíčky ASA SDK vyžadované pro platformu HoloLens.
Konfigurace Unity
V Unity otevřete projekt ve složce Unity . Unity vás může vyzvat k rozdílu mezi verzí v projektu a verzí nainstalovanou na vašem počítači. Toto upozornění je v pořádku, pokud je vaše verze Unity Editoru novější než verze, se kterou byl projekt vytvořen. Pokud je vaše verze novější, vyberte Pokračovat. Pokud je vaše verze starší než ta, která projekt potřebuje, vyberte Ukončit a upgradovat Unity Editor.
Otevřete Nastavení sestavení výběrem Nastavení sestavení souboru>.
V části Platforma vyberte Univerzální platforma Windows. Změňte cílové zařízení na HoloLens.
Vyberte Přepnout platformu a změňte platformu na Univerzální platforma Windows. Unity vás může vyzvat k instalaci komponent podpory UPW, pokud chybí.
Zavřete okno Nastavení sestavení.
Konfigurace informací o účtu
Dalším krokem je konfigurace aplikace tak, aby používala informace o vašem účtu. V části Vytvoření prostředku Spatial Anchors jste zkopírovali hodnoty klíče účtu, ID účtu a domény účtu do textového editoru.
V podokně Projekt přejděte na Assets\AzureSpatialAnchors.SDK\Resources.
Vyberte SpatialAnchorConfig. V podokně inspektoruAccount Key zadejte jako hodnotu pro klíč účtu Spatial Anchors, Account ID jako hodnotu PRO ID účtu Spatial Anchors a Account Domain jako hodnotu pro doménu účtu Spatial Anchors.
Export projektu HoloLens sady Visual Studio
Otevřete Nastavení sestavení výběrem Nastavení sestavení souboru>.
V části Scény v sestavení se ujistěte, že všechny scény mají vedle nich značku zaškrtnutí.
Vyberte Sestavit. V dialogovém okně vyberte složku, ve které chcete exportovat projekt HoloLens Visual Studio.
Po dokončení exportu se zobrazí složka obsahující exportovaný projekt HoloLens.
Nasazení aplikace HoloLens
Ve složce poklikejte na HelloAR U3D.sln a otevřete projekt v sadě Visual Studio.
Změňte konfiguraci řešení na Vydání, změňte platformuřešení na x86 a v možnostech cíle nasazení vyberte zařízení.
Pokud používáte HoloLens 2, místo x86 použijte ARM64 jako platformu řešení.
Zapněte zařízení HoloLens, přihlaste se a připojte zařízení k počítači pomocí kabelu USB.
>Vyberte Spustit ladění a nasaďte aplikaci a spusťte ladění.
V aplikaci vyberte BasicDemo pomocí šipek a pak stisknutím tlačítka Přejít! spusťte ukázku. Postupujte podle pokynů k umístění a odvolání ukotvení.
V sadě Visual Studio zastavte aplikaci výběrem příkazu 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 webu Azure Portal nebo na domovské stránce vyberte skupiny prostředků. Potom 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 , abyste ji potvrdili, a pak vyberte Odstranit.
Další kroky
V tomto rychlém startu jste vytvořili účet Spatial Anchors. Pak jste nakonfigurovali a nasadili aplikaci pro ukládání a odvolávání prostorových ukotvení. Další informace o tom, jak aplikaci vylepšit, aby mohl sdílet prostorové kotvy s dalšími zařízeními, najdete v dalším kurzu.