Início Rápido: Implementar o exemplo WMR C++ nativo no HoloLens

  • Artigo

Este início rápido aborda como implementar e executar a aplicação de tutorial C++ Windows Mixed Reality (WMR) nativa num HoloLens 2.

Neste início rápido, irá aprender a:

  • Crie a aplicação de tutorial para o HoloLens.
  • Altere as credenciais do Azure Remote Rendering no código fonte.
  • Implemente e execute o exemplo no dispositivo.

Pré-requisitos

Para obter acesso ao serviço Remote Rendering, primeiro tem de criar uma conta.

O seguinte software tem de ser instalado:

Clonar o repositório de exemplos de Remote Rendering

Como primeiro passo, clone o repositório Git, que aloja os exemplos globais do Azure Remote Rendering. Escreva cmd no menu Iniciar do Windows para abrir uma janela da linha de comandos. Mude para um diretório onde pretende armazenar o projeto de exemplo do ARR.

Execute os seguintes comandos:

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

O último comando cria uma pasta na pasta ARR que contém os vários projetos de exemplo para o Azure Remote Rendering.

O tutorial C++ HoloLens pode ser encontrado na pasta NativeCpp/HoloLens-Wmr.

Compilar o projeto

Abra o ficheiro de solução HolographicApp.sln localizado na pasta NativeCpp/HoloLens-Wmr com o Visual Studio.

Mude a configuração de compilação para Depuração (ou Versão) e ARM64. Certifique-se de que o modo de depurador está definido como Dispositivo em vez de Máquina Remota:

Captura de ecrã a mostrar a área de configuração do Visual Studio com valores conforme descrito.

Uma vez que as credenciais da conta estão codificadas no código fonte do tutorial, altere-as para credenciais válidas. Abra o ficheiro HolographicAppMain.cpp no Visual Studio e altere a parte em que o cliente é criado no interior do construtor da classe 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));
}

Especificamente, altere os seguintes valores:

  • init.AccountId, init.AccountKeye init.AccountDomain para utilizar os dados da sua conta. Veja a secção sobre como obter as informações da conta.
  • Especifique onde criar a sessão de composição remota ao modificar a parte da região da init.RemoteRenderingDomain cadeia para outras regiões que não westus2, por exemplo "westeurope.mixedreality.azure.com".
  • Além disso, m_sessionOverride pode ser alterado para um ID de sessão existente. As sessões podem ser criadas fora deste exemplo. Para obter mais informações, veja RenderingSession.ps1 ou Utilizar diretamente a API REST de gestão de sessões .

É recomendado criar uma sessão fora do exemplo quando o exemplo deve ser executado várias vezes. Se não for transmitida nenhuma sessão, o exemplo cria uma sessão sobre cada arranque, o que pode demorar vários minutos.

Agora pode compilar a aplicação.

Iniciar a aplicação

  1. Ligue o HoloLens com um cabo USB ao seu computador.
  2. Ative o HoloLens e aguarde até que o menu Iniciar seja apresentado.
  3. Inicie o Depurador no Visual Studio (F5). Implementa automaticamente a aplicação no dispositivo.

A aplicação de exemplo é iniciada e é apresentado um painel de texto que o informa sobre o estado atual da aplicação. O estado no momento do arranque é iniciar uma nova sessão ou ligar a uma sessão existente. Após a conclusão do carregamento do modelo, o modelo de motor incorporado é apresentado na posição da cabeça. Em termos de oclusão, o modelo do motor interage corretamente com o cubo giratório composto localmente.

Se quiser iniciar o exemplo novamente mais tarde, também pode encontrá-lo no menu Iniciar do HoloLens. Pode ter um ID de sessão expirado compilado no mesmo.

Passos seguintes

Este início rápido baseia-se no resultado de um tutorial que explica como integrar todas as Remote Rendering peças relacionadas numa Aplicação Holográfica de stock. Para saber que passos são necessários, siga este tutorial:

Tutorial: Integrar Remote Rendering numa Aplicação Holográfica do HoloLens