Inicio rápido: Creación de una aplicación HoloLens con Azure Spatial Anchors en C++/WinRT y DirectXQuickstart: Create a HoloLens app with Azure Spatial Anchors, in C++/WinRT and DirectX

En este inicio rápido, se describe cómo crear una aplicación HoloLens con Azure Spatial Anchors en C++/WinRT y DirectX.This quickstart covers how to create a HoloLens app using Azure Spatial Anchors in C++/WinRT and DirectX. 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 HoloLens que puede guardar y recuperar un delimitador espacial.When you're finished, you'll have a HoloLens 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 implementaciones y ejecuciones en un dispositivo HoloLensDeploy and run on a HoloLens 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 panel de navegación izquierdo de Azure Portal, seleccione Crear un recurso.In the left navigation pane in the Azure portal, select Create a resource.

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

Búsqueda de Spatial Anchors

Seleccione Spatial Anchors.Select Spatial Anchors. En el cuadro de diálogo, seleccione Crear.In the dialog box, select Create.

En el cuadro de diálogo Cuenta de Spatial Anchors:In the Spatial Anchors Account dialog box:

  • Escriba un nombre de recurso único con caracteres alfanuméricos normales.Enter a unique resource name, 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 seleccione Aceptar.Name it myResourceGroup and select OK. Un grupo de recursos es un contenedor lógico en el que se implementan y administran recursos de Azure como aplicaciones web, bases de datos y cuentas de almacenamiento.A resource group is a logical container into which Azure resources like 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.

    Creación de un recurso

Una vez creado el recurso, Azure Portal mostrará que se completó la implementación.After the resource is created, Azure Portal will show that your deployment is complete. Haga clic en Ir al recurso.Click Go to resource.

Implementación completada

A continuación, puede ver las propiedades del recurso.Then, you can view the resource properties. Copie el valor de Id. de cuenta en un editor de texto, ya que lo necesitará más adelante.Copy the resource's Account ID value into a text editor because you'll need it later.

Propiedades del recurso

En Configuración, seleccione Clave.Under Settings, select Key. Copie el valor de Clave principal en un editor de texto.Copy the Primary key value into a text editor. Este valor es Account Key.This value is the Account Key. Lo necesitará más adelante.You'll need it later.

Clave de cuenta

Apertura del proyecto de ejemploOpen the sample project

Ejecute el siguiente comando para clonar el repositorio de ejemplos:Clone the samples repository by running the following command:

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

Abra HoloLens\DirectX\SampleHoloLens.sln en Visual Studio.Open HoloLens\DirectX\SampleHoloLens.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 HoloLens\DirectX\SampleHoloLens\ViewController.cpp.Open HoloLens\DirectX\SampleHoloLens\ViewController.cpp.

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.

Implementación de la aplicación en el dispositivo HoloLensDeploy the app to your HoloLens

Cambiar Configuración de la solución a Versión, cambie Plataforma de la solución a x86 y seleccione Dispositivo en las opciones de destino de implementación.Change the Solution Configuration to Release, change Solution Platform to x86, and select Device from the deployment target options.

Si usa HoloLens 2, utilice ARM64 como Plataforma de soluciones, en lugar de x86.If using HoloLens 2, use ARM64 as the Solution Platform, instead of x86.

Configuración de Visual Studio

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

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

Siga las instrucciones de la aplicación para colocar y recuperar un delimitador.Follow the instructions in the app to place and recall an anchor.

En Visual Studio, seleccione Detener depuración o presione Mayús + F5 para detener la depuración.In Visual Studio, stop the app by either selecting Stop Debugging or pressing Shift + F5.

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 en la página de inicio, seleccione Grupos de recursos y, en la página Grupos de recursos, seleccione myResourceGroup.From the Azure portal menu or Home page, select Resource groups, and 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, escriba myResourceGroup en el cuadro de texto y seleccione Eliminar.Select Delete, type myResourceGroup in the text box, 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.