Oktatóanyag: térbeli horgonyok megosztása a munkamenetek és az eszközök közöttTutorial: Share spatial anchors across sessions and devices

Az Azure térbeli horgonyok egy platformfüggetlen fejlesztői szolgáltatás, amellyel vegyes valóságú élmények hozhatók létre olyan objektumok használatával, amelyek a helyükön maradnak az eszközökön az idő múlásával.Azure Spatial Anchors is a cross-platform developer service with which you can create mixed-reality experiences by using objects that persist their location across devices over time.

Ebben az oktatóanyagban az Azure térbeli horgonyait használva horgonyokat hozhat létre egy munkamenet során, majd megkeresheti őket ugyanazon az eszközön vagy egy másikon.In this tutorial, you use Azure Spatial Anchors to create anchors during one session and then locate them on the same device or a different one. Ugyanazokat a horgonyokat több eszköz is megtalálhatja ugyanazon a helyen és egyszerre.The same anchors can also be located by multiple devices in the same place and at the same time.

A mobileszköz használatával létrehozott és a nap folyamán egy másik eszközzel használt térbeli horgonyokat bemutató animáció.

Ebből az oktatóanyagból az alábbiakat sajátíthatja el:In this tutorial, you'll learn how to:

  • Helyezzen üzembe egy ASP.NET Core webalkalmazást az Azure-ban, amellyel megoszthatja a horgonyokat, és a memóriában tárolhatja a horgonyokat egy adott időszakra vonatkozóan.Deploy an ASP.NET Core web app in Azure that you can use to share anchors, and store the anchors in memory for a specified period of time.
  • A gyors üzembe helyezési pontokon belül konfigurálja a AzureSpatialAnchorsLocalSharedDemo jelenetet, hogy kihasználhassa a megosztási horgonyok webalkalmazás előnyeit.Configure the AzureSpatialAnchorsLocalSharedDemo scene within the Unity sample from our quickstarts to take advantage of the Sharing Anchors web app.
  • A horgonyokat üzembe helyezheti és futtathatja egy vagy több eszközön.Deploy and run the anchors to one or more devices.

Ha nem rendelkezik Azure- előfizetéssel, a Kezdés előtt hozzon létre egy ingyenes fiókot .If you don't have an Azure subscription, create a free account before you begin.

ElőfeltételekPrerequisites

Az oktatóanyag megkezdése előtt győződjön meg arról, hogy teljesítette a következő előfeltételeket:Before you begin this tutorial, be sure you've met the following prerequisites:

  • Olvassa el az Azure térbeli horgonyok áttekintése című témakört.Read the Azure Spatial Anchors overview.
  • Fejezze be az 5 perces rövidútmutatók egyikét.Complete one of the 5-minute quickstarts.

    Megjegyzés

    Az Android/NDK és az iOS/Swift gyors útmutatója jelenleg nem mutatja be az oktatóanyagban ismertetett képességeket.Android/NDK and iOS/Swift quickstarts don't currently showcase the capabilities explained in this tutorial.

  • A következők alapszintű ismerete:A basic knowledge of either:
    • ARCore Android használata esetén.ARCore if you're using Android.
    • ARKit iOS használata esetén.ARKit if you're using iOS.
  • A Visual Studio 2019 -es vagy újabb verziójával rendelkező Windows-számítógép, valamint a ASP.net és a webes fejlesztési munkaterhelés.A Windows computer with Visual Studio 2019 or later, and the ASP.NET and web development workload.
  • A .net Core 3,1 SDK.The .NET Core 3.1 SDK.
  • Egy vagy több alábbi eszköz, amelyen üzembe helyezheti és futtathatja az alkalmazást: HoloLens, HoloLens 2, iOS vagy Android.One or more of the following devices on which to deploy and run an app: HoloLens, HoloLens 2, iOS, or Android.

Megjegyzés

Ebben az oktatóanyagban egy Unity és egy ASP.NET Core webalkalmazást fog használni, de az itt látható megközelítés csak azt mutatja be, hogyan oszthat meg más eszközökön az Azure térbeli horgonyok azonosítóit.You'll be using Unity and an ASP.NET Core web app in this tutorial, but the approach here is only to provide an example of how to share Azure Spatial Anchors identifiers across other devices. Ugyanezen cél elérése érdekében más nyelveket és háttér-technológiákat is használhat.You can use other languages and back-end technologies to achieve the same goal.

Térbeli horgonyok erőforrásának létrehozásaCreate a Spatial Anchors resource

Nyissa meg az Azure Portalt.Go to the Azure portal.

A bal oldali panelen válassza az erőforrás létrehozása lehetőséget.On the left pane, select Create a resource.

