Inicio rápido: Implementación de un ejemplo de WMR de C++ nativo en HoloLens

En este inicio rápido se explica cómo implementar y ejecutar la aplicación del tutorial de WMR (Windows Mixed Reality) de C++ nativo en HoloLens 2.

En este artículo de inicio rápido aprenderá lo siguiente:

Requisitos previos

Para obtener acceso al servicio Azure Remote Rendering, primero debe crear una cuenta.

Debe instalar el software siguiente:

• Windows SDK 10.0.18362.0 (descargar)
• La versión más reciente de Visual Studio 2019 (descargar)
• Las herramientas de Visual Studio para Mixed Reality. En concreto, las instalaciones de carga de trabajo siguientes son obligatorias:
  • Desarrollo para el escritorio con C++
  • Desarrollo de Plataforma universal de Windows (UWP)
• GIT (descargar)

Clonación del repositorio de ejemplos de enrutamiento de solicitud de aplicaciones

Como primer paso, clonamos el repositorio de Git, que hospeda los ejemplos globales de Azure Remote Rendering. Abra un símbolo del sistema (escriba cmd en el menú Inicio de Windows) y cambie a un directorio en el que desee almacenar el proyecto de ejemplo de ARR.

Ejecute los comandos siguientes:

mkdir ARR
cd ARR
git clone https://github.com/Azure/azure-remote-rendering

El último comando crea un subdirectorio en el directorio ARR que contiene los diversos proyectos de ejemplo para Azure Remote Rendering.

El tutorial de C++ en HoloLens puede encontrarse en el subdirectorio NativeCpp/HoloLens-Wmr.

Compilar el proyecto

Abra el archivo de solución HolographicApp.sln ubicado en el subdirectorio NativeCpp/HoloLens-Wmr con Visual Studio 2019.

Cambie la configuración de compilación a Depurar (o Liberar) y ARM64. Asegúrese también de que el modo del depurador está establecido en Dispositivo, en lugar de en Máquina remota:

Puesto que las credenciales de la cuenta están codificadas de forma rígida en el código fuente del tutorial, cámbielas por unas credenciales válidas. Para ello, abra el archivo HolographicAppMain.cpp dentro de Visual Studio y cambie la parte en la que se crea el cliente dentro del constructor de la clase HolographicAppMain:

// 2. Create Client
{
    // Users need to fill out the following with their account data and model
    RR::SessionConfiguration init;
    init.AccountId = "00000000-0000-0000-0000-000000000000";
    init.AccountKey = "<account key>";
    init.RemoteRenderingDomain = "westus2.mixedreality.azure.com"; // <change to the region that the rendering session should be created in>
    init.AccountDomain = "westus2.mixedreality.azure.com"; // <change to the region the account was created in>
    m_modelURI = "builtin://Engine";
    m_sessionOverride = ""; // If there is a valid session ID to re-use, put it here. Otherwise a new one is created
    m_client = RR::ApiHandle(RR::RemoteRenderingClient(init));
}

En concreto, cambie los valores siguientes:

• init.AccountId, init.AccountKey e init.AccountDomain para usar los datos de la cuenta. Consulte el párrafo sobre cómo recuperar información de una cuenta.
• Especifique dónde desea crear la sesión de representación remota; para ello, modifique la parte correspondiente a la región de la cadena init.RemoteRenderingDomain para otras regiones distintas a westus2, por ejemplo "westeurope.mixedreality.azure.com".
• Además, m_sessionOverride se puede cambiar a un identificador de sesión existente. Se pueden crear sesiones fuera de este ejemplo, por ejemplo, mediante el script de PowerShell o mediante la API REST de la sesión directamente. Se recomienda crear una sesión fuera del ejemplo cuando este deba ejecutarse varias veces. Si no se devuelve ninguna sesión, el ejemplo creará una en cada inicio, lo que puede tardar varios minutos.

Ya se puede compilar la aplicación.

Inicie la aplicación.

1. Conecte el dispositivo HoloLens con un cable USB al equipo.
2. Encienda HoloLens y espere hasta que aparezca el menú de inicio.
3. Inicie el depurador en Visual Studio (F5). La aplicación se implementará automáticamente en el dispositivo.

La aplicación de ejemplo debe iniciarse y debe aparecer un panel de texto que le informará del estado actual de la aplicación. El estado en el momento de inicio es iniciar una sesión nueva o conectarse a una sesión existente. Una vez completada la carga del modelo, el modelo de motor integrado aparece en la posición principal. Con forma de oclusión, el modelo del motor interactúa correctamente con el cubo giratorio que se representa localmente.

Si quiere volver a iniciar el ejemplo más tarde, también puede encontrarlo en el menú de inicio de HoloLens, pero tenga en cuenta que puede tener un identificador de sesión compilado.

Pasos siguientes

Este inicio rápido se basa en el resultado de un tutorial que explica cómo integrar todos los elementos relacionados con Remote Rendering en una de HoloLens Holographic estándar. Para saber cuáles son los pasos necesarios, siga este tutorial: