Snabbstart: Skapa en Unity iOS-app med Azure Spatial Anchors

Artikel
11/24/2021
8 minuter för att läsa

Den här snabbstarten beskriver hur du skapar en Unity iOS-app med Azure Spatial Anchors. Azure Spatial Anchors är en plattformsoberoende utvecklartjänst som du kan använda för att skapa upplevelser med mixad verklighet med hjälp av objekt som bevarar sin plats mellan enheter över tid. När du är klar har du en ARKit iOS-app som skapats med Unity och som kan spara och återkalla en spatial fästpunkt.

Du lär dig följande:

Skapa ett Spatial Anchors-konto
Förbereda Unity-bygginställningar
Konfigurera konto-ID och kontonyckel för Spatial Anchors
Exportera Xcode-projektet
Distribuera och köra på en iOS-enhet

Om du inte har en Azure-prenumerationkan du skapa ett kostnads fritt konto innan du börjar.

Förutsättningar

Kontrollera att du har följande så att du kan utföra den här snabbstarten:

En utvecklaraktiverad ARKit-kompatibel iOS-enhet.
En macOS-dator med den senaste versionen av Xcode installerad.
En Unity-installation. Information om versioner som stöds och nödvändiga funktioner finns på sidan för installation av Unity-projekt.
Git installerat via HomeBrew. Ange följande kommando i en enda rad i Terminal: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" . Kör sedan brew install git och brew install git-lfs .

Skapa en Spatial Anchors-resurs

Gå till Azure-portalen.

Välj Skapa en resurs i den vänstra rutan.

Använd sökrutan för att söka efter Spatial Anchors.

Välj Spatial Anchors och välj sedan Skapa.

I fönstret Spatial Anchors konto gör du följande:

Ange ett unikt resursnamn med hjälp av vanliga alfanumeriska tecken.
Välj den prenumeration som du vill koppla resursen till.
Skapa en resursgrupp genom att välja Skapa ny. Ge den namnet myResourceGroup och välj sedan OK.

En resurs grupp är en logisk behållare där Azure-resurser, till exempel webbappar, databaser och lagrings konton, distribueras och hanteras. Du kan exempelvis välja att ta bort hela resursgruppen i ett enkelt steg längre fram.
Välj en plats (region) där du vill placera resursen.
Välj Skapa för att börja skapa resursen.

Skärmbild av fönstret Spatial Anchors för att skapa en resurs.

När resursen har skapats visar Azure Portal att distributionen är klar.

Skärmbild som visar att resursdistributionen är klar.

Välj Gå till resurs. Nu kan du visa resursegenskaperna.

Kopiera resursens konto-ID-värde till en textredigerare för senare användning.

Skärmbild av fönstret resursegenskaper.

Kopiera också resursens kontodomänvärde till en textredigerare för senare användning.

Skärmbild som visar resursens kontodomänvärde.

Under Inställningar väljer du Åtkomstnyckel. Kopiera värdet för Primärnyckel, Kontonyckel, till en textredigerare för senare användning.

Skärmbild av fönstret Nycklar för kontot.

Börja med att förbereda din miljö för Azure CLI:

Använd bash-miljön i Azure Cloud Shell.
Om du vill kan du i stället installera Azure CLI för att köra CLI-referenskommandon.
- Om du använder en lokal installation loggar du in på Azure CLI med hjälp av kommandot az login. Slutför autentiseringsprocessen genom att följa stegen som visas i terminalen. Fler inloggningsalternativ finns i Logga in med Azure CLI.
- När du uppmanas till det installerar du Azure CLI-tillägg vid första användning. Mer information om tillägg finns i Använda tillägg med Azure CLI.
- Kör az version om du vill hitta versionen och de beroende bibliotek som är installerade. Om du vill uppgradera till den senaste versionen kör du az upgrade.

När du har loggat in använder du kommandot az account set för att välja den prenumeration där spatial anchors-kontot ska konfigureras:
```
az account set --subscription 00000000-0000-0000-0000-000000000000
```
Kör kommandot az group create för att skapa en resursgrupp eller använd en befintlig resursgrupp:
```
az group create --name myResourceGroup --location eastus2
```
En resurs grupp är en logisk behållare där Azure-resurser, till exempel webbappar, databaser och lagrings konton, distribueras och hanteras. Du kan exempelvis välja att ta bort hela resursgruppen i ett enkelt steg längre fram.