A keresőmező segítségével megkeresheti a térbeli horgonyokat.Use the search box to search for Spatial Anchors.

A térbeli horgonyok keresésének eredményét bemutató képernyőkép.

Válassza a térbeli horgonyok lehetőséget, majd válassza a Létrehozás lehetőséget.Select Spatial Anchors, and then select Create.

A térbeli horgonyok fiók panelen tegye a következőket:On the Spatial Anchors Account pane, do the following:

  • Adjon meg egy egyedi nevet a normál alfanumerikus karakterek használatával.Enter a unique resource name by using regular alphanumeric characters.

  • Válassza ki azt az előfizetést, amelyhez az erőforrást csatolni kívánja.Select the subscription that you want to attach the resource to.

  • Hozzon létre egy erőforráscsoportot az új létrehozása lehetőség kiválasztásával.Create a resource group by selecting Create new. Nevezze el myResourceGroup, majd kattintson az OK gombra.Name it myResourceGroup, and then select OK.

    Az erőforráscsoport olyan logikai tároló, amelybe a rendszer üzembe helyezi és kezeli az Azure-erőforrásokat, például a webalkalmazásokat, adatbázisokat és a Storage-fiókokat.A resource group is a logical container into which Azure resources, such as web apps, databases, and storage accounts, are deployed and managed. Dönthet úgy is például, hogy később egyetlen egyszerű lépésben törli a teljes erőforráscsoportot.For example, you can choose to delete the entire resource group in one simple step later.

  • Válassza ki azt a helyet (régiót), ahová az erőforrást helyezni kívánja.Select a location (region) in which to place the resource.

  • Válassza az új lehetőséget az erőforrás létrehozásának megkezdéséhez.Select New to begin creating the resource.

Képernyőkép a térbeli horgonyok panelről az erőforrás létrehozásához.

Az erőforrás létrehozása után a Azure Portal mutatja, hogy a telepítés befejeződött.After the resource is created, the Azure portal shows that your deployment is complete.

Az erőforrás-telepítés befejezését bemutató képernyőkép.

Válassza az Erőforrás megnyitása lehetőséget.Select Go to resource. Ekkor megtekintheti az erőforrás tulajdonságait.You can now view the resource properties.

Másolja az erőforrás Account ID értékét egy szövegszerkesztőbe későbbi használatra.Copy the resource's Account ID value into a text editor for later use.

Képernyőkép az erőforrás-tulajdonságok panelről.

Másolja át az erőforrás fiók tartományának értékét egy szövegszerkesztőbe későbbi használatra.Also copy the resource's Account Domain value into a text editor for later use.

Az erőforrás fiók tartományának értékét ábrázoló képernyőkép.

A Beállítások területen válassza a kulcs elemet.Under Settings, select Key. Másolja az elsődleges kulcs értékét, a fiók kulcsát egy szövegszerkesztőbe későbbi használatra.Copy the Primary key value, Account Key, into a text editor for later use.

Képernyőkép a fiókhoz tartozó kulcsok panelről.

A minta projekt letöltéseDownload the sample project

A minták tárházának klónozásához futtassa a következő parancsokat:Clone the samples repository by running the following commands:

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

A megosztási horgonyok szolgáltatás üzembe helyezéseDeploy the Sharing Anchors service

Nyissa meg a Visual studiót, majd nyissa meg a projektet a Sharing\SharingServiceSample mappában.Open Visual Studio, and then open the project in the Sharing\SharingServiceSample folder.

A közzétételi varázsló megnyitásaOpen the publish wizard

Megoldáskezelő kattintson a jobb gombbal a SharingService projektre, majd válassza a Közzététel lehetőséget.In Solution Explorer, right-click the SharingService project, and then select Publish.

Elindul a közzétételi varázsló.The Publish Wizard starts.

Válassza ki app Service > Közzététel elemet a Létrehozás app Service panel megnyitásához.Select App Service > Publish to open the Create App Service pane.

Bejelentkezés az Azure-baSign in to Azure

Jelentkezzen be az Azure Portalra.Sign in to the Azure portal.

A app Service létrehozása panelen válassza a fiók hozzáadása lehetőséget, majd jelentkezzen be az Azure-előfizetésbe.On the Create App Service pane, select Add an account, and then sign in to your Azure subscription. Ha már bejelentkezett, válassza ki a kívánt fiókot a legördülő listából.If you're already signed in, select the account you want from the drop-down list.

Megjegyzés

Ha már be van jelentkezve, akkor még ne válassza a Create (Létrehozás) lehetőséget.If you're already signed in, don't select Create yet.

Hozzon létre egy erőforráscsoportotCreate a resource group

