Spuštění ukázkové aplikace: Android – Android Studio (Java nebo C++/NDK)
Článek
Tento rychlý start popisuje, jak spustit ukázkovou aplikaci Azure Spatial Anchors pro zařízení s Androidem pomocí Android Studia (Java nebo C++/NDK). Azure Spatial Anchors je multiplatformní vývojářská služba, která umožňuje vytvářet prostředí hybridní reality pomocí objektů, 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 ARCore pro Android, která může uložit a odvolat prostorové ukotvení.
Dozvíte se, jak provést tyto akce:
Vytvoření účtu Spatial Anchors
Konfigurace identifikátoru účtu Spatial Anchors a klíče účtu
Pokud běží v macOS, nainstalujte Git přes HomeBrew. Do jednoho řádku terminálu zadejte následující příkaz: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)". Pak spusťte brew install git a brew install git-lfs.
Pokud chcete vytvořit ukázku sady NDK, budete také muset nainstalovat sadu NDK a CMake 3.6 nebo vyšší nástroje sady SDK v android Studiu.
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í.
Začněte přípravou prostředí pro rozhraní příkazového řádku Azure:
Pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Další informace najdete v tématu Jak spustit Azure CLI v kontejneru Dockeru.
Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu. Další možnosti přihlášení najdete v tématu Přihlášení pomocí Azure CLI.
Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Využití rozšíření v Azure CLI.
Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.
Po přihlášení pomocí příkazu az account set vyberte předplatné, ve kterém chcete nastavit účet prostorových ukotvení:
az account set --subscription 00000000-0000-0000-0000-000000000000
Spuštěním příkazu az group create vytvořte skupinu prostředků nebo použijte existující skupinu prostředků:
az group create --name myResourceGroup --location eastus2
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.
az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key primary
az spatial-anchors-account key renew --resource-group myResourceGroup --name example --key secondary
Modul Az.MixedReality PowerShell je ve verzi Preview, musíte ho nainstalovat samostatně pomocí rutinyInstall-Module. Jakmile bude tento powershellový modul obecně dostupný, stane se součástí budoucích verzí modulu Az PowerShellu a bude ve výchozím nastavení dostupný v rámci Azure Cloud Shellu.
Install-Module -Name Az.MixedReality
Po přihlášení pomocí rutiny Set-AzContext vyberte předplatné, ve kterém chcete nastavit účet prostorových ukotvení:
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.
Aktuální účty prostorových ukotvení pro skupinu prostředků můžete zobrazit pomocí rutiny Get-AzSpatialAnchorsAccount :
Vyberte Otevřít existující projekt Android Studio a vyberte projekt umístěný na adrese Android/Java/.
Vyberte Otevřít existující projekt Android Studio a vyberte projekt umístěný na adrese Android/NDK/.
Konfigurace identifikátoru účtu a klíče
Dalším krokem je konfigurace aplikace tak, aby používala identifikátor účtu a klíč účtu. Zkopírovali jste je do textového editoru při nastavování prostředku Spatial Anchors.
Otevře záznam typu Android/Java/app/src/main/java/com/microsoft/sampleandroid/AzureSpatialAnchorsManager.java.
SpatialAnchorsAccountKey Vyhledejte pole a nahraďte Set me ho klíčem účtu.
SpatialAnchorsAccountId Vyhledejte pole a nahraďte Set me identifikátorem účtu.
SpatialAnchorsAccountDomain Vyhledejte pole a nahraďte Set me doménou účtu.
Otevře záznam typu Android/NDK/app/src/main/cpp/AzureSpatialAnchorsApplication.cpp.
SpatialAnchorsAccountKey Vyhledejte pole a nahraďte Set me ho klíčem účtu.
SpatialAnchorsAccountId Vyhledejte pole a nahraďte Set me identifikátorem účtu.
SpatialAnchorsAccountDomain Vyhledejte pole a nahraďte Set me doménou účtu.
Nasazení aplikace do zařízení s Androidem
Zapněte zařízení s Androidem, přihlaste se a připojte ho k počítači pomocí kabelu USB.
Na panelu nástrojů Android Studio vyberte Spustit .
V dialogovém okně Vybrat cíl nasazení vyberte zařízení s Androidem a vyberte OK , aby se aplikace spustila na zařízení s Androidem.
Podle pokynů v aplikaci umístěte ukotvení a vzpomeňte si na ukotvení.
Ukončete aplikaci výběrem možnosti Zastavit na panelu nástrojů Android Studio.
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.