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:
É 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:
- 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.
- 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.
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++:
- Em Gerenciador de Soluções, clique com o botão direito do mouse no projeto que usará o OpenXR e selecione Gerenciar Pacotes NuGet....
- Alterne para a guia Procurar e pesquise OpenXR.Loader.
- Selecione o pacote OpenXR.Loader e selecione Instalar no painel de detalhes à direita.
- Selecione OK para aceitar as alterações em seu projeto.
- 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:
- Siga qualquer uma das abordagens acima para integrar um carregador OpenXR ao seu projeto.
- 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:
- 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.
- Instale o aplicativo OpenXR Tools for Windows Mixed Reality da Microsoft Store no dispositivo de destino e execute-o.
- 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.
- 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.
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.