Du kan visa dina aktuella spatiala fästpunktskonton för en resursgrupp med kommandot az spatial-anchors-account list:
```
az spatial-anchors-account list --resource-group myResourceGroup
```
Du kan också visa spatiala fästpunktskonton för din prenumeration:
```
az spatial-anchors-account list
```

Kör kommandot az spatial-anchors-account create för att skapa ditt spatiala fästpunktskonto:

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

Visa resursegenskaperna med kommandot az spatial-anchors-account show:
```
az spatial-anchors-account show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
```
Kopiera värdet för resurskonto-ID och resurskontots domänvärde till en textredigerare för senare användning.

Kör kommandot az spatial-anchors-account key show för att hämta dina primära och sekundära nycklar:

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

Kopiera nyckelvärdena till en textredigerare för senare användning.

Om du behöver återskapa nycklar använder du kommandot 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

Du kan ta bort ett konto med kommandot az spatial-anchors-account delete:

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

Börja med att förbereda din miljö för Azure PowerShell:

Om du väljer att använda Azure PowerShell lokalt:
- Installera Az PowerShell-modulen.
- Anslut till ditt Azure-konto med hjälp av cmdleten Anslut-AzAccount.
Om du väljer att använda Azure Cloud Shell:
- Se Översikt över Azure Cloud Shell för mer information.

Viktigt

När PowerShell-modulen Az.MixedReality är i förhandsversion måste du installera den separat med hjälp av Install-Module cmdleten . När modulen blir allmänt tillgänglig kommer den att ingå i framtida versioner av Az PowerShell-modulen och vara tillgänglig som standard i Azure Cloud Shell.

Install-Module -Name Az.MixedReality

När du har loggat in använder du cmdleten Set-AzContext för att välja den prenumeration där kontot spatial anchors ska konfigureras:
```
Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
```
Kör cmdleten New-AzResourceGroup för att skapa en resursgrupp eller använd en befintlig resursgrupp:
```
New-AzResourceGroup -Name myResourceGroup -Location eastus2
```
En resurs grupp är en logisk behållare där Azure-resurser, till exempel webbappar, databaser och lagrings konton, distribueras och hanteras. Du kan exempelvis välja att ta bort hela resursgruppen i ett enkelt steg längre fram.

Du kan visa dina aktuella spatiala fästpunktskonton för en resursgrupp med hjälp av cmdleten Get-AzSpatialAnchorsAccount:
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
```
Du kan också visa spatiala fästpunktskonton för din prenumeration:
```
Get-AzSpatialAnchorsAccount
```

Kör cmdleten New-AzSpatialAnchorsAccount för att skapa ditt spatiala fästpunktskonto:

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

Visa resursegenskaperna med hjälp av cmdleten Get-AzSpatialAnchorsAccount:
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
```
Kopiera värdet för egenskapen accountId och egenskapskontotDomän till en textredigerare för senare användning.

Kör cmdleten Get-AzSpatialAnchorsAccountKey för att hämta dina primära och sekundära nycklar:

Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Kopiera nyckelvärdena till en textredigerare för senare användning.

Om du behöver återskapa nycklar använder du cmdleten New-AzSpatialAnchorsAccountKey:

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

Du kan ta bort ett konto med cmdleten Remove-AzSpatialAnchorsAccount:

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Ladda ned och öppna Unity-exempelprojektet

Klona exempel lagrings platsen genom att köra följande kommandon:

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

Följ anvisningarna här för att ladda ned och importera de ASA SDK-paket som krävs för iOS-plattformen.

Öppna projektet i Unity-mappen i Unity. Unity kan bli en fråga om en skillnad mellan versionen i projektet och den version som är installerad på datorn. Den här varningen är OK så länge din version av Uniting Editor är nyare än den som projektet skapades med. Om versionen är nyare väljer du Fortsätt. Om din version är äldre än den som projektet behöver, väljer du Avsluta och uppgraderar din Unity-redigerare.

Skärm bild av fönstret Unity.

Öppna Build Settings (Bygginställningar) genom att välja Arkiv > Build Settings (Bygginställningar).

I avsnittet Plattform väljer du iOS.

Välj Switch Platform (Växla plattform) för att ändra plattformen till iOS. Unity kan uppmana dig att installera iOS support-komponenter om de saknas.

Skärm bild av fönstret Unity build Settings.

