Självstudie: Dela rumsliga fästpunkter mellan sessioner och enheter

Azure Spatial Anchors är en plattformsoberoende utvecklartjänst som du kan skapa upplevelser för mixad verklighet med genom att använda objekt som bevarar deras plats över enheter över tid.

I den här självstudien använder du Azure Spatial Anchors för att skapa fästpunkter under en session och leta upp dem på samma enhet eller en annan. Samma fästpunkter kan också finnas av flera enheter på samma plats och samtidigt.

I den här självstudien får du lära dig att:

• Distribuera en ASP.NET Core-webbapp i Azure som du kan använda för att dela fästpunkter och lagra fästpunkterna i minnet under en angiven tidsperiod.
• Konfigurera Scenen AzureSpatialAnchorsLocalSharedDemo i Unity-exemplet från våra snabbstarter för att dra nytta av webbappen Sharing Anchors.
• Distribuera och kör fästpunkterna till en eller flera enheter.

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

Förutsättningar

Innan du påbörjar den här självstudien måste du vara säker på att du har uppfyllt följande krav:

• Läs översikten över Azure Spatial Anchors.
• Slutför en av snabbstarterna på 5 minuter.

  Kommentar

  Snabbstarter för Android/NDK och iOS/Swift visar för närvarande inte de funktioner som beskrivs i den här självstudien.

• Grundläggande kunskaper om något av följande:
  • ARCore om du använder Android.
  • ARKit om du använder iOS.
• En Windows-dator med Visual Studio 2019 eller senare samt arbetsbelastningen ASP.NET och webbutveckling .
• .NET Core 3.1 SDK.
• En eller flera av följande enheter som du kan distribuera och köra en app på: HoloLens, HoloLens 2, iOS eller Android.

Kommentar

Du kommer att använda Unity och en ASP.NET Core-webbapp i den här självstudien, men metoden här är bara att ge ett exempel på hur du delar Azure Spatial Anchors-identifierare på andra enheter. Du kan använda andra språk och backend-tekniker för att uppnå samma mål.

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 hjälp av cmdleten Connect-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 aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e
   

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 exempelprojektet + 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 HoloLens-plattformen.

Distribuera tjänsten Delningsankare

Kommentar

I den här självstudien kommer vi att använda den kostnadsfria nivån för Azure App Service. Den kostnadsfria nivån överskrider tidsgränsen efter 20 minuters inaktivitet och återställer minnescachen.

Visual Studio

Öppna Visual Studio och öppna sedan projektet i mappen Sharing\SharingServiceSample .

Öppna publiceringsguiden

I Istraživač rešenja högerklickar du på projektet SharingService och väljer sedan Publicera....

Publiceringsguiden startar.

1. Välj Mål azure>nästa.
2. Välj Specifik Azure App Service för mål (Windows)>Nästa
3. Logga in på Azure-portalen.
4. Välj det gröna "+" för att skapa en Azure App Service

Apptjänst-inställningar

Inställning	Föreslaget värde	Description
Name	myASASharingService	Ge tjänsten ett unikt namn
Subscription Name		Välj önskad Azure-prenumeration
Resursgrupp	myResourceGroup eller välj en befintlig	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ärdplan	Välj Ny... och se tabellen nedan	En App Service-plan anger plats, storlek och funktioner för webbservergruppen som är värd för din app. Du kan spara pengar när du är värd för flera appar genom att konfigurera webbapparna så att de delar en enda App Service-plan. App Service-planer definierar: Region (till exempel: Europa, norra; USA, östra; Asien, sydöstra m.m.) Instansstorlek (liten, medel eller stor) Skalningsantal (1 till 20 instanser) SKU (Kostnadsfri, Delad, Basic, Standard eller Premium)

Inställningar för värdplan

Inställning	Föreslaget värde	beskrivning
Värdplan	MySharingServicePlan	Ge din värdplan ett unikt namn
Plats	Västra USA	Datacenter som är värd för webbappen. Välj en plats närmast den fysiska plats som programmet ska användas på
Storlek	Kostnadsfri	Prisnivån som avgör värdfunktioner

5. Välj Skapa för att skapa App Service
6. När apptjänsten har skapats väljer du den i listan "App Service-instanser" och väljer Slutför
7. På fliken SharingService: Publish (Delningstjänst: Publicera ) väljer du Publicera

När ASP.NET Core-webbappen har publicerats till Azure kan du gå till https://<your_app_name>.azurewebsites.net eller klicka på länken bredvid Webbplats: på fliken DelningTjänst: Publicera . Kopiera den här URL:en till en textredigerare för senare användning.

