Självstudie: dela spatiala ankare mellan sessioner och enheter
Molnbaserade ankare är en plattforms oberoende utvecklare som du kan använda för att skapa blandade verklighets upplevelser genom att använda objekt som bevarar sin plats mellan enheter över tid.
I den här självstudien använder du Azure spatiala ankare för att skapa ankare under en session och sedan hitta dem på samma enhet eller en annan. Samma ankare kan också placeras 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 ankare och lagra ankare i minnet under en angiven tids period.
- Konfigurera AzureSpatialAnchorsLocalSharedDemo-scenen i Unity-exemplet från våra snabb starter för att dra nytta av webbappen för delnings ankare.
- Distribuera och kör ankarena till en eller flera enheter.
Om du inte har en Azure-prenumerationkan du skapa ett kostnads fritt konto innan du börjar.
Förutsättningar
Innan du påbörjar den här självstudien måste du se till att du uppfyller följande krav:
- Läs Översikt över Azure spatiala ankare.
- Slutför ett av snabb starterna på fem minuter.
Anteckning
Android/NDK och iOS/Swift-snabb starter visar inte för närvarande de funktioner som beskrivs i den här självstudien.
- Grundläggande kunskaper om något av följande:
- En Windows-dator med Visual Studio 2019 eller senare och arbets belastningen ASP.net och webb utveckling .
- .Net Core 3,1 SDK.
- En eller flera av följande enheter som du använder för att distribuera och köra en app: HoloLens, HoloLens 2, iOS eller Android.
Anteckning
Du använder Unity och en ASP.NET Core webbapp i den här självstudien, men metoden här är endast till för att ge ett exempel på hur du kan dela Azure spatiala ankare 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
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.
När resursen har skapats visar Azure Portal 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 också resursens kontodomänvärde till en textredigerare för senare användning.
Under Inställningar väljer du Åtkomstnyckel. Kopiera värdet för Primärnyckel, Kontonyckel, till en textredigerare för senare användning.
Hämta exempel projektet
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
Distribuera tjänsten delnings ankare
Öppna Visual Studio och öppna sedan projektet i mappen Sharing\SharingServiceSample .
Öppna guiden publicera
I Solution Explorer högerklickar du på projektet SharingService och väljer sedan publicera.
Publicerings guiden startar.
Välj App Service > publicera för att öppna fönstret Skapa App Service .
Logga in på Azure
Logga in på Azure-portalen.
I fönstret skapa App Service väljer du Lägg till ett konto och loggar sedan in på din Azure-prenumeration. Om du redan är inloggad väljer du önskat konto i list rutan.
Anteckning
Välj inte Skapa ännu om du redan är inloggad.
Skapa en resursgrupp
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 Ny bredvid Resursgrupp.
Namnge resurs gruppen 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.
Använd de här inställningarna i fönstret Konfigurera värd plan :
| Inställning | Föreslaget värde | Beskrivning |
|---|---|---|
| App Service-plan | MySharingServicePlan | Namnet på App Service plan |
| Location | USA, västra | Data centret där webbappen finns |
| Storlek | Kostnadsfri | Den pris nivå som avgör värd funktioner |
Välj OK.
Skapa och publicera webbappen
Ange ett unikt namn för appen i appens namn. Giltiga tecken är a-z, 0-9 och bindestreck (-), eller accepterar det automatiskt genererade unika namnet. Webbadressen till webbappen är https://<app_name>.azurewebsites.net, där <app_name> är appens namn.
Välj Skapa för att börja skapa Azure-resurser.
När guiden har slutförts publiceras ASP.NET Core-webbappen till Azure och sedan öppnas appen i standard webbläsaren.
Det app-namn som du använde i det här avsnittet används som URL-prefix i formatet https://<app_name>.azurewebsites.net . Kopiera denna URL till en text redigerare för senare användning.
Distribuera exempel appen
Java Android-exemplet stöder delning mellan enheter.
I Android Studio öppnar du filen SharedActivity. java från mappen Samples.
Ange den URL som du kopierade i föregående steg (från ASP.NET-webbappens Azure-distribution) som värde för SharingAnchorsServiceUrl i SharedActivity. java -filen.
Ersätt index.html i URL: en med api/anchors . Den bör se ut så här: https://<app_name>.azurewebsites.net/api/anchors .
Distribuera appen till enheten.
När appen har startat går du till fönstret Välj en demonstration och väljer alternativet LocalShare genom att använda vänster och höger pilar. Tryck sedan på gå till!.
Följ instruktionerna i appen. Du kan välja skapa & resurs ankare eller hitta delade ankare.
Med skapa & resurs ankare kan du skapa en fäst punkt och spara den i delnings tjänsten. I retur får du tillbaka en identifierare som du kan använda för att hämta den från delnings tjänsten. Sedan kan du köra det andra scenariot, hitta delat ankare, antingen från din enhet eller en annan.
Med hitta delade ankare kan du hitta tidigare delade ankare genom att ange den identifierare som nämnts tidigare. När du har valt ditt scenario hjälper appen dig med ytterligare instruktioner. Till exempel uppmanas du att flytta enheten runt till samla in miljö information. Senare kan du placera en fäst punkt i världen, vänta tills den har sparats, starta en ny session och sedan hitta 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.
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 självstudien har du distribuerat en ASP.NET Core webbapp i Azure och du har konfigurerat och distribuerat en Unity-app. Du har skapat spatialdata med appen och du har delat dem med andra enheter genom att använda 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 spara lagringen av dina delade avstånds ankare. Genom att lägga till Azure Cosmos DB support kan du låta din ASP.NET Core webbapp Skapa en fäst punkt idag. Sedan kan du med hjälp av den fäst punkts identifierare som lagras i din webbapp låta appen returnera dagar senare för att hitta ankaret igen.