A mintaalkalmazás futtatása: Android – Android Studio (Java vagy C++/NDK)

Cikk
10/26/2023

Ez a rövid útmutató bemutatja, hogyan futtatható az Azure Spatial Anchors mintaalkalmazás Android-eszközökhöz Android Studio (Java vagy C++/NDK) használatával. Az Azure Spatial Anchors egy platformfüggetlen fejlesztői szolgáltatás, amely lehetővé teszi vegyes valósági élmények létrehozását olyan objektumok használatával, amelyek folyamatosan megőrzik helyüket az eszközökön. Ha végzett, egy ARCore Android-alkalmazással fog rendelkezni, amely menthet és visszahívhat egy térbeli horgonyt.

A következőket fogja megtanulni:

Térbeli horgonyfiók létrehozása
A Térbeli horgonyok fiókazonosítójának és fiókkulcsának konfigurálása
Üzembe helyezés és futtatás Android-eszközön

If you don't have an Azure subscription, create an Azure free account before you begin.

Előfeltételek

A rövid útmutató elvégzéséhez győződjön meg arról, hogy rendelkezik az alábbiakkal:

Windows vagy macOS rendszerű gép Android Studio 3.4+ verzióval.
- Ha Windows rendszeren fut, akkor a Windowshoz és a Git LFS-hez is szüksége lesz a Gitre.
- Ha macOS rendszeren fut, telepítse a Gitet a HomeBrew használatával. Adja meg a következő parancsot a terminál egyetlen sorába: /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.
- Az NDK-minta létrehozásához telepítenie kell az NDK-t és a CMake 3.6-os vagy újabb SDK-eszközöket az Android Studióban.
Egy fejlesztő által engedélyezett és ARCore-kompatibilis Android-eszköz.
- Előfordulhat, hogy további eszközillesztőkre van szükség ahhoz, hogy a számítógép kommunikáljon az Android-eszközével. További információt és útmutatást itt talál.
Az alkalmazásnak meg kell céloznia az ARCore 1.11.0-t.

Térbeli horgonyerőforrás létrehozása

Nyissa meg az Azure Portalt.

A bal oldali panelen válassza az Erőforrás létrehozása lehetőséget.

A keresőmezővel keresse meg a térbeli horgonyokat.

Válassza a Térbeli horgonyok, majd a Létrehozás lehetőséget.

A Térbeli horgonyok fiók panelen tegye a következőket:

Adjon meg egy egyedi erőforrásnevet normál alfanumerikus karakterek használatával.
Válassza ki azt az előfizetést, amelyhez csatolni szeretné az erőforrást.
Hozzon létre egy erőforráscsoportot az Új létrehozása gombra kattintva. Nevezze el a myResourceGroup nevet, majd kattintson az OK gombra.

Az erőforráscsoport egy logikai tároló, amelybe az Azure-erőforrásokat, például webalkalmazásokat, adatbázisokat és tárfiókokat helyezik üzembe és felügyelik. Dönthet úgy is például, hogy később egyetlen egyszerű lépésben törli a teljes erőforráscsoportot.
Válassza ki azt a helyet (régiót), ahol az erőforrást el szeretné helyezni.
Válassza a Létrehozás lehetőséget az erőforrás létrehozásának megkezdéséhez.

Screenshot of the Spatial Anchors pane for creating a resource.

Az erőforrás létrehozása után az Azure Portalon látható, hogy az üzembe helyezés befejeződött.

Screenshot showing that the resource deployment is complete.

Válassza az Erőforrás megnyitása lehetőséget. Most már megtekintheti az erőforrás tulajdonságait.

Másolja az erőforrás Fiókazonosító értékét egy szövegszerkesztőbe későbbi használatra.

Screenshot of the resource properties pane.

Az erőforrás Fióktartomány értékét is másolja egy szövegszerkesztőbe későbbi használatra.

Screenshot showing the resource's account domain value.

A Gépház alatt válassza az Access-kulcsot. Másolja az elsődleges kulcs értékét ( Fiókkulcs) egy szövegszerkesztőbe későbbi használatra.

Screenshot of the Keys pane for the account.

Először készítse elő a környezetet az Azure CLI-hez:

