Rychlý start: Vytvoření aplikace Unity pro iOS pomocí Azure Spatial Anchors

Článek
11/24/2021
8 min ke čtení

Tento rychlý start popisuje, jak vytvořit aplikaci Unity pro iOS 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 ARKit pro iOS vytvořenou pomocí Unity, která dokáže uložit a odvolat prostorovou kotvu.

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

Vytvoření Spatial Anchors účtu
Příprava nastavení sestavení Unity
Konfigurace Spatial Anchors účtu a klíče účtu
Export projektu Xcode
Nasazení a spuštění na zařízení s iOSem

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í:

Zařízení s iOSem kompatibilní s ARKitem s podporou vývojáře
Počítač s macOS s nainstalovanou nejnovější verzí Xcode
Instalace Unity. Informace o podporovaných verzích a požadovaných možnostech najdete na stránce instalace projektu Unity.
Git nainstalovaný prostřednictvím HomeBrew. Na jeden řádek 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 a brew install git brew install git-lfs .

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.

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

Začněte přípravou prostředí pro rozhraní příkazového řádku Azure:

V nástroji použijte prostředí Bash Azure Cloud Shell.
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.

Aktuální účty spatial anchors pro skupinu prostředků můžete zobrazit pomocí příkazu az spatial-anchors-account list:
```
az spatial-anchors-account list --resource-group myResourceGroup
```
Můžete také zobrazit účty spatial anchors pro vaše předplatné:
```
az spatial-anchors-account list
```

Spuštěním příkazu az spatial-anchors-account create vytvořte účet spatial anchors:

az spatial-anchors-account create --resource-group myResourceGroup --name MySpatialAnchorsQuickStart --location eastus2

Pomocí příkazu az spatial-anchors-account show zobrazte vlastnosti prostředku:
```
az spatial-anchors-account show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
```
Zkopírujte hodnotu ID účtu prostředku a hodnotu domény účtu prostředku do textového editoru pro pozdější použití.

Spuštěním příkazu az spatial-anchors-account key show získejte primární a sekundární klíče:

az spatial-anchors-account key show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart

Zkopírujte hodnoty klíče do textového editoru pro pozdější použití.

Pokud potřebujete klíče znovu vygenerovat, použijte příkaz az spatial-anchors-account key renew:

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

Účet můžete odstranit pomocí příkazu az spatial-anchors-account delete:

az spatial-anchors-account delete --resource-group myResourceGroup --name MySpatialAnchorsQuickStart

Začněte přípravou vašeho prostředí pro Azure PowerShell:

pokud se rozhodnete použít Azure PowerShell lokálně:
- Nainstalujte modul AZ PowerShell.
- pomocí rutiny Připojení-AzAccount Připojení k účtu Azure.
Pokud se rozhodnete použít Azure Cloud Shell:
- Další informace najdete v tématu přehled Azure Cloud Shell .

Důležité

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:
```
Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
```
Spuštěním rutiny New-AzResourceGroup vytvořte skupinu prostředků nebo použijte existující skupinu prostředků:
```
New-AzResourceGroup -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.

Aktuální účty spatial anchors pro skupinu prostředků můžete zobrazit pomocí rutiny Get-AzSpatialAnchorsAccount:
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
```
Můžete také zobrazit účty spatial anchors pro vaše předplatné:
```
Get-AzSpatialAnchorsAccount
```

Spuštěním rutiny New-AzSpatialAnchorsAccount vytvořte účet spatial anchors:

New-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart -Location eastus2

Zobrazte vlastnosti prostředku pomocí rutiny Get-AzSpatialAnchorsAccount:
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
```
Zkopírujte hodnotu vlastnosti accountId a vlastnosti accountDomain do textového editoru pro pozdější použití.

Spuštěním rutiny Get-AzSpatialAnchorsAccountKey získejte primární a sekundární klíče:

Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Zkopírujte hodnoty klíče do textového editoru pro pozdější použití.

Pokud potřebujete klíče znovu vygenerovat, použijte rutinu New-AzSpatialAnchorsAccountKey:

New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Primary
New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Secondary

Účet můžete odstranit pomocí rutiny Remove-AzSpatialAnchorsAccount:

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Stažení a otevření ukázkového projektu 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

Postupujte podle těchto pokynů a stáhněte a importujte balíčky ASA SDK vyžadované pro platformu iOS.

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í výběrem File > nastavení sestavení souboru.

V části platforma vyberte iOS.

Vyberte přepínač platforma pro změnu platformy na iOS. V Unity se může zobrazit výzva k instalaci součástí podpory iOS, pokud chybí.

Snímek obrazovky okna nastavení sestavení Unity

Zavřete okno nastavení sestavení .

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.

Export projektu Xcode

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 podokně, které se otevře, vyberte složku, do které se má projekt Xcode exportovat.

Po dokončení exportu se zobrazí složka, která obsahuje exportovaný projekt Xcode.

Poznámka

Pokud se zobrazí okno se zprávou s dotazem, zda chcete nahradit nebo připojit, doporučujeme vybrat možnost připojit, protože je rychlejší. Možnost nahradit můžete vybrat jenom v případě, že měníte prostředky ve scéně. Můžete například přidat, odebrat nebo změnit vztahy nadřazenosti/podřízenosti nebo přidat, odebrat nebo změnit vlastnosti. Pokud provádíte pouze změny zdrojového kódu, musí být příkaz Append dostatečně k dispozici.

Otevřete projekt Xcode

Nyní můžete Unity-iPhone.xcodeproj projekt otevřít v Xcode.

Můžete buď spustit Xcode a otevřít exportovaný projekt, Unity-iPhone.xcodeproj nebo spustit projekt v Xcode spuštěním následujícího příkazu z umístění, kam jste projekt exportovali:

open ./Unity-iPhone.xcodeproj

Vyberte uzel root Unity-iPhone pro zobrazení nastavení projektu a pak vyberte kartu Obecné .

V části informace o nasazení ověřte, že je cíl nasazení nastavený na iOS 11,0.

Vyberte kartu možnosti podepisování & a ujistěte se, že je povoleno Automatické řízení podepisování . Pokud není, povolte ji a pak resetujte nastavení sestavení výběrem možnosti Povolit automaticky v zobrazeném podokně.

Nasazení aplikace do zařízení s iOS

Připojte zařízení s iOS k počítači Mac a nastavte aktivní schéma na zařízení s iOS.

Snímek obrazovky s tlačítkem mého iPhonu pro výběr zařízení

Vyberte Sestavit a potom spusťte aktuální schéma.

Snímek obrazovky s tlačítkem "nasadit a spustit" tlačítko se šipkou

V aplikaci vyberte pomocí šipek BasicDemo a pak stiskněte klávesu Go! spusťte ukázku. Postupujte podle pokynů k umístění a odvolání ukotvení.

Snímek obrazovky 1 Snímek obrazovky 2 Snímek obrazovky 3

Po dokončení zastavte aplikaci stisknutím klávesy Stop v Xcode.

Řešení potíží

Problémy s vykreslováním

Pokud při spuštění aplikace nevidíte fotoaparát jako pozadí (například místo toho uvidíte prázdnou, modrou nebo jinou texturu), budete pravděpodobně muset prostředky v Unity znovu importovat. Zastavte aplikaci. V horní nabídce v Unity zvolte Assets -> Re-import all (Znovu naimportovat vše). Pak aplikaci znovu spusťte.

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.

Kurz: Sdílení Spatial Anchors napříč zařízeními

Postupy: Konfigurace azure Spatial Anchors v projektu Unity