Usando o plug-in OpenXR de realidade misturada para o UnityUsing the Mixed Reality OpenXR Plugin for Unity

A partir da versão 2020,2 do Unity, o pacote de plugin OpenXR de realidade misturada da Microsoft está disponível usando o UPM (Gerenciador de pacotes do Unity).Starting with Unity version 2020.2, Microsoft’s Mixed Reality OpenXR Plugin package is available using the Unity Package Manager (UPM).

Pré-requisitosPrerequisites

  • Unity 2020,2 ou posteriorUnity 2020.2 or later
  • Plug-in do Unity OpenXR 0.1.2 ou posteriorUnity OpenXR plugin 0.1.2 or later
  • Visual Studio 2019 ou posteriorVisual Studio 2019 or later
  • Instalar o suporte da plataforma UWP no Unity para aplicativos do HoloLens 2Install UWP platform support in Unity for HoloLens 2 apps

Observação

Se você estiver criando aplicativos VR no computador Windows, o plug-in OpenXR de realidade misturada não será necessariamente necessário.If you're building VR applications on Windows PC, the Mixed Reality OpenXR plugin is not necessarily required. No entanto, você desejará instalar o plug-in se estiver personalizando o mapeamento do controlador para controladores do HP reverbo G2 ou compilando aplicativos que funcionam em headsets de HoloLens 2 e VR.However, you'll want to install the plugin if you're customizing controller mapping for HP Reverb G2 controllers or building apps that work on both HoloLens 2 and VR headsets.

Instalando o plug-in OpenXR de realidade misturadaInstalling the Mixed Reality OpenXR plugin

Seu projeto precisa instalar o plug-in OpenXR e pacotes de Gerenciamento de plugin XR antes de usar o plug-in OpenXR da realidade mista.Your project needs to install the OpenXR Plugin and XR Plugin Management packages before using the Mixed Reality OpenXR Plugin. Se você já os instalou, ótimo!If you've already installed them, great! Caso contrário, a instalação do plug-in OpenXR de realidade misturada os instalará automaticamente como dependências:If not, installing the Mixed Reality OpenXR plugin will automatically install them as dependencies:

  1. No editor do Unity, navegue até Editar configurações do projeto > > Gerenciador de pacotesIn the Unity Editor, navigate to Edit > Project Settings > Package Manager

  2. Expanda a seção registros no escopo , insira as informações a seguir e selecione salvar:Expand the Scoped Registries section, enter the following information, and select Save:

  3. Em Configurações avançadas, selecione habilitar pacotes de visualizaçãoUnder Advanced Settings, select Enable Preview Packages

Captura de tela da janela do Gerenciador de pacotes do Unity aberta nas configurações do projeto

O Gerenciador de pacotes do Unity usa um arquivo de manifesto chamado manifest.jsno para determinar quais pacotes instalar e os registros dos quais eles podem ser instalados.The Unity Package Manager uses a manifest file named manifest.json to determine which packages to install and the registries they can be installed from.

Importante

O OpenXR ainda é experimental no Unity e esse processo pode mudar ao longo do tempo enquanto trabalhamos para otimizar a experiência do desenvolvedor.OpenXR is still experimental in Unity and this process may change over time as we work to optimize the developer experience.

Registrando a dependência da realidade misturadaRegistering the Mixed Reality dependency

Depois que o registro com escopo do Microsoft Mixed Reality tiver sido adicionado ao manifesto, o pacote OpenXR poderá ser especificado.Once the Microsoft Mixed Reality scoped registry has been added to the manifest, the OpenXR package can be specified.

Para adicionar o pacote OpenXR:To add the OpenXR package:

  1. Abra [projectRoot]/Packages/manifest.js em um editor de texto como Visual Studio CodeOpen [projectRoot]/Packages/manifest.json in a text editor like Visual Studio Code

    1. Para obter aqui, clique com o botão direito do mouse em pacotes no painel esquerdo da janela do projeto.To get here, right click on Packages in the left panel of the Project window. Em seguida, clique em Mostrar no Explorer.Then, click Show in Explorer. Captura de tela da listagem de pacotes na janela do projetoScreenshot of the packages listing in the Project window
  2. Modifique a seção dependências dos pacotes/manifest.jsno arquivo da seguinte maneira:Modify the dependencies section of the Packages/manifest.json file as follows:

    Importante

    Pode haver mais dependências no arquivo de manifesto do que mostrado aqui.There may be more dependencies in your manifest file than shown here. Não exclua nenhum deles, basta adicionar a dependência OpenXR à lista.Don't delete any of them, just add the OpenXR dependency to the list.

      "dependencies": {
        "com.microsoft.mixedreality.openxr": "0.1.2",
      }
    
  3. Salve o arquivo, volte para o editor do Unity e abra o Gerenciador de pacotes para confirmar se o plug-in está instalado:Save the file, switch back to the Unity Editor, and open the Package Manager to confirm the plugin is installed:

    Captura de tela do Gerenciador de pacotes do Unity aberta no editor do Unity com realidade misturada OpenXR plugin realçado

    Observação

    Se o pacote OpenXR for removido usando o Gerenciador de pacotes do Unity, você precisará adicioná-lo novamente usando as etapas descritas anteriormente.If the OpenXR package is removed using the Unity Package Manager, you'll have to re-add it using the previously described steps.

Configurando o gerenciamento de plugin XR para OpenXRConfiguring XR Plugin Management for OpenXR

