Ejecución de la aplicación de ejemplo: Android - Android Studio (Java o C++/NDK)

Artículo
03/10/2023

En este inicio rápido se explica cómo ejecutar la aplicación de ejemplo de Azure Spatial Anchors para dispositivos Android mediante Android Studio (Java o C++/NDK). Azure Spatial Anchors es un servicio multiplataforma para desarrolladores que le permite crear experiencias de realidad mixta mediante objetos cuya ubicación persiste en todos los dispositivos a lo largo del tiempo. Cuando haya terminado, tendrá una aplicación para Android de ARCore que puede guardar y recuperar un delimitador espacial.

Aprenderá a:

Crear una cuenta de Spatial Anchors
Configurar la clave y el identificador de la cuenta de Spatial Anchors
Realizar la implementación y ejecución en un dispositivo Android

Si no tiene una suscripción a Azure, cree una cuenta gratuita de Azure antes de empezar.

Prerrequisitos

Para completar este inicio rápido, asegúrese de que dispone de lo siguiente:

Una máquina Windows o macOS con Android Studio 3.4 o superior.
- Si se ejecuta en Windows, también necesitará Git para Windows y Git LFS.
- Si se ejecuta en macOS, instale Git a través de HomeBrew. Escriba el siguiente comando en una sola línea de Terminal: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)". Luego, ejecute brew install git y brew install git-lfs.
- Para compilar el ejemplo de NDK, también deberá instalar las herramientas NDK y CMake 3.6 o posterior de SDK Tools en Android Studio.
Un dispositivo Android habilitado para el desarrollo y preparado para ARCore.
- Puede que se necesiten controladores de dispositivo adicionales para que el equipo se comunique con el dispositivo Android. Para más información e instrucciones, visite este vínculo.
La aplicación debe tener como destino ARCore 1.11.0.

Creación de un recurso de Spatial Anchors

Vaya a Azure Portal.

En el menú izquierdo, seleccione Crear un recurso.

Use el cuadro de búsqueda para buscar Spatial Anchors.

Seleccione Spatial Anchors y, después, seleccione Crear.

En el panel Cuenta de Spatial Anchors, haga lo siguiente:

Escriba un nombre de recurso único con caracteres alfanuméricos normales.
Seleccione la suscripción a la que desea asociar el recurso.
Cree un grupo de recursos, para lo que debe seleccionar Crear nuevo. Asígnele el nombre myResourceGroup y luego seleccione Aceptar.

Un grupo de recursos es un contenedor lógico en el que los recursos de Azure, como aplicaciones web, bases de datos y cuentas de almacenamiento, se implementen y administren. Por ejemplo, más adelante puede elegir eliminar todo el grupo de recursos en un solo paso.
Seleccione la ubicación (región) en la que desea colocar el recurso.
Seleccione Crear para empezar a crear el recurso.

Captura de pantalla del panel Spatial Anchors para crear un recurso.

Una vez creado el recurso, Azure Portal muestra que se ha completado la implementación.

Captura de pantalla que muestra que la implementación del recurso se ha completado.

Haga clic en Go to resource (Ir al recurso). Ahora puede ver las propiedades del recurso.

Copie el valor de Id. de cuenta del recurso en un editor de texto para usarlo más adelante.

Captura de pantalla del panel de propiedades de recursos.

Copie también el valor de Account Domain (Dominio de cuenta) del recurso en un editor de texto para usarlo más adelante.

Captura de pantalla que muestra el valor del dominio de la cuenta del recurso.

En Configuración, seleccione Clave de acceso. Copie el valor de Clave principal, Clave de cuenta, en un editor de texto para su uso posterior.

Captura de pantalla del panel de claves de la cuenta.

Empiece por preparar el entorno para la CLI de Azure:

