Kör exempelappen: iOS – Unity (C#)

Den här snabbstarten beskriver hur du kör Azure Spatial Anchors-exempelappen för iOS-enheter med unity (C#). 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 att:

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

Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.

Förutsättningar

Kontrollera att du har följande för genomföra den här snabbstarten:

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

Skapa en Spatial Anchors-resurs

Portal

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.

Gör följande i fönstret Spatial Anchors-konto :

• 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 resursgrupp är en logisk container där Azure-resurser, till exempel webbappar, databaser och lagringskonton, 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.

När resursen har skapats visar Azure-portalen att distributionen ä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.

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

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

Azure CLI

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

• Använd Bash-miljön i Azure Cloud Shell. Mer information finns i Snabbstart för Bash i Azure Cloud Shell.

  

• Om du föredrar att köra CLI-referenskommandon lokalt installerar du Azure CLI. Om du kör i Windows eller macOS kan du köra Azure CLI i en Docker-container. Mer information finns i Så här kör du Azure CLI i en Docker-container.

  • 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. Andra inloggningsalternativ finns i Logga in med Azure CLI.

  • När du uppmanas att installera Azure CLI-tillägget vid första användningen. 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.

1. När du har loggat in använder du kommandot az account set för att välja den prenumeration där kontot spatial anchors ska konfigureras:

   az account set --subscription 00000000-0000-0000-0000-000000000000
   

2. 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 resursgrupp är en logisk container där Azure-resurser, till exempel webbappar, databaser och lagringskonton, 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ästpunkter för en resursgrupp med hjälp av kommandot az spatial-anchors-account list :

   az spatial-anchors-account list --resource-group myResourceGroup
   

   Du kan också visa konton för spatiala fästpunkter för din prenumeration:

   az spatial-anchors-account list
   

3. Kör kommandot az spatial-anchors-account create för att skapa ditt spatial anchors-konto:

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

4. Visa resursegenskaperna med kommandot az spatial-anchors-account show :

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

   Kopiera resurskontots ID-värde och värdet för resurskontodomänen till en textredigerare för senare användning.

5. 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 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 hjälp av kommandot az spatial-anchors-account delete :

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

Azure PowerShell

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

• Om du väljer att använda Azure PowerShell lokalt:
  • Installera den senaste versionen av Az PowerShell-modulen.
  • Anslut till ditt Azure-konto med cmdleten Anslut-AzAccount.
• Om du väljer att använda Azure Cloud Shell:
  • Mer information finns i Översikt över Azure Cloud Shell .

Viktigt!

Även om PowerShell-modulen Az.MixedReality är i förhandsversion måste du installera den separat med hjälp av cmdleten Install-Module . 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

1. 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
   

2. Kör cmdleten New-AzResourceGroup för att skapa en resursgrupp eller använd en befintlig resursgrupp:

   New-AzResourceGroup -Name myResourceGroup -Location eastus2
   

   En resursgrupp är en logisk container där Azure-resurser, till exempel webbappar, databaser och lagringskonton, 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ästpunkter för en resursgrupp med hjälp av cmdleten Get-AzSpatialAnchorsAccount :

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
   

   Du kan också visa konton för spatiala fästpunkter för din prenumeration:

   Get-AzSpatialAnchorsAccount
   

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

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

4. Visa resursegenskaperna med hjälp av cmdleten Get-AzSpatialAnchorsAccount :

   Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
   

   Kopiera värdet för egenskapen accountId och egenskapen accountDomain till en textredigerare för senare användning.

5. 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 exempelprojekt och importera SDK

Lagringsplats för klonexempel

Klona exempellagringsplatsen genom att köra följande kommandon:

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

Importera ASA SDK

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

Konfigurera Unity

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

Ö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-stödkomponenter om de saknas.

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

Konfigurera kontoinformationen

Nästa steg är att konfigurera appen så att den använder din kontoinformation. Du kopierade värdena kontonyckel, konto-ID och kontodomän till en textredigerare tidigare i avsnittet "Skapa en spatial fästpunktsresurs" .

I fönstret Projekt går du till Assets\AzureSpatialAnchors.SDK\Resources.

Välj SpatialAnchorConfig. I fönstret Inspector anger du Account Key som värde för Spatial Anchors-kontonyckeln, Account ID som värde för Spatial Anchors-konto-ID och Account Domain som värde för Spatial Anchors-kontodomänen.

Exportera Xcode-projektet

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

Under Scener i build kontrollerar du att alla scener har en bockmarkering bredvid sig.

Välj Skapa. I fönstret som öppnas väljer du en mapp som Xcode-projektet ska exporteras till.

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

Kommentar

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 går snabbare. Ersätt tar bort alla filer från målmappen och genererar nytt innehåll.

Öppna Xcode-projektet

Nu kan du öppna projektet Unity-iPhone.xcodeproj 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 rotnoden Unity-i Telefon för att visa projektinställningarna och välj sedan fliken Allmänt.

Under Distributionsinformation kontrollerar du att distributionsmålet är inställt på iOS 11.0.

Välj fliken Signering och funktioner och se till att Hantera signering automatiskt är aktiverat. Om det inte är det aktiverar du det och återställer sedan bygginställningarna genom att välja Aktivera automatiskt i fönstret som visas.

Distribuera appen till din iOS-enhet

Anslut iOS-enheten till Mac och ange det aktiva schemat till din iOS-enhet.

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

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

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 Tillgångar –> Importera alla igen. 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.

På menyn eller startsidan i Azure-portalen väljer du Resursgrupper. Välj sedan myResourceGroup på sidan Resursgrupper.

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

Välj Ta bort resursgrupp, skriv myResourceGroup i textrutan för att bekräfta och välj sedan Ta bort.

Nästa steg

I den här snabbstarten skapade du ett Spatial Anchors-konto. Sedan konfigurerade och distribuerade du en app för att spara och återkalla spatiala fästpunkter. Om du vill veta mer om hur du förbättrar appen så att den kan dela rumsliga fästpunkter med andra enheter fortsätter du till nästa självstudie.

Självstudie: Dela spatiala fästpunkter mellan enheter

Anvisningar: Konfigurera Azure Spatial Anchors i ett Unity-projekt