Az erőforráscsoport olyan logikai tároló, amelybe a rendszer üzembe helyezi és kezeli az Azure-erőforrásokat, például a webalkalmazásokat, adatbázisokat és a Storage-fiókokat.A resource group is a logical container into which Azure resources, such as web apps, databases, and storage accounts, are deployed and managed. Dönthet úgy is például, hogy később egyetlen egyszerű lépésben törli a teljes erőforráscsoportot.For example, you can choose to delete the entire resource group in one simple step later.

Az Erőforráscsoport mellett válassza az Új elemet.Next to Resource Group, select New.

Nevezze el az erőforráscsoport myResourceGroup, majd kattintson az OK gombra.Name the resource group myResourceGroup, and then select OK.

App Service-csomag létrehozásaCreate an App Service plan

Az alkalmazást tároló webkiszolgálófarm helyét, méretét és funkcióit egy App Service-csomag határozza meg.An App Service plan specifies the location, size, and features of the web server farm that hosts your app. Pénzt takaríthat meg, ha több alkalmazást is üzemeltet, és úgy konfigurálja a webalkalmazásokat, hogy egyetlen App Service csomagot osszon meg.You can save money when you host multiple apps by configuring the web apps to share a single App Service plan.

Az App Service-csomagok a következőket határozzák meg:App Service plans define:

  • Régió (például: Észak-Európa, az USA keleti régiója vagy Délkelet-Ázsia)Region (for example: North Europe, East US, or Southeast Asia)
  • Példányméret (kicsi, közepes vagy nagy)Instance size (small, medium, or large)
  • Skálázási szám (1–20 példány)Scale count (1 to 20 instances)
  • Termékváltozat (Ingyenes, Közös, Alapszintű, Standard, Prémium)SKU (Free, Shared, Basic, Standard, or Premium)

A Szolgáltatási csomag mellett válassza az Új elemet.Next to Hosting Plan, select New.

A üzemeltetési terv konfigurálása panelen használja az alábbi beállításokat:On the Configure Hosting Plan pane, use these settings:

BeállításSetting Ajánlott értékSuggested value LeírásDescription
App Service-csomagApp Service plan MySharingServicePlanMySharingServicePlan Az App Service terv neveName of the App Service plan
HelyLocation USA nyugati régiójaWest US Az az adatközpont, amelyen a webalkalmazás futThe datacenter where the web app is hosted
MéretSize IngyenesFree Az üzemeltetési funkciókat meghatározó díjszabási csomagThe pricing tier that determines hosting features

Válassza az OK lehetőséget.Select OK.

A webapp létrehozása és közzétételeCreate and publish the web app

Az alkalmazás neve mezőben adjon meg egy egyedi nevet.In App Name, enter a unique app name. Érvényes karakterek: a-z, 0-9 és kötőjel (-), vagy fogadja el az automatikusan létrehozott egyedi nevet.Valid characters are a-z, 0-9, and dashes (-), or accept the automatically generated unique name. A webalkalmazás URL-címe https://<app_name>.azurewebsites.net, amelyben az <app_name> az alkalmazás neve.The URL of the web app is https://<app_name>.azurewebsites.net, where <app_name> is your app name.

A Create (Létrehozás) gombra kattintva hozzákezdhet az Azure-erőforrások létrehozásához.Select Create to start creating the Azure resources.

A varázsló befejeződése után közzéteszi a ASP.NET Core webalkalmazást az Azure-ban, majd megnyitja az alkalmazást az alapértelmezett böngészőben.After the wizard finishes, it publishes the ASP.NET Core web app to Azure and then opens the app in your default browser.

Képernyőkép egy közzétett ASP.NET-webalkalmazásról az Azure-ban.

Az ebben a szakaszban használt alkalmazás neve URL-előtagként van megadva a formátumban https://<app_name>.azurewebsites.net .The app name you used in this section is used as the URL prefix in the format https://<app_name>.azurewebsites.net. Másolja ezt az URL-címet egy szövegszerkesztőbe későbbi használatra.Copy this URL to a text editor for later use.

A minta alkalmazás üzembe helyezéseDeploy the sample app

A Java Android-minta támogatja az eszközök közötti megosztást.The Java Android sample supports sharing across devices.

A Android Studioban nyissa meg a SharedActivity. Java fájlt a Samples mappából.In Android Studio, open the SharedActivity.java file from the samples folder.

Adja meg azt az URL-címet, amelyet az előző lépésben másolt (a ASP.NET Web App Azure-beli telepítésből) a SharingAnchorsServiceUrl SharedActivity. Java fájl értékeként.Enter the URL that you copied in the previous step (from your ASP.NET web app Azure deployment) as the value for SharingAnchorsServiceUrl in the SharedActivity.java file.

