Introdução ao SDK do MRTK2 e XR

O SDK do XR é o novo pipeline XR do Unity no Unity 2019.3 e além. No Unity 2019, ele fornece uma alternativa ao pipeline XR existente. No Unity 2020, é o único pipeline XR no Unity.

Configurando o Unity para o pipeline do SDK do XR

Atualmente, o pipeline do SDK XR dá suporte a três plataformas: Windows Mixed Reality, Oculus e OpenXR. As seções abaixo abordarão as etapas necessárias para configurar o SDK do XR para cada plataforma.

Windows Mixed Reality

Entre no Gerenciador de Pacotes do Unity e instale o pacote do Plug-in Windows XR, que adiciona suporte para Windows Mixed Reality no SDK XR. Isso também reduzirá alguns pacotes de dependência.

  1. Verifique se todos os seguintes foram instalados com êxito:

    • Gerenciamento de plug-in XR
    • Plug-in XR Windows
    • Auxiliares de entrada herdados do XR
  2. Acesse Editar > Configurações do Projeto.

  3. Clique na guia Gerenciamento de Plug-in XR na janela Project Configurações.

  4. Vá para as configurações de Plataforma Universal do Windows e verifique se Windows Mixed Reality está marcada em Provedores de Plug-in.

  5. Verifique se a inicialização do XR na inicialização está marcada.

  6. (Obrigatório para comunicação remota de HoloLens no editor, caso contrário, opcional) Vá para as configurações autônomas e verifique se Windows Mixed Reality está marcada em Provedores de Plug-in. Verifique também se a inicialização do XR na Inicialização está marcada.

    XR Plugin management with Standalone tab selected

  7. (Opcional) Clique na guia Windows Mixed Reality no Gerenciamento de Plug-in XR e crie um perfil de configurações personalizadas para alterar os padrões. Se a lista de configurações já estiver lá, nenhum perfil precisará ser criado.

    XR Plugin management with Windows tab selected

Oculus

  1. Siga o guia como configurar o Oculus Quest no MRTK usando o guia de pipeline do SDK do XR até o final. O guia descreve as etapas necessárias para configurar o Unity e o MRTK para usar o pipeline do SDK do XR para o Oculus Quest.

OpenXR

Importante

O OpenXR no Unity só tem suporte no Unity 2020.2 e superior. Ele também dá suporte apenas a builds x64, ARM e ARM64.

  1. Siga a configuração de um novo projeto OpenXR com instruções mrtk para adicionar o plug-in OpenXR ao seu projeto. Verifique se o seguinte foi instalado com êxito:
    1. Gerenciamento de plug-in XR
    2. Plug-in OpenXR
    3. Plug-in OpenXR de Realidade Misturada
  2. Vá para Editar > Project Configurações.
  3. Clique na guia Gerenciamento de Plug-in XR na janela Project Configurações.
  4. Verifique se a inicialização do XR na inicialização está marcada.
  5. (Opcional) Se estiver direcionando HoloLens 2, verifique se você está na plataforma UWP e selecione Microsoft HoloLens Conjunto de Recursos

Plugin management OpenXR

Observação

Se você tiver um projeto pré-existente que esteja usando o MRTK do UPM, verifique se a linha a seguir está no arquivo link.xml localizado na pasta MixedRealityToolkit.Generated.

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

Observação

Para a versão inicial do MRTK e do OpenXR, apenas as HoloLens 2 mãos articuladas e controladores de movimento Windows Mixed Reality têm suporte nativo. O suporte para hardware adicional será adicionado nas próximas versões.

Configurando o MRTK para o pipeline do SDK do XR

Use qualquer um dos perfis padrão do MRTK, que são todos configurados em pipelines XR do Unity. Os anteriores "DefaultOpenXRConfigurationProfile" e "DefaultXRSDKConfigurationProfile" agora são rotulados obsoletos.

Se estiver usando o OpenXR, escolha "DefaultOpenXRConfigurationProfile" como o perfil ativo ou clone-o para fazer personalizações.

Se estiver usando outros runtimes XR na configuração de Gerenciamento de Plug-in XR, como Windows Mixed Reality ou Oculus, escolha "DefaultXRSDKConfigurationProfile" como o perfil ativo ou clone-o para fazer personalizações.

Esses perfis são configurados com os sistemas e provedores corretos, quando necessário. Consulte os documentos de perfis para obter mais informações sobre o perfil e o suporte de exemplo com o SDK do XR.

Para migrar um perfil existente para o SDK do XR, os seguintes serviços e provedores de dados devem ser atualizados.

Você poderá ver os novos provedores de dados na guia SDK do XR no Unity 2019 ou na exibição principal/somente no Unity 2020+, onde o XR herdado não existe.

The XR SDK tab

Câmera

Adicionar os seguintes provedores de dados

XR SDK camera settings

Entrada

Adicionar os seguintes provedores de dados

Plug-in OpenXR Plug-in XR Windows
OpenXRDeviceManager XRSDK.WindowsMixedReality.WindowsMixedRealityDeviceManager

OpenXR:

OpenXR input settings

Windows Mixed Reality:

XR SDK input settings

Limite

Adicionar os seguintes provedores de dados

Plug-in OpenXR Plug-in XR Windows
XRSDKBoundarySystem XRSDKBoundarySystem

XR SDK boundary settings

Conscientização espacial

Adicionar os seguintes provedores de dados

XR SDK spatial awareness settings

Mapeamentos do controlador

Se você estiver usando perfis de mapeamento de controlador personalizados, abra um deles e execute o item de menu Realidade Misturada Toolkit -> Utilitários -> Atualizar -> Perfis de Mapeamento do Controlador para garantir que os novos tipos de controlador do SDK XR sejam definidos.

Veja também