Tento rychlý start popisuje, jak vytvořit aplikaci pro Android s Xamarinem pomocí Azure Spatial Anchors. Azure Spatial Anchors je vývojářská služba pro různé platformy, která umožňuje vytvářet prostředí hybridní reality pomocí objektů, které zachytává jejich umístění napříč zařízeními v průběhu času. Až budete hotovi, budete mít aplikaci pro Android, která dokáže uložit a odvolat prostorovou kotvu.
Dozvíte se, jak provést tyto akce:
Vytvoření Spatial Anchors účtu
Konfigurace Spatial Anchors účtu a klíče účtu
Nasazení a spuštění na zařízení s Androidem
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í:
Nejnovější verze Xamarin.Android nainstalovaná a spuštěná na platformě podle vašeho výběru. Průvodce instalací Xamarin.Android najdete v průvodcích instalací Xamarin.Android.
Pomocí vyhledávacího pole vyhledejte 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.
Po vytvoření prostředku se v 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í klíč,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 tomu dáváte přednost, můžete nainstalovat Azure CLI a spouštět referenční příkazy CLI.
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í jsou popsané 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 spatial anchors:
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, 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.
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 PowerShellu je ve verzi Preview, ale musíte ho nainstalovat samostatně pomocí rutiny Install-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 spatial anchors:
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.
Vyhledejte SpatialAnchorsAccountKey pole a Set me nahraďte klíčem účtu.
Vyhledejte SpatialAnchorsAccountId pole a Set me nahraďte identifikátorem účtu.
Vyhledejte SpatialAnchorsAccountDomain pole a Set me nahraďte doménou účtu.
Nasazení aplikace do zařízení s Androidem
Na zařízení s Androidem se přihlaste a připojte ho k počítači pomocí kabelu USB.
Nastavte spouštěný projekt na SampleXamarin.Android, změňte Konfiguraci řešení na Vypustit a v rozevíracím seznamu selektoru zařízení vyberte zařízení, na které chcete nasazení nasadit.
Vyberte > Ladit Spustit ladění a nasaďte a spusťte aplikaci.
Pokud chcete aplikaci nasadit a > spustit, vyberte Spustit spustit bez ladění.
V aplikaci vyberte Základní, aby se spouštěl ukázka, a podle pokynů umístěte a odpomeňte si ukotvení.
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.