Cserélje le az index.html URL-címet a alkalmazásban api/anchors .Replace the index.html in the URL with api/anchors. A következőhöz hasonlóan kell kinéznie: https://<app_name>.azurewebsites.net/api/anchors .It should look like this: https://<app_name>.azurewebsites.net/api/anchors.

Telepítse az alkalmazást az eszközre.Deploy the app to your device.

Az alkalmazás elindítása után a bemutató kiválasztása panelen kattintson a bal és jobb nyílra a LocalShare beállítás kiválasztásához.After the app starts, on the Choose A Demo pane, use the left and right arrows to select the LocalShare option. Ezután koppintson a Go! elemre.Then tap Go!.

Kövesse az alkalmazás utasításait.Follow the instructions in the app. Válassza a létrehozás & megosztási horgony vagy a megosztott horgony keresése lehetőséget.You can select Create & Share Anchor or Locate Shared Anchor.

Hozzon létre egy horgonyt, és mentse a megosztási szolgáltatásba & megosztási horgony létrehozásával.With Create & Share Anchor, you can create an anchor and save it to your sharing service. A Return utasításban vissza kell kérnie az azonosítóját, amelyet a rendszer a megosztási szolgáltatásból való lekérésére használhat.In return, you will get back an identifier for it that you can use to retrieve it from the sharing service. Ezután futtathatja a második forgatókönyvet, megkeresheti a megosztott horgonyt akár az eszközről, akár egy másikat.You can then run the second scenario, Locate Shared Anchor, from either your device or a different one.

A megosztott horgony keresése lehetőséggel megkeresheti a korábban megosztott horgonyokat a korábban említett azonosító beírásával.With Locate Shared Anchor, you can locate previously shared anchors by entering the identifier mentioned earlier. A forgatókönyv kiválasztása után az alkalmazás további utasításokat is tartalmaz.After you pick your scenario, the app will guide you with further instructions. A rendszer például arra kéri, hogy helyezze át az eszközt a környezeti információk összegyűjtéséhez.For example, you'll be asked to move your device around to collect environment information. Később egy horgonyt helyezünk el a világba, várja meg a mentést, indítson el egy új munkamenetet, majd keresse meg.Later on, you'll place an anchor in the world, wait for it to save, start a new session, and then locate it.

Az erőforrások eltávolításaClean up resources

Az előző lépésekben Azure-erőforrásokat hozott létre egy erőforráscsoportban.In the preceding steps, you created Azure resources in a resource group. Ha várhatóan nincs szüksége ezekre az erőforrásokra a későbbiekben, az erőforráscsoport eltávolításával törölheti őket.If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

Az Azure Portal menüben vagy a kezdőlapon válassza az erőforráscsoportok lehetőséget.From the Azure portal menu or Home page, select Resource groups. Ezután az erőforráscsoportok lapon válassza a myResourceGroup lehetőséget.Then, on the Resource groups page, select myResourceGroup.

A myResourceGroup lapon győződjön meg arról, hogy a felsorolt erőforrások közül azokat törölni kívánja.On the myResourceGroup page, make sure that the listed resources are the ones you want to delete.

Válassza az erőforráscsoport törlése elemet, írja be a myResourceGroup szöveget a megerősítéshez, majd válassza a Törlés lehetőséget.Select Delete resource group, type myResourceGroup in the text box to confirm, and then select Delete.

Következő lépésekNext steps

Ebben az oktatóanyagban üzembe helyezett egy ASP.NET Core webalkalmazást az Azure-ban, és egy Unity-alkalmazást konfigurált és telepített.In this tutorial, you deployed an ASP.NET Core web app in Azure, and you configured and deployed a Unity app. A térbeli horgonyok az alkalmazással lettek létrehozva, és a ASP.NET Core webalkalmazás használatával megosztva más eszközökkel.You created spatial anchors with the app, and you shared them with other devices by using your ASP.NET Core web app.

Javíthatja ASP.NET Core webalkalmazását úgy, hogy az Azure Cosmos DB használatával megtartja a megosztott térbeli horgonyok azonosítóinak tárolóját.You can improve your ASP.NET Core web app so that it uses Azure Cosmos DB to persist the storage of your shared spatial anchors identifiers. Azure Cosmos DB támogatás hozzáadásával a ASP.NET Core webalkalmazás létrehoz egy horgonyt még ma.By adding Azure Cosmos DB support, you can have your ASP.NET Core web app create an anchor today. Ezt követően a webalkalmazásban tárolt Anchor-azonosító használatával később is visszatérhet az alkalmazás, hogy újra megkeresse a horgonyt.Then, by using the anchor identifier that's stored in your web app, you can have the app return days later to locate the anchor again.