Compartilhar via


Introdução ao OpenXR

Faça o desenvolvimento com o OpenXR em um headset imersivo do HoloLens 2 ou do Windows Mixed Reality na área de trabalho. Se você não tiver acesso a um fone de ouvido, poderá usar o Emulador HoloLens 2 ou o Simulador de Windows Mixed Reality.

Introdução ao OpenXR para HoloLens 2

Para começar a desenvolver aplicativos OpenXR para HoloLens 2:

  1. Configure um dispositivo HoloLens 2 ou instale uma versão recente do emulador HoloLens 2.

É isso! O runtime da API do OpenXR é pré-instalado em dispositivos HoloLens 2 e você receberá atualizações automáticas por meio da Store.

Para garantir que você tenha o runtime do OpenXR mais recente com todas as extensões presentes, você pode iniciar o aplicativo store do dispositivo ou emulador do HoloLens. Abra o menu no canto superior direito do aplicativo da Loja, selecione Downloads e atualizações e escolha Obter atualizações.

Observação

Se você estiver usando o emulador, a imagem do emulador será redefinida sempre que você iniciá-la e, portanto, sua melhor aposta é apenas garantir que você tenha a versão mais recente do HoloLens 2 imagem do emulador.

Introdução ao OpenXR para headsets Windows Mixed Reality

Para começar a desenvolver aplicativos OpenXR para headsets de Windows Mixed Reality imersivos:

  1. Verifique se você está executando pelo menos a Atualização de outubro de 2020 do Windows 10 (20H2), que é a versão mínima do sistema operacional com suporte para Windows Mixed Reality usuários finais executem aplicativos OpenXR. Versões anteriores do Windows 10 ainda devem funcionar com o OpenXR, mas podem não ter desempenho ou qualidade ideais. Se você estiver em uma versão anterior do Windows 10, poderá atualizar usando o Assistente de Atualização do Windows 10.
  2. Configure um headset Windows Mixed Reality ou habilite o simulador de Windows Mixed Reality.

É isso! O Windows Mixed Reality runtime do OpenXR é instalado e ativado automaticamente para todos os usuários Windows Mixed Reality. A Microsoft Store mantém o runtime atualizado.

Se você estiver usando vários headsets VR em seu computador, tenha em mente que o runtime do OpenXR ativo pode ser alterado pelo software do sistema de outro fornecedor. Para reativar o Windows Mixed Reality OpenXR Runtime, no menu Iniciar, inicie "portal Realidade Misturada" e selecione "Corrigir" na parte superior da janela. Se esse botão estiver ausente, o runtime do OpenXR já estará ativo.

Obtendo as Ferramentas OpenXR para Windows Mixed Reality

Se estiver desenvolvendo aplicativos OpenXR para HoloLens 2 ou PC VR, talvez você ache útil esse aplicativo openxr tools for Windows Mixed Reality. Ele fornece uma demonstração de vários recursos do OpenXR e uma página do OpenXR Runtime que contém informações importantes sobre o runtime ativo e o headset atual.

Para localizar e instalar o aplicativo Ferramentas OpenXR, em seu HoloLens 2, acesse o aplicativo store e pesquise "OpenXR".

Ao usar o emulador HoloLens 2, a maneira mais fácil de instalar as Ferramentas OpenXR para Windows Mixed Reality é por meio do Portal de Dispositivos do Windows. No Portal, navegue até a página "OpenXR" e, em Recursos do Desenvolvedor, selecione o botão Instalar. Isso também funciona em dispositivos de HoloLens 2 físicos.

Aplicativo OpenXR Tools for Windows Mixed Reality

Explorando a API OpenXR e o aplicativo de exemplo

Certifique-se de instalar as ferramentas necessárias para o desenvolvimento do OpenXR, caso ainda não tenha feito isso.

O projeto BasicXrApp mostra um exemplo de OpenXR simples com arquivos de projeto win32 e UWP HoloLens 2 no Visual Studio. Como a solução contém um projeto UWP do HoloLens, você precisará da carga de trabalho de desenvolvimento Plataforma Universal do Windows instalada no Visual Studio para abri-la completamente.

Embora os arquivos de projeto Win32 e UWP sejam separados devido a diferenças no empacotamento e na implantação, o código do aplicativo dentro de cada projeto é quase exatamente o mesmo!

Para um tour pela API OpenXR, marcar este vídeo de 60 minutos do exemplo BasicXrApp no Visual Studio. O vídeo mostra como cada um dos principais componentes da API OpenXR pode ser usado em seu próprio mecanismo e também demonstra alguns dos aplicativos criados no OpenXR hoje:

Executando seu aplicativo OpenXR

Depois de criar um .EXE de área de trabalho Do OpenXR Win32, você pode usá-lo com um fone de ouvido VR em qualquer plataforma vr da área de trabalho que dê suporte ao OpenXR, qualquer que seja o tipo de fone de ouvido.