Használja a Bash-környezetet az Azure Cloud Shellben. További információ: A Bash rövid útmutatója az Azure Cloud Shellben.
Ha inkább helyi cli-referenciaparancsokat szeretne futtatni, telepítse az Azure CLI-t. Ha Windows vagy macOS rendszert használ, fontolja meg az Azure CLI Docker-tárolóban való futtatását. További információ: Az Azure CLI futtatása Docker-tárolóban.
- Ha helyi telepítést használ, jelentkezzen be az Azure CLI-be az az login parancs futtatásával. A hitelesítési folyamat befejezéséhez kövesse a terminálon megjelenő lépéseket. További bejelentkezési lehetőségekért lásd : Bejelentkezés az Azure CLI-vel.
- Amikor a rendszer kéri, először telepítse az Azure CLI-bővítményt. További információ a bővítményekről: Bővítmények használata az Azure CLI-vel.
- Futtassa az az version parancsot a telepített verzió és a függő kódtárak megkereséséhez. A legújabb verzióra az az upgrade paranccsal frissíthet.

A bejelentkezés után az az account set paranccsal válassza ki azt az előfizetést, amelyben a térbeli horgonyfiókot be szeretné állítani:
```
az account set --subscription 00000000-0000-0000-0000-000000000000
```
Futtassa az az group create parancsot egy erőforráscsoport létrehozásához, vagy használjon egy meglévő erőforráscsoportot:
```
az group create --name myResourceGroup --location eastus2
```
Az erőforráscsoport egy logikai tároló, amelybe az Azure-erőforrásokat, például webalkalmazásokat, adatbázisokat és tárfiókokat helyezik üzembe és felügyelik. Dönthet úgy is például, hogy később egyetlen egyszerű lépésben törli a teljes erőforráscsoportot.

Az erőforráscsoport aktuális térbeli horgonyfiókjait az az spatial-anchors-account list paranccsal tekintheti meg:
```
az spatial-anchors-account list --resource-group myResourceGroup
```
Az előfizetés térbeli horgonyfiókjait is megtekintheti:
```
az spatial-anchors-account list
```

Futtassa az az spatial-anchors-account create parancsot a térbeli horgonyfiók létrehozásához:

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

Az erőforrás tulajdonságainak megtekintése az az spatial-anchors-account show paranccsal:
```
az spatial-anchors-account show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
```
Másolja az erőforrásfiók azonosítóját és az erőforrásfiók tartományértékét egy szövegszerkesztőbe későbbi használatra.

Futtassa az az spatial-anchors-account key show parancsot az elsődleges és másodlagos kulcsok lekéréséhez:

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

Másolja a kulcsértékeket egy szövegszerkesztőbe későbbi használatra.

Ha újra kell létrehoznia a kulcsokat, használja az az spatial-anchors-account key renew parancsot:

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

A fiók törléséhez használja az az spatial-anchors-account delete parancsot:

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

Először készítse elő a környezetet az Azure PowerShellhez:

Ha az Azure PowerShell helyi használatát választja:
- Telepítse az Az PowerShell-modul legújabb verzióját.
- Csatlakozás az Azure-fiókjába az Csatlakozás-AzAccount parancsmag használatával.
Ha az Azure Cloud Shell használata mellett dönt:
- További információkért tekintse meg az Azure Cloud Shell áttekintését.

Fontos

Bár az Az.MixedReality PowerShell-modul előzetes verzióban érhető el, a parancsmaggal Install-Module külön kell telepítenie. Miután ez a PowerShell-modul általánosan elérhetővé válik, a jövőbeli Az PowerShell modulkiadások részévé válik, és natívan elérhető lesz az Azure Cloud Shellből.

Install-Module -Name Az.MixedReality

A bejelentkezés után a Set-AzContext parancsmaggal válassza ki azt az előfizetést, amelyben be szeretné állítani a térbeli horgonyfiókot:
```
Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
```
Futtassa a New-AzResourceGroup parancsmagot egy erőforráscsoport létrehozásához, vagy használjon egy meglévő erőforráscsoportot:
```
New-AzResourceGroup -Name myResourceGroup -Location eastus2
```
Az erőforráscsoport egy logikai tároló, amelybe az Azure-erőforrásokat, például webalkalmazásokat, adatbázisokat és tárfiókokat helyezik üzembe és felügyelik. Dönthet úgy is például, hogy később egyetlen egyszerű lépésben törli a teljes erőforráscsoportot.