Visual Studio Code

Du måste skapa en resursgrupp och en App Service-plan innan du distribuerar tjänsten i Visual Studio Code.

Logga in på Azure

Gå till Azure-portalen och logga sedan in på din Azure-prenumeration.

Skapa en resursgrupp

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 Ny bredvid Resursgrupp.

Ge resursgruppen namnet myResourceGroup och välj sedan OK.

Skapa en App Service-plan

En App Service-plan anger plats, storlek och funktioner för webbservergruppen som är värd för din app. Du kan spara pengar när du är värd för flera appar genom att konfigurera webbapparna så att de delar en enda App Service-plan.

App Service-planer definierar följande:

• Region (till exempel: Europa, norra; USA, östra; Asien, sydöstra m.m.)
• Instansstorlek (liten, medel eller stor)
• Skalningsantal (1 till 20 instanser)
• SKU (Kostnadsfri, Delad, Basic, Standard eller Premium)

Bredvid Värdplan väljer du Ny.

I fönstret Konfigurera värdplan använder du följande inställningar:

Inställning	Föreslaget värde	beskrivning
App Service-plan	MySharingServicePlan	Namnet på App Service-planen
Plats	Västra USA	Det datacenter där webbappen finns
Storlek	Kostnadsfri	Prisnivån som avgör värdfunktioner

Välj OK.

Öppna Visual Studio Code och öppna sedan projektet i mappen Sharing\SharingServiceSample .

Om du vill distribuera delningstjänsten via Visual Studio Code följer du anvisningarna i Publicera en ASP.NET Core-app till Azure med Visual Studio Code. Börja i avsnittet "Öppna den med Visual Studio Code". Skapa inte ett annat ASP.NET projekt enligt beskrivningen i föregående steg, eftersom du redan har ett projekt som ska distribueras och publiceras: SharingServiceSample.

Konfigurera + distribuera exempelappen

Unity – HoloLens

Öppna projekt

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

Konfigurera bygginställningar

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

I avsnittet Plattform väljer du Universell Windows-plattform. Ändra målenheten till HoloLens.

Välj Switch Platform (Växla plattform) för att ändra plattformen till Universell Windows-plattform. Unity kan uppmana dig att installera UWP-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.

Öppna scenen med namnet AzureSpatialAnchorsLocalSharedDemo Assets/AzureSpatialAnchors.Examples/Scenes/AzureSpatialAnchorsLocalSharedDemo genom att dubbelklicka på den i projektfönstret

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

Välj SpatialAnchorSamplesConfig. I fönstret Kontroll anger du Sharing Anchors Service sedan URL:en (från din ASP.NET azure-distribution av webbappen) som värde för Base Sharing Url . Lägg till URL:en med /swagger/api/anchors. Det bör se ut så här: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

Spara scenen genom att välja Arkiv>Spara.

Exportera + distribuera HoloLens-programmet

Ö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 dialogrutan väljer du en mapp där du vill exportera HoloLens Visual Studio-projektet.

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

Dubbelklicka på HelloAR U3D.sln i mappen för att öppna projektet i Visual Studio.

Ändra lösningskonfigurationen till Släpp, ändra lösningsplattformen till x86 och välj Enhet från distributionsmålalternativen.

Om du använder HoloLens 2 använder du ARM64 som lösningsplattform i stället för x86.

Aktivera HoloLens-enheten, logga in och anslut enheten till datorn med hjälp av en USB-kabel.

Välj Felsök>Starta felsökning för att distribuera appen och börja felsöka.

Köra appen

I appen väljer du LocalSharedDemo 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.

Med Skapa och dela fästpunkt kan du skapa en fästpunkt och spara den i delningstjänsten. I gengäld får du tillbaka en identifierare för den som du kan använda för att hämta den från delningstjänsten. Du kan sedan köra det andra scenariot, Hitta delad fästpunkt, antingen från din enhet eller en annan.

Med Leta upp delad fästpunkt kan du hitta tidigare delade fästpunkter genom att ange den identifierare som nämndes tidigare. När du har valt ditt scenario vägleder appen dig med ytterligare instruktioner. Du uppmanas till exempel att flytta runt enheten för att samla in miljöinformation. Senare placerar du en fästpunkt i världen, väntar på att den ska sparas, startar en ny session och letar sedan reda på den.

Unity – Android

Öppna projekt

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