Depois de criar um pacote de aplicativo UWP do OpenXR, você pode implantar esse pacote em um dispositivo HoloLens 2 ou no Emulador HoloLens 2.

Usando o OpenXR em um projeto existente

Para começar a usar o OpenXR em um projeto existente, você incluirá o carregador OpenXR. O carregador descobre o runtime do OpenXR ativo no dispositivo e fornece acesso às principais funções e funções de extensão que ele implementa.

Você pode fazer referência ao pacote NuGet do OpenXR oficial do seu projeto do Visual Studio ou incluir a origem oficial do carregador OpenXR do repositório GitHub do Khronos. Qualquer uma das abordagens fornecerá acesso aos recursos principais do OpenXR 1.0, além de extensões e MSFT publicadas.KHREXT

Se você também estiver interessado em experimentar MSFT_preview extensões, poderá copiar em cabeçalhos OpenXR de visualização do repositório Realidade Misturada GitHub.

Referenciar o pacote NuGet do OpenXR oficial

O pacote NuGet OpenXR.Loader é a maneira mais fácil de referenciar um carregador OpenXR predefinido .DLL em sua solução C++ do Visual Studio. Isso lhe dará acesso aos recursos principais do OpenXR 1.0, além de extensões e publicadas KHREXTMSFT.

Para adicionar uma referência de pacote NuGet OpenXR.Loader à sua solução do Visual Studio C++:

  1. Em Gerenciador de Soluções, clique com o botão direito do mouse no projeto que usará o OpenXR e selecione Gerenciar Pacotes NuGet....
  2. Alterne para a guia Procurar e pesquise OpenXR.Loader.
  3. Selecione o pacote OpenXR.Loader e selecione Instalar no painel de detalhes à direita.
  4. Selecione OK para aceitar as alterações em seu projeto.
  5. Adicione #include <openxr/openxr.h> a um arquivo de origem para começar a usar a API OpenXR.

Para ver um exemplo da API OpenXR em ação, marcar o aplicativo de exemplo BasicXrApp.

Incluir a origem oficial do carregador OpenXR

Se você quiser criar o carregador por conta própria, por exemplo, para evitar o carregador extra .DLL, poderá efetuar pull das fontes oficiais do carregador Khronos OpenXR em seu projeto. Isso lhe dará acesso aos recursos principais do OpenXR 1.0, além de extensões e publicadas KHREXTMSFT.

Para começar aqui, siga as instruções no repositório Khronos OpenXR-SDK no GitHub. O projeto está configurado para compilar com o CMake – se você estiver usando o MSBuild, precisará copiar o código para seu próprio projeto.

Usando extensões de visualização

As MSFT_preview extensões listadas no roteiro de extensão são extensões de fornecedor experimentais que estão sendo visualizadas para coletar comentários. Essas extensões são apenas para dispositivos de desenvolvedor e serão removidas quando a extensão real for enviada.

Se você estiver interessado em experimentar as extensões disponíveis MSFT_preview , siga as seguintes etapas para atualizar seu projeto:

  1. Siga qualquer uma das abordagens acima para integrar um carregador OpenXR ao seu projeto.
  2. Substitua os cabeçalhos OpenXR padrão em seu projeto pelos cabeçalhos de visualização do repositório Realidade Misturada OpenXR no GitHub.

Para ativar o suporte à extensão de visualização em seu computador de HoloLens 2 ou desktop de destino:

  1. Para garantir que você tenha o runtime do OpenXR mais recente com todas as extensões presentes, inicie o aplicativo da Loja de dentro do dispositivo ou emulador de destino, abra o menu no canto superior direito, selecione Downloads e atualizações e escolha Obter atualizações.
  2. Instale o aplicativo OpenXR Tools for Windows Mixed Reality da Microsoft Store no dispositivo de destino e execute-o.
  3. Navegue até a guia Configurações e habilite Usar o runtime do OpenXR de versão prévia mais recente. Isso habilita o runtime de visualização em seu dispositivo, que tem extensões de visualização ativadas. Guia Ferramentas do OpenXR para Windows Mixed Reality aplicativo
  4. Confirme se a versão do Runtime mostrada na guia OpenXR Runtime das Ferramentas do OpenXR para Windows Mixed Reality corresponde à versão necessária das extensões de visualização que você planeja experimentar. Nesse caso, você deverá ver a extensão na lista Extensões . Depois que uma extensão estável estiver disponível, sua extensão de visualização será removida.
    Guia OpenXR Tools for Windows Mixed Reality app OpenXR Runtime

Consulte o repositório Realidade Misturada OpenXR para obter a documentação dessas extensões de visualização e exemplos de como usá-las.

Solução de problemas

Se você tiver problemas para começar a usar o desenvolvimento do OpenXR, marcar nossas dicas de solução de problemas.