Gyors útmutató: Android-alkalmazás létrehozása az Azure térbeli HorgonyokkalQuickstart: Create an Android app with Azure Spatial Anchors

Ez a rövid útmutató azt ismerteti, hogyan hozhat létre Android-alkalmazást az Azure térbeli horgonyok használatával Java-vagy C++/NDK.-benThis quickstart covers how to create an Android app using Azure Spatial Anchors in either Java or C++/NDK. Az Azure térbeli horgonyok egy többplatformos fejlesztői szolgáltatás, amely lehetővé teszi, hogy vegyes valóságot hozzon létre olyan objektumok használatával, amelyek az adott helyen maradnak a helyükön az egyes eszközökön.Azure Spatial Anchors is a cross-platform developer service that allows you to create mixed reality experiences using objects that persist their location across devices over time. Ha elkészült, egy ARCore Android-alkalmazás fog rendelkezni, amely képes a térbeli horgonyok mentésére és visszahívására.When you're finished, you'll have an ARCore Android app that can save and recall a spatial anchor.

A következőket fogja megtanulni:You'll learn how to:

  • Térbeli horgonyok fiók létrehozásaCreate a Spatial Anchors account
  • A térbeli horgonyok fiókazonosító és a fiók kulcsának konfigurálásaConfigure the Spatial Anchors account identifier and account key
  • Üzembe helyezés és Futtatás Android-eszközönDeploy and run on an Android device

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

A rövid útmutató elvégzéséhez győződjön meg arról, hogy rendelkezik az alábbiakkal:To complete this quickstart, make sure you have:

  • Windows vagy macOS rendszerű számítógép, Android Studio 3.4 +.A Windows or macOS machine with Android Studio 3.4+.
    • Ha Windows rendszeren fut, a git for Windows és a git LFSis szüksége lesz.If running on Windows, you'll also need Git for Windows and Git LFS.
    • Ha macOS rendszeren fut, a git a HomeBrew használatával telepíthető.If running on macOS, get Git installed via HomeBrew. Adja meg a következő parancsot a terminál egyetlen sorában: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)".Enter the following command into a single line of the Terminal: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)". Ezután futtassa brew install git és brew install git-lfs.Then, run brew install git and brew install git-lfs.
    • A NDK minta létrehozásához telepítenie kell a NDK és a CMak 3,6-es vagy újabb SDK-eszközöket is a Android Studio-ben.To build the NDK sample, you'll also need to install the NDK and CMake 3.6 or greater SDK Tools in Android Studio.
  • A fejlesztők számára engedélyezett és ARCore alkalmas Android-eszköz.A developer enabled and ARCore capable Android device.
    • Előfordulhat, hogy a számítógépe számára további eszközillesztők szükségesek az Android-eszközkel való kommunikációhoz.Additional device drivers may be required for your computer to communicate with your Android device. További információért és útmutatásért lásd itt .See here for additional information and instructions.
  • Az alkalmazásnak meg kell céloznia a ARCore 1.11.0.Your app must target ARCore 1.11.0.

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

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

Az Azure portal bal oldali navigációs panelén válassza erőforrás létrehozása.In the left navigation pane in the Azure portal, select Create a resource.

A keresőmezőt használva keressen térbeli horgonyok.Use the search box to search for Spatial Anchors.

Térbeli horgonyok keresése

Válassza ki térbeli horgonyok.Select Spatial Anchors. A párbeszédpanelen válassza ki a létrehozás.In the dialog box, select Create.

Az a térbeli horgonyok fiók párbeszédpanel:In the Spatial Anchors Account dialog box:

  • Adja meg egy egyedi erőforráscsoport nevét, rendszeres alfanumerikus karakterek használatával.Enter a unique resource name, using regular alphanumeric characters.

  • Válassza ki az előfizetést, amelyhez csatolja az erőforrást.Select the subscription that you want to attach the resource to.

  • Hozzon létre egy erőforráscsoportot kiválasztásával új létrehozása.Create a resource group by selecting Create new. Nevezze el myResourceGroup válassza OK.Name it myResourceGroup and select OK. Az erőforráscsoport olyan logikai tároló, amelyben a rendszer üzembe helyezi és kezeli az Azure-erőforrásokat (például webalkalmazásokat, adatbázisokat és tárfiókokat).A resource group is a logical container into which Azure resources like 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 a helyet (régiót) az erőforrás helyét is.Select a location (region) in which to place the resource.

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

    Erőforrás létrehozása

Az erőforrás létrehozása után az Azure portálon az jelenik meg, hogy a telepítés befejeződött.After the resource is created, Azure Portal will show that your deployment is complete. Kattintson az Erőforrás megnyitása elemre.Click Go to resource.

Üzembe helyezés kész

Ezt követően megtekintheti az erőforrás-tulajdonságok is.Then, you can view the resource properties. Másolja ki az erőforrás Fiókazonosító értékét egy szövegszerkesztőbe, mert később szüksége.Copy the resource's Account ID value into a text editor because you'll need it later.

Erőforrás-tulajdonságok

A beállításokválassza kulcs.Under Settings, select Key. Másolás a elsődleges kulcs értékét egy szövegszerkesztőbe.Copy the Primary key value into a text editor. Ez az érték a Account Key.This value is the Account Key. Erre később még szüksége lesz.You'll need it later.

Fiókkulcs

A minta projekt megnyitásaOpen the sample project

Klónozás a mintaadattárban a következő parancs futtatásával:Clone the samples repository by running the following command:

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

Nyissa meg az Android Studiót.Open Android Studio.

Válassza a meglévő Android Studio projekt megnyitása lehetőséget, és válassza ki a Android/Java/címen található projektet.Select Open an existing Android Studio project and select the project located at Android/Java/.

Fiók azonosítójának és kulcsának konfigurálásaConfigure account identifier and key

A következő lépés az alkalmazás konfigurálása a fiók azonosítójának és a fiók kulcsának használatára.The next step is to configure the app to use your account identifier and account key. A térbeli horgonyok erőforrásának beállításakoregy szövegszerkesztőbe másolta őket.You copied them into a text editor when setting up the Spatial Anchors resource.

Nyissa meg a Android/Java/app/src/main/java/com/microsoft/sampleandroid/AzureSpatialAnchorsManager.java alkalmazást.Open Android/Java/app/src/main/java/com/microsoft/sampleandroid/AzureSpatialAnchorsManager.java.

Keresse meg a SpatialAnchorsAccountKey mezőt, és cserélje le a Set met a fiók kulcsára.Locate the SpatialAnchorsAccountKey field and replace Set me with the account key.

Keresse meg a SpatialAnchorsAccountId mezőt, és cserélje le a Set met a fiók azonosítójával.Locate the SpatialAnchorsAccountId field and replace Set me with the account identifier.

Az alkalmazás üzembe helyezése Android-eszközönDeploy the app to your Android device

Kapcsolja be az androidos eszközt, jelentkezzen be, és csatlakoztassa a számítógéphez egy USB-kábellel.Power on the Android device, sign in, and connect it to the PC using a USB cable.

Válassza a Futtatás lehetőséget a Android Studio eszköztáron.Select Run from the Android Studio toolbar.

Android Studio üzembe helyezés és Futtatás

Válassza ki az Android-eszközt a telepítési cél kiválasztása párbeszédpanelen, majd kattintson az OK gombra az alkalmazás Android-eszközön való futtatásához.Select the Android device in the Select Deployment Target dialog, and select OK to run the app on the Android device.

A horgonyok elhelyezéséhez és felidézéséhez kövesse az alkalmazás utasításait.Follow the instructions in the app to place and recall an anchor.

Állítsa le az alkalmazást a Android Studio eszköztárból válassza a Leállítás lehetőséget.Stop the app by selecting Stop from the Android Studio toolbar.

Android Studio leállítása

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.

A Azure Portal menüben vagy a kezdőlapon válassza az erőforráscsoportoklehetőséget, majd az erőforráscsoportok lapon válassza a myResourceGrouplehetőséget.From the Azure portal menu or Home page, select Resource groups, and 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 a Törlés elemet, írja be a myResourceGroup kifejezést a szövegmezőbe, majd válassza a Törlés elemet.Select Delete, type myResourceGroup in the text box, and then select Delete.

További lépésekNext steps

Ebben a rövid útmutatóban létrehozott egy térbeli horgonyok fiókot.In this quickstart, you created a Spatial Anchors account. Konfigurált és telepített mentéséhez és a térbeli horgonyok visszahívása alkalmazást.You then configured and deployed an app to save and recall spatial anchors. Az alkalmazás fejlesztéséhez, így térbeli horgonyok megoszthatja más eszközökkel kapcsolatos további információkért folytassa a következő oktatóanyaggal.To learn more about how to improve the app so it can share spatial anchors with other devices, continue to the next tutorial.