Inicio rápido: Creación de una aplicación para Android en Xamarin con Azure Spatial AnchorsQuickstart: Create a Xamarin Android app with Azure Spatial Anchors

En este inicio rápido se describe cómo crear una aplicación para Android con Xamarin mediante Azure Spatial Anchors.This quickstart covers how to create an Android app with Xamarin using Azure Spatial Anchors. 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.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. Cuando haya terminado, tendrá una aplicación para Android que puede guardar y recuperar un anclaje espacial.When you're finished, you'll have an Android app that can save and recall a spatial anchor.

Aprenderá a:You'll learn how to:

  • Crear una cuenta de Spatial AnchorsCreate a Spatial Anchors account
  • Configurar la clave y el identificador de la cuenta de Spatial AnchorsConfigure the Spatial Anchors account identifier and account key
  • Realizar la implementación y ejecución en un dispositivo AndroidDeploy and run on an Android device

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.If you don't have an Azure subscription, create a free account before you begin.

Requisitos previosPrerequisites

Para completar esta guía de inicio rápido, asegúrese de que dispone de lo siguiente:To complete this quickstart, make sure you have:

Creación de un recurso de Spatial AnchorsCreate a Spatial Anchors resource

Vaya a Azure Portal.Go to the Azure portal.

En el menú izquierdo, seleccione Crear un recurso.On the left pane, select Create a resource.

Use el cuadro de búsqueda para buscar Spatial Anchors.Use the search box to search for Spatial Anchors.

Captura de pantalla que muestra los resultados de una búsqueda de Spatial Anchors.

Seleccione Spatial Anchors y, después, seleccione Crear.Select Spatial Anchors, and then select Create.

En el panel Cuenta de Spatial Anchors, haga lo siguiente:On the Spatial Anchors Account pane, do the following:

  • Escriba un nombre de recurso único con caracteres alfanuméricos normales.Enter a unique resource name by using regular alphanumeric characters.

  • Seleccione la suscripción a la que desea asociar el recurso.Select the subscription that you want to attach the resource to.

  • Cree un grupo de recursos, para lo que debe seleccionar Crear nuevo.Create a resource group by selecting Create new. Asígnele el nombre myResourceGroup y luego seleccione Aceptar.Name it myResourceGroup, and then select OK.

    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.A resource group is a logical container into which Azure resources, such as web apps, databases, and storage accounts, are deployed and managed. Por ejemplo, más adelante puede elegir eliminar todo el grupo de recursos en un solo paso.For example, you can choose to delete the entire resource group in one simple step later.

  • Seleccione la ubicación (región) en la que desea colocar el recurso.Select a location (region) in which to place the resource.

  • Seleccione New (Nuevo) para empezar a crear el recurso.Select New to begin creating the resource.

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.After the resource is created, the Azure portal shows that your deployment is complete.

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

Haga clic en Go to resource (Ir al recurso).Select Go to resource. Ahora puede ver las propiedades del recurso.You can now view the resource properties.

Copie el valor de Id. de cuenta del recurso en un editor de texto para usarlo más adelante.Copy the resource's Account ID value into a text editor for later use.

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.Also copy the resource's Account Domain value into a text editor for later use.

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

En Configuración, seleccione Clave.Under Settings, select Key. Copie el valor de Clave principal, Clave de cuenta, en un editor de texto para su uso posterior.Copy the Primary key value, Account Key, into a text editor for later use.

Captura de pantalla del panel de claves de la cuenta.

Apertura del proyecto de ejemploOpen the sample project

Ejecute los siguientes comandos para clonar el repositorio de ejemplos: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

Abra Xamarin/SampleXamarin.sln en Visual Studio.Open Xamarin/SampleXamarin.sln in Visual Studio.

Configuración del identificador y la clave de la cuentaConfigure account identifier and key

El paso siguiente es configurar la aplicación para usar el identificador de cuenta y la clave de cuenta.The next step is to configure the app to use your account identifier and account key. Los copió en un editor cuando configuró el recurso de Spatial Anchors.You copied them into a text editor when setting up the Spatial Anchors resource.

Abra Xamarin/SampleXamarin.Common/AccountDetails.cs.Open Xamarin/SampleXamarin.Common/AccountDetails.cs.

Busque el campo SpatialAnchorsAccountKey y reemplace Set me por la clave de la cuenta.Locate the SpatialAnchorsAccountKey field and replace Set me with the account key.

Busque el campo SpatialAnchorsAccountId y reemplace Set me por el identificador de la cuenta.Locate the SpatialAnchorsAccountId field and replace Set me with the account identifier.

Busque el SpatialAnchorsAccountDomain campo y reemplácelo Set me por el dominio de la cuenta.Locate the SpatialAnchorsAccountDomain field and replace Set me with the account domain.

Implementación de la aplicación en el dispositivo AndroidDeploy the app to your Android device

Encienda el dispositivo Android, inicie sesión y conéctelo al equipo mediante un cable USB.Power on the Android device, sign in, and connect it to the computer using a USB cable.

Establezca el proyecto de inicio en SampleXamarin.Android, cambie el valor de Configuración de solución a Versión y seleccione el dispositivo en el que quiere realizar la implementación en el menú desplegable del selector de dispositivos.Set the startup project to SampleXamarin.Android, change the Solution Configuration to Release, and select the device you want to deploy to in the device selector drop-down.

Captura de pantalla que muestra el menú para seleccionar el proyecto y dispositivo en Windows.

Seleccione Depurar > Iniciar depuración para implementar e iniciar la aplicación.Select Debug > Start debugging to deploy and start your app.

En la aplicación, seleccione Básico para ejecutar la demostración y siga las instrucciones para colocar y recuperar un delimitador.In the app, select Basic to run the demo and follow the instructions to place and recall an anchor.

Captura de pantalla 1 Captura de pantalla 2 Captura de pantalla 3Screenshot 1 Screenshot 2 Screenshot 3

Limpieza de recursosClean up resources

En los pasos anteriores, creó recursos de Azure en un grupo de recursos.In the preceding steps, you created Azure resources in a resource group. Si no cree que vaya a necesitar estos recursos en el futuro, puede eliminarlos mediante la eliminación del grupo de recursos.If you don't expect to need these resources in the future, you can delete them by deleting the resource group.

En el menú de Azure Portal o la página Inicio, seleccione Grupos de recursos.From the Azure portal menu or Home page, select Resource groups. En la página Grupos de recursos, seleccione myResourceGroup.Then, on the Resource groups page, select myResourceGroup.

En la página myResourceGroup, asegúrese de que los recursos enumerados sean los que desea eliminar.On the myResourceGroup page, make sure that the listed resources are the ones you want to delete.

Seleccione Eliminar grupo de recursos, escriba myResourceGroup en el cuadro de texto para confirmar y, después, seleccione Eliminar.Select Delete resource group, type myResourceGroup in the text box to confirm, and then select Delete.

Pasos siguientesNext steps

En este inicio rápido, ha creado una cuenta de Spatial Anchors.In this quickstart, you created a Spatial Anchors account. Después, ha configurado e implementado una aplicación para guardar y recuperar los anclajes espaciales.You then configured and deployed an app to save and recall spatial anchors. 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.To learn more about how to improve the app so it can share spatial anchors with other devices, continue to the next tutorial.