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

Acesse o Gerenciador de Pacotes do Unity e instale o pacote do Plug-in do Windows XR, que adiciona suporte para Windows Mixed Reality no SDK do 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 do Windows XR
    • Auxiliares de entrada herdados do XR
  2. Acesse Editar > Configurações do Projeto.

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

  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 do 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.

    Gerenciamento de plug-in XR com guia autônoma selecionada

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

    Gerenciamento do Plug-in XR com a guia Windows selecionada

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 > Configurações do Projeto.
  3. Clique na guia Gerenciamento de Plug-in do XR na janela Configurações do Projeto.
  4. Verifique se a inicialização do XR na inicialização está marcada.
  5. (Opcional) Se estiver direcionando o HoloLens 2, verifique se você está na plataforma UWP e selecione Microsoft HoloLens Conjunto de Recursos

OpenXR de gerenciamento de plug-in

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, somente as mãos articuladas do HoloLens 2 e os 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 estão todos configurados nos pipelines XR do Unity. Os anteriores "DefaultOpenXRConfigurationProfile" e "DefaultXRSDKConfigurationProfile" agora são rotulados como 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.

A guia SDK do XR

Câmera

Adicionar os provedores de dados a seguir

Configurações da câmera do SDK do XR

Entrada

Adicionar os provedores de dados a seguir

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

OpenXR:

Configurações de entrada do OpenXR

Windows Mixed Reality:

Configurações de entrada do SDK do XR

Limite

Adicionar os provedores de dados a seguir

Plug-in OpenXR Plug-in do Windows XR
XRSDKBoundarySystem XRSDKBoundarySystem

Configurações de limite do SDK do XR

Conscientização espacial

Adicionar os provedores de dados a seguir

Configurações de reconhecimento espacial do SDK XR

Mapeamentos do controlador

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

Confira também