Stäng fönstret Build Settings (Bygginställningar).

Konfigurera konto informationen

Nästa steg är att konfigurera appen så att den använder din konto information. Du har kopierat konto nyckeln, konto-ID: t och kontots domän värden till en text redigerare tidigare i avsnittet "skapa en resurs för spatial ankare" .

Gå till i fönstret projekt Assets\AzureSpatialAnchors.SDK\Resources .

Välj SpatialAnchorConfig. I fönstret kontrollant anger du Account Key som värde för konto nyckeln spatiala ankare, Account ID som värdet för konto-ID för spatiala ankare och Account Domain som värdet för spatiala ankare konto domän.

Exportera Xcode-projektet

Öppna Build Settings (Bygginställningar) genom att välja Arkiv > Build Settings (Bygginställningar).

Se till att alla scener har en bock bredvid dem under scener i build.

Välj build. I fönstret som öppnas väljer du en mapp att exportera Xcode-projektet till.

När exporten är klar visas en mapp som innehåller det exporterade Xcode-projektet.

Anteckning

Om ett fönster visas med ett meddelande som frågar om du vill ersätta eller lägga till, rekommenderar vi att du väljer Lägg till, eftersom det är snabbare. Du bör endast välja Ersätt om du har ändrat till gångar i din scen. Du kan till exempel lägga till, ta bort eller ändra överordnade och underordnade relationer, eller så kan du lägga till, ta bort eller ändra egenskaper. Om du bara gör käll kods ändringar bör tillägg vara tillräckligt.

Öppna Xcode-projektet

Nu kan du öppna Unity-iPhone.xcodeproj projektet i Xcode.

Du kan antingen starta Xcode och öppna det exporterade Unity-iPhone.xcodeproj projektet eller starta projektet i Xcode genom att köra följande kommando från den plats där du exporterade projektet:

open ./Unity-iPhone.xcodeproj

Välj den rot Uppunions-iPhone- noden för att visa projekt inställningarna och välj sedan fliken Allmänt .

Under distributions information ser du till att distributions målet är inställt på iOS 11,0.

Välj fliken signerings & funktioner och se till att Automatisk hantering av signering är aktiverat. Om det inte är det aktiverar du det och återställer sedan build-inställningarna genom att välja Aktivera automatisk i fönstret som visas.

Distribuera appen till din iOS-enhet

Anslut iOS-enheten till Mac och Ställ in det aktiva schemat på din iOS-enhet.

Skärm bild av min iPhone-knapp för att välja enheten.

Välj Build and then run the current scheme (Skapa och kör sedan det aktuella schemat).

Skärm bild av pilknappen "distribuera och köra".

I appen väljer du BasicDemo med pilarna och trycker sedan på Kör! för att köra demonstrationen. Följ anvisningarna för att placera och återkalla en fästpunkt.

Skärmbild 1 Skärmbild 2 Skärmbild 3

När du är klar stoppar du appen genom att trycka på Stoppa i Xcode.

Felsökning

Renderingsproblem

Om du inte ser kameran som bakgrund när du kör appen (om du till exempel ser en tom, blå eller annan textur) behöver du förmodligen återimportera tillgångarna i Unity. Stoppa appen. På den översta menyn i Unity väljer du Assets -> Re-import all(Tillgångar -> importera alla ). Kör sedan appen igen.

Rensa resurser

I de föregående stegen skapade du Azure-resurser i en resursgrupp. Om du inte tror att du behöver dessa resurser i framtiden, kan du ta bort dem genom att ta bort resursgruppen.

Från Azure Portal-menyn eller Start sidan väljer du resurs grupper. På sidan resurs grupper väljer du sedan myResourceGroup.

På sidan myResourceGroup kontrollerar du att de listade resurserna är de som du vill ta bort.

Välj ta bort resurs grupp, Skriv myResourceGroup i text rutan för att bekräfta och välj sedan ta bort.

Nästa steg

I den här snabb starten skapade du ett konto för spatial ankare. Du har sedan konfigurerat och distribuerat en app för att spara och återkalla spatiala ankare. Fortsätt till nästa självstudie om du vill veta mer om hur du kan förbättra appen så att den kan dela spatiala ankare med andra enheter.

Självstudie: Dela Spatial Anchors mellan enheter

Gör så här: Konfigurera Azure Spatial Anchors i ett Unity-projekt