Konfigurera bygginställningar

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

I avsnittet Plattform väljer du Android och sedan Växla plattform för att ändra plattformen till Android. Unity kan uppmana dig att installera Android-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.

Öppna scenen med namnet AzureSpatialAnchorsLocalSharedDemo Assets/AzureSpatialAnchors.Examples/Scenes/AzureSpatialAnchorsLocalSharedDemo genom att dubbelklicka på den i projektfönstret

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

Välj SpatialAnchorSamplesConfig. I fönstret Kontroll anger du Sharing Anchors Service sedan URL:en (från din ASP.NET azure-distribution av webbappen) som värde för Base Sharing Url . Lägg till URL:en med /swagger/api/anchors. Det bör se ut så här: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

Spara scenen genom att välja Arkiv>Spara.

Distribuera

Logga in på din Android-enhet och anslut den till datorn med hjälp av en USB-kabel.

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

Under Scener i build kontrollerar du att varje scen har en bockmarkering bredvid sig.

Kontrollera att Export Project inte har någon bockmarkering. Välj Skapa och kör. Du uppmanas att spara filen .apk . Du kan välja valfritt namn för det.

Köra appen

I appen väljer du demot LocalShare 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.

Med Skapa och dela fästpunkt kan du skapa en fästpunkt och spara den i delningstjänsten. I gengäld får du tillbaka en identifierare för den som du kan använda för att hämta den från delningstjänsten. Du kan sedan köra det andra scenariot, Hitta delad fästpunkt, antingen från din enhet eller en annan.

Med Leta upp delad fästpunkt kan du hitta tidigare delade fästpunkter genom att ange den identifierare som nämndes tidigare. När du har valt ditt scenario vägleder appen dig med ytterligare instruktioner. Du uppmanas till exempel att flytta runt enheten för att samla in miljöinformation. Senare placerar du en fästpunkt i världen, väntar på att den ska sparas, startar en ny session och letar sedan reda på den.

Unity – iOS

Öppna projekt

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

Konfigurera bygginställningar

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

Öppna scenen med namnet AzureSpatialAnchorsLocalSharedDemo Assets/AzureSpatialAnchors.Examples/Scenes/AzureSpatialAnchorsLocalSharedDemo genom att dubbelklicka på den i projektfönstret

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

Välj SpatialAnchorSamplesConfig. I fönstret Kontroll anger du Sharing Anchors Service sedan URL:en (från din ASP.NET azure-distribution av webbappen) som värde för Base Sharing Url . Lägg till URL:en med /swagger/api/anchors. Det bör se ut så här: https://<your_app_name>.azurewebsites.net/swagger/api/anchors.

Spara scenen genom att välja Arkiv>Spara.

Distribuera till en iOS-enhet

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

Under Scener i build kontrollerar du att varje scen 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-iPhone 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 ställ in det aktiva schemat på din iOS-enhet.

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

Köra appen

I appen väljer du demot LocalShare 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.

Med Skapa och dela fästpunkt kan du skapa en fästpunkt och spara den i delningstjänsten. I gengäld får du tillbaka en identifierare för den som du kan använda för att hämta den från delningstjänsten. Du kan sedan köra det andra scenariot, Hitta delad fästpunkt, antingen från din enhet eller en annan.

Med Leta upp delad fästpunkt kan du hitta tidigare delade fästpunkter genom att ange den identifierare som nämndes tidigare. När du har valt ditt scenario vägleder appen dig med ytterligare instruktioner. Du uppmanas till exempel att flytta runt enheten för att samla in miljöinformation. Senare placerar du en fästpunkt i världen, väntar på att den ska sparas, startar en ny session och letar sedan reda på den.

Stoppa appen i Xcode genom att välja Stoppa.

Android

Java Android-exemplet stöder delning mellan enheter.

I Android Studio öppnar du filen SharedActivity.java från exempelmappen.

Ange den URL som du kopierade i föregående steg (från din ASP.NET azure-distribution av webbappen) som värde för SharingAnchorsServiceUrl i SharedActivity.java-filen.

index.html Ersätt i URL:en med api/anchors. Det bör se ut så här: https://<app_name>.azurewebsites.net/api/anchors.

Distribuera appen till enheten.

När appen har startat använder du vänster- och högerpilarna i fönstret Välj en demo för att välja alternativet LocalShare . Tryck sedan på Go!.

Följ instruktionerna i appen. Du kan välja Skapa och dela fästpunkt eller Hitta delad fästpunkt.