Az erőforráscsoport aktuális térbeli horgonyfiókjait a Get-AzSpatialAnchorsAccount parancsmaggal tekintheti meg:
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
```
Az előfizetés térbeli horgonyfiókjait is megtekintheti:
```
Get-AzSpatialAnchorsAccount
```

Futtassa a New-AzSpatialAnchorsAccount parancsmagot a térbeli horgonyfiók létrehozásához:

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

Tekintse meg az erőforrás tulajdonságait a Get-AzSpatialAnchorsAccount parancsmaggal:
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
```
Másolja a tulajdonság accountId értékét és a tulajdonságfiókDomainértékét egy szövegszerkesztőbe későbbi használatra.

Futtassa a Get-AzSpatialAnchorsAccountKey parancsmagot az elsődleges és másodlagos kulcsok lekéréséhez:

Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Másolja a kulcsértékeket egy szövegszerkesztőbe későbbi használatra.

Ha újra kell létrehoznia a kulcsokat, használja a New-AzSpatialAnchorsAccountKey parancsmagot:

New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Primary
New-AzSpatialAnchorsAccountKey -ResourceGroupName myResourceGroup -Name MySpatialAnchorsQuickStart -Secondary

A fiókot a Remove-AzSpatialAnchorsAccount parancsmaggal törölheti:

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Klónozza a mintaadattárat az alábbi parancsok futtatásával:

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

Klónozza a mintaadattárat az alábbi parancsok futtatásával:

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

Töltse le arcore_c_api.h innen, és helyezze el a Android\NDK\libraries\include.

Az újonnan klónozott adattárból inicializálja az almodulokat az alábbi parancs futtatásával:

git submodule update --init --recursive

Nyissa meg az Android Studiót.

Java
NDK

Válassza a Meglévő Android Studio-projekt megnyitása lehetőséget, és válassza ki a következő helyen Android/Java/található projektet: .

Fiókazonosító és -kulcs konfigurálása

A következő lépés az alkalmazás konfigurálása a fiókazonosító és a fiókkulcs használatára. A Térbeli horgonyok erőforrás beállításakor átmásolta őket egy szövegszerkesztőbe.

Java
NDK

Nyílt Android/Java/app/src/main/java/com/microsoft/sampleandroid/AzureSpatialAnchorsManager.java.

Keresse meg a SpatialAnchorsAccountKey mezőt, és cserélje le Set me a fiókkulcsra.

Keresse meg a SpatialAnchorsAccountId mezőt, és cserélje le Set me a fiókazonosítóra.

Keresse meg a SpatialAnchorsAccountDomain mezőt, és cserélje le Set me a fióktartományra.

Az alkalmazás üzembe helyezése Android-eszközön

Kapcsolja be az Android-eszközt, jelentkezzen be, és csatlakoztassa a pc-hez EGY USB-kábellel.

Válassza a Futtatás lehetőséget az Android Studio eszköztárán.

Android Studio Deploy and Run

Válassza ki az Android-eszközt a Telepítési cél kiválasztása párbeszédpanelen, majd az OK gombra kattintva futtassa az alkalmazást az Android-eszközön.

Kövesse az alkalmazás utasításait egy horgony elhelyezéséhez és visszahívásához.

Állítsa le az alkalmazást az Android Studio eszköztár Stop elemének kiválasztásával.

Android Studio Stop

Clean up resources

Az előző lépésekben Azure-erőforrásokat hozott létre egy erőforráscsoportban. 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.

Az Azure Portal menüjében vagy kezdőlapján válassza az Erőforráscsoportok lehetőséget. Ezután az Erőforráscsoportok lapon válassza a myResourceGroup lehetőséget.

A myResourceGroup lapon győződjön meg arról, hogy a felsorolt erőforrásokat törölni szeretné.

Válassza az Erőforráscsoport törlése lehetőséget, írja be a myResourceGroup kifejezést a szövegmezőbe a megerősítéshez, majd válassza a Törlés lehetőséget.

Következő lépések

Ebben a rövid útmutatóban létrehozott egy Térbeli horgonyfiókot. Ezután konfigurált és üzembe helyezett egy alkalmazást a térbeli horgonyok mentéséhez és visszahívásához. Ha többet szeretne megtudni arról, hogyan fejlesztheti az alkalmazást, hogy más eszközökkel is megosztható legyen a térbeli horgonyok, folytassa a következő oktatóanyaggal.

Oktatóanyag: Térbeli horgonyok megosztása eszközök között