Use el entorno de Bash en Azure Cloud Shell. Para más información, consulte Inicio rápido para Bash en Azure Cloud Shell.
Si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure. Si utiliza Windows o macOS, considere la posibilidad de ejecutar la CLI de Azure en un contenedor Docker. Para más información, vea Ejecución de la CLI de Azure en un contenedor de Docker.
- Si usa una instalación local, inicie sesión en la CLI de Azure mediante el comando az login. Siga los pasos que se muestran en el terminal para completar el proceso de autenticación. Para ver otras opciones de inicio de sesión, consulte Inicio de sesión con la CLI de Azure.
- En caso de que se le solicite, instale las extensiones de la CLI de Azure la primera vez que la use. Para más información sobre las extensiones, consulte Uso de extensiones con la CLI de Azure.
- Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.

Después de iniciar sesión, use el comando az account set para seleccionar la suscripción en la que desea configurar la cuenta de Spatial Anchors:
```
az account set --subscription 00000000-0000-0000-0000-000000000000
```
Ejecute el comando az group create para crear un grupo de recursos o use un grupo de recursos existente:
```
az group create --name myResourceGroup --location eastus2
```
Un grupo de recursos es un contenedor lógico en el que los recursos de Azure, como aplicaciones web, bases de datos y cuentas de almacenamiento, se implementen y administren. Por ejemplo, más adelante puede elegir eliminar todo el grupo de recursos en un solo paso.

Para ver las cuentas de Spatial Anchors actuales de un grupo de recursos, use el comando az spatial-anchors-account list:
```
az spatial-anchors-account list --resource-group myResourceGroup
```
También puede ver las cuentas de Spatial Anchors de su suscripción:
```
az spatial-anchors-account list
```

Ejecute el comando az spatial-anchors-account create para crear su cuenta de Spatial Anchors:

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

Para ver las propiedades de los recursos, use el comando az spatial-anchors-account show:
```
az spatial-anchors-account show --resource-group myResourceGroup --name MySpatialAnchorsQuickStart
```
Copie también los valores de Account ID (Identificador de cuenta) y Account Domain (Dominio de cuenta) del recurso en un editor de texto para usarlo más adelante.

Ejecute el comando az spatial-anchors-account key show para obtener sus claves principales y secundarias:

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

Copie los valores de clave en un editor de texto para su posterior uso.

Si tiene que volver a generar las claves, use el comando az spatial-anchors-account key 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

Puede eliminar una cuenta mediante el comando az spatial-anchors-account delete:

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

Empiece por preparar el entorno para Azure PowerShell:

Si opta por usar Azure PowerShell en un entorno local:
- Instale la versión más reciente del módulo Az de PowerShell.
- Conéctese a su cuenta de Azure mediante el cmdlet Connect-AzAccount.
Si decide usar Azure Cloud Shell:
- Para más información, consulte Introducción a Azure Cloud Shell.

Importante

Mientras el módulo Az.MixedReality de PowerShell esté en versión preliminar, se debe instalar por separado mediante el cmdlet Install-Module. Una vez que este módulo de PowerShell esté disponible con carácter general, formará parte de las futuras versiones del módulo Az de PowerShell y estará disponible de forma predeterminada en Azure Cloud Shell.

Install-Module -Name Az.MixedReality

Después de iniciar sesión, use el cmdlet Set-AzContext para seleccionar la suscripción en la que desea configurar la cuenta de Spatial Anchors:
```
Set-AzContext -SubscriptionId 00000000-0000-0000-0000-000000000000
```
Ejecute el cmdlet New-AzResourceGroup para crear un grupo de recursos o utilice uno existente:
```
New-AzResourceGroup -Name myResourceGroup -Location eastus2
```
Un grupo de recursos es un contenedor lógico en el que los recursos de Azure, como aplicaciones web, bases de datos y cuentas de almacenamiento, se implementen y administren. Por ejemplo, más adelante puede elegir eliminar todo el grupo de recursos en un solo paso.