Med Skapa och dela fästpunkt kan du skapa en fästpunkt och spara den i delningstjänsten. I gengäld får du tillbaka en identifierare för den som du kan använda för att hämta den från delningstjänsten. Du kan sedan köra det andra scenariot, Hitta delad fästpunkt, antingen från din enhet eller en annan.

Med Leta upp delad fästpunkt kan du hitta tidigare delade fästpunkter genom att ange den identifierare som nämndes tidigare. När du har valt ditt scenario vägleder appen dig med ytterligare instruktioner. Du uppmanas till exempel att flytta runt enheten för att samla in miljöinformation. Senare placerar du en fästpunkt i världen, väntar på att den ska sparas, startar en ny session och letar sedan reda på den.

iOS

Objective-C iOS-exemplet stöder delning mellan enheter.

Öppna filen SharedDemoViewController.m i exempelmappen.

Ange den URL som du fick i föregående steg (från din ASP.NET azure-distribution av webbappen) som värde för SharingAnchorsServiceUrl i filen SharedDemoViewController.m .

index.html Ersätt i URL:en med api/anchors. Det bör se ut så här: https://<app_name>.azurewebsites.net/api/anchors.

Distribuera appen till enheten.

När appen har startat väljer du alternativet Tryck för att starta Delad demo och följer sedan anvisningarna i appen. Du kan välja Tryck för att hitta Fästpunkt efter dess fästpunktsnummer eller Tryck för att skapa Fästpunkt och spara det i tjänsten.

Med Skapa och dela fästpunkt kan du skapa en fästpunkt och spara den i delningstjänsten. I gengäld får du tillbaka en identifierare för den som du kan använda för att hämta den från delningstjänsten. Du kan sedan köra det andra scenariot, Hitta delad fästpunkt, antingen från din enhet eller en annan.

Med Leta upp delad fästpunkt kan du hitta tidigare delade fästpunkter genom att ange den identifierare som nämndes tidigare. När du har valt ditt scenario vägleder appen dig med ytterligare instruktioner. Du uppmanas till exempel att flytta runt enheten för att samla in miljöinformation. Senare placerar du en fästpunkt i världen, väntar på att den ska sparas, startar en ny session och letar sedan reda på den.

Xamarin

Både Xamarin Android- och iOS-exempel stöder delning mellan enheter.

Öppna filen AccountDetails.cs i exempelmappen.

Ange den URL som du fick i föregående steg (från din ASP.NET azure-distribution av webbappen) som värde för AnchorSharingServiceUrl i filen AccountDetails.cs .

index.html Ersätt i URL:en med api/anchors. Det bör se ut så här: https://<app_name>.azurewebsites.net/api/anchors.

Distribuera appen till enheten.

När appen har startat använder du vänster- och högerpilarna i fönstret Välj en demo för att välja alternativet LocalShare . Tryck sedan på Go!.

Följ instruktionerna i appen. Du kan välja Skapa och dela fästpunkt eller Hitta delad fästpunkt.

Med Skapa och dela fästpunkt kan du skapa en fästpunkt och spara den i delningstjänsten. I gengäld får du tillbaka en identifierare för den som du kan använda för att hämta den från delningstjänsten. Du kan sedan köra det andra scenariot, Hitta delad fästpunkt, antingen från din enhet eller en annan.

Med Leta upp delad fästpunkt kan du hitta tidigare delade fästpunkter genom att ange den identifierare som nämndes tidigare. När du har valt ditt scenario vägleder appen dig med ytterligare instruktioner. Du uppmanas till exempel att flytta runt enheten för att samla in miljöinformation. Senare placerar du en fästpunkt i världen, väntar på att den ska sparas, startar en ny session och letar sedan reda på den.

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 självstudien distribuerade du en ASP.NET Core-webbapp i Azure och konfigurerade och distribuerade en Unity-app. Du har skapat spatiala fästpunkter med appen och delat dem med andra enheter med hjälp av din ASP.NET Core-webbapp.

Du kan förbättra din ASP.NET Core-webbapp så att den använder Azure Cosmos DB för att bevara lagringen av dina delade spatiala fästpunkter. Genom att lägga till Stöd för Azure Cosmos DB kan du låta din ASP.NET Core-webbapp skapa en fästpunkt i dag. Genom att använda fästpunktsidentifieraren som lagras i webbappen kan du sedan låta appen komma tillbaka några dagar senare för att hitta fästpunkten igen.

Använda Azure Cosmos DB för att lagra fästpunkter