Para definir OpenXR como o tempo de execução no Unity:To set OpenXR as the the runtime in Unity:

  1. No editor do Unity, navegue até editar > configurações do projetoIn the Unity Editor, navigate to Edit > Project Settings
  2. Na lista de configurações, selecione Gerenciamento de plugin XRIn the list of Settings, select XR Plugin Management
  3. Verifique as caixas inicializar XR nas inicializações e OpenXR (visualização)Check the Initialize XR on Startup and OpenXR (Preview) boxes
  4. Se estiver direcionando para o HoloLens 2, verifique se você está na plataforma UWP e selecione conjunto de recursos do Microsoft HoloLensIf targeting HoloLens 2, make sure you're on the UWP platform and select Microsoft HoloLens Feature Set

Captura de tela do painel configurações do projeto aberta no editor do Unity com o gerenciamento de plug-in do XR realçado

Importante

Se você vir um ícone de aviso vermelho ao lado do plug-in OpenXR (versão prévia), clique no ícone e selecione corrigir tudo antes de continuar.If you see a red warning icon next to OpenXR Plugin (Preview), click the icon and select Fix all before continuing. O editor do Unity pode precisar ser reiniciado para que as alterações entrem em vigor.The Unity Editor may need to restart itself for the changes to take effect.

Captura de tela da janela de validação do projeto OpenXR

Agora você está pronto para começar a desenvolver com o OpenXR no Unity!You're now ready to begin developing with OpenXR in Unity! Continue na próxima seção para aprender a usar os exemplos de OpenXR.Continue on to the next section to learn how to use the OpenXR samples.

OptimizationOptimization

Se você estiver desenvolvendo para o HoloLens 2, navegue até a realidade misturada> OpenXR > aplicar as configurações de projeto recomendadas para o HoloLens 2 para obter melhor desempenho do aplicativo.If you're developing for HoloLens 2, navigate to Mixed Reality> OpenXR > Apply recommended project settings for HoloLens 2 to get better app performance.

Captura de tela do item de menu da realidade misturada abrir com OpenXR selecionado

Experimente os bastidores de exemplo do UnityTry out the Unity sample scenes

Para utilizar um ou mais dos exemplos, instale o ARFoundation 4.0 + do Gerenciador de pacotes:To utilize one or more of the examples, install ARFoundation 4.0+ from the Package Manager:

Captura de tela do Gerenciador de pacotes do Unity aberta no editor do Unity com o AR Foundation realçado

Exemplos de HoloLens 2HoloLens 2 samples

  1. No editor do Unity, navegue até a janela > Gerenciador de pacotesIn the Unity Editor, navigate to Window > Package Manager
  2. Na lista de pacotes, selecione OpenXR de realidade misturada plug-inIn the list of packages, select Mixed Reality OpenXR Plugin
  3. Localize o exemplo na lista de exemplos e selecione importarLocate the sample in the Samples list and select Import

Captura de tela do Gerenciador de pacotes do Unity abrir no editor do Unity com realidade misturada OpenXR plugin selecionado e exemplos de importação do botão realçado

Observação

Quando um pacote é atualizado, o Unity fornece a opção de atualizar amostras importadas.When a package is updated, Unity provides the option to update imported samples. A atualização de um exemplo importado substituirá as alterações feitas no exemplo e nos ativos associados.Updating an imported sample will overwrite any changes that have been made to the sample and associated assets.

Usando o MRTK com suporte a OpenXRUsing MRTK with OpenXR support

O MRTK Unity dá suporte ao plug-in OpenXR da realidade mista começando pela versão 2.5.3.MRTK Unity supports the Mixed Reality OpenXR plugin starting with the 2.5.3 release. Os plug-ins MRTK podem ser instalados dos mesmos registros no escopo que você configurou ao instalar o plug-in OpenXR da realidade mista.MRTK plugins can be installed from the same scoped registries as you set up when installing the Mixed Reality OpenXR plugin. Você pode encontrar informações mais detalhadas na documentação do MRTK.You can find more detailed information in the MRTK documentation.

  1. Adicione os seguintes pacotes em seu [projectRoot]/Packages/manifest.jsno arquivo:Add following packages in your [projectRoot]/Packages/manifest.json file:
"dependencies": {
    "com.microsoft.mixedreality.toolkit.foundation": "2.5.3",
    "com.microsoft.mixedreality.toolkit.tools": "2.5.3",
    "com.microsoft.mixedreality.toolkit.examples": "2.5.3",
    …
}
  1. Vá para o script de componente do MixedReality Toolkit no Inspetor e alterne para o perfil DefaultOpenXRConfigurationProfile :Go to the MixedReality Toolkit component script in the Inspector and switch to the DefaultOpenXRConfigurationProfile profile:

Captura de tela de alternância da configuração MRTK no componente Mixed Reality Toolkit no Inspetor

Problemas conhecidosKnown issues

Ao usar o recurso de acompanhamento de mão, adicione a seguinte linha no arquivo assets/MixedRealityToolkit. Generated/link.xml :When using the Hand Tracking feature, add following line in the Assets/MixedRealityToolkit.Generated/link.xml file:

<assembly fullname = "Microsoft.MixedReality.Toolkit.Providers.OpenXR" preserve="all"/>

Próximas etapasNext steps

Agora que você tem o projeto configurado para OpenXR e tem acesso a exemplos, confira quais recursos têm suporte no momento em nosso plug-in OpenXR.Now that you have your project configured for OpenXR and have access to samples, check out what features are currently supported in our OpenXR plugin.

Tem comentários?Have Feedback?

O OpenXR ainda é experimental, portanto, agradecemos os comentários que você pode nos dar para ajudá-lo a melhorá-lo.OpenXR is still experimental, so we’d appreciate any feedback you can give us to help make it better. Você nos verá nos fóruns do Unity marcando sua postagem no fórum com o Microsoft + OpenXR e o HoloLens 2 ou a realidade mista do Windows.You'll find us on the Unity Forums by tagging your forum post with Microsoft + OpenXR and either HoloLens 2 or Windows Mixed Reality.

Confira tambémSee also