Para ver las cuentas de Spatial Anchors actuales de un grupo de recursos, use el cmdlet Get-AzSpatialAnchorsAccount:
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup
```
También puede ver las cuentas de Spatial Anchors de su suscripción:
```
Get-AzSpatialAnchorsAccount
```

Ejecute el cmdlet New-AzSpatialAnchorsAccount para crear la cuenta de Spatial Anchors:

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

Puede ver las propiedades del recurso mediante el cmdlet Get-AzSpatialAnchorsAccount:
```
Get-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart
```
Copie los valores de las propiedades accountId y accountDomain en un editor de texto para usarlos más adelante.

Ejecute el cmdlet Get-AzSpatialAnchorsAccountKey para obtener la clave principal y secundaria:

Get-AzSpatialAnchorsAccountKey -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Copie los valores de clave en un editor de texto para su posterior uso.

Si necesita regenerar las claves, use el cmdlet New-AzSpatialAnchorsAccountKey:

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

Puede eliminar una cuenta mediante el cmdlet Remove-AzSpatialAnchorsAccount:

Remove-AzSpatialAnchorsAccount -ResourceGroup myResourceGroup -Name MySpatialAnchorsQuickStart

Ejecute los siguientes comandos para clonar el repositorio de ejemplos:

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

Ejecute los siguientes comandos para clonar el repositorio de ejemplos:

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

Descargue arcore_c_api.h desde aquí y colóquelo en Android\NDK\libraries\include.

Desde el repositorio recién clonado, inicialice los submódulos ejecutando el comando siguiente:

git submodule update --init --recursive

Abra Android Studio.

Java
NDK

Seleccione Open an existing Android Studio project (Abrir un proyecto existente de Android Studio) y el proyecto que se encuentra en Android/Java/.

Configuración del identificador y la clave de la cuenta

El paso siguiente es configurar la aplicación para usar el identificador de cuenta y la clave de cuenta. Los copió en un editor cuando configuró el recurso de Spatial Anchors.

Java
NDK

Abra Android/Java/app/src/main/java/com/microsoft/sampleandroid/AzureSpatialAnchorsManager.java.

Busque el campo SpatialAnchorsAccountKey y reemplace Set me por la clave de la cuenta.

Busque el campo SpatialAnchorsAccountId y reemplace Set me por el identificador de la cuenta.

Busque el SpatialAnchorsAccountDomain campo y reemplácelo Set me por el dominio de la cuenta.

Implementación de la aplicación en el dispositivo Android

Encienda el dispositivo Android, inicie sesión y conéctelo al equipo mediante un cable USB.

Seleccione Run (Ejecutar) en la barra de herramientas de Android Studio.

Implementación y ejecución de Android Studio

Seleccione el dispositivo Android en el cuadro de diálogo Select Deployment Target (Seleccionar destino de implementación) y seleccione OK (Aceptar) para ejecutar la aplicación en el dispositivo Android.

Siga las instrucciones de la aplicación para colocar y recuperar un delimitador.

Detenga la aplicación, para lo que debe seleccionar Stop (Detener) en la barra de herramientas de Android Studio.

Stop (Detener) en Android Studio

Limpieza de recursos

En los pasos anteriores, creó recursos de Azure en un grupo de recursos. Si no cree que vaya a necesitar estos recursos en el futuro, puede eliminarlos mediante la eliminación del grupo de recursos.

En el menú de Azure Portal o la página Inicio, seleccione Grupos de recursos. En la página Grupos de recursos, seleccione myResourceGroup.

En la página myResourceGroup, asegúrese de que los recursos enumerados sean los que desea eliminar.

Seleccione Eliminar grupo de recursos, escriba myResourceGroup en el cuadro de texto para confirmar y, después, seleccione Eliminar.

Pasos siguientes

En este inicio rápido, ha creado una cuenta de Spatial Anchors. Después, ha configurado e implementado una aplicación para guardar y recuperar los anclajes espaciales. Para más información acerca de cómo mejorar la aplicación para que pueda compartir anclajes espaciales con otros dispositivos, diríjase al siguiente tutorial.

Tutorial: Uso compartido de Spatial Anchors entre dispositivos

Compartir a través de