Introdução ao SDK do MRTK e do XR

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

Pré-requisitos

para começar com a realidade misturada Toolkit, siga as etapas fornecidas para adicionar o MRTK a um projeto.

Configurando o Unity para o pipeline do SDK do XR

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

Windows Mixed Reality

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

  1. Verifique se todos os itens a seguir foram instalados com êxito:

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

  3. clique na guia gerenciamento de Plug-ins do XR na janela Project Configurações.

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

  5. Verifique se inicializar XR na inicialização está marcado.

  6. (necessário para comunicação remota HoloLens no editor, caso contrário, opcional) vá para as configurações autônomas e verifique se Windows Mixed Reality está marcado em provedores de Plug-in. Verifique também se inicializar XR na inicialização está marcado.

    Gerenciamento de plugin XR com guia autônoma selecionada

  7. (Opcional) clique na guia Windows Mixed Reality em gerenciamento de Plug-in de 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.

    gerenciamento de Plugin XR com guia Windows selecionada

Oculus

  1. Siga a guia como configurar o Oculus Quest no MRTK usando o pipeline do XR SDK para 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 compilações de x64, ARM e ARM64.

  1. Siga o guia usando o plug-in Mixed Reality OpenXR plugin for Unity , incluindo as etapas para configurar a otimização e o gerenciamento de plug-in do XR para instalar o plug-in do OpenXR em seu projeto. Verifique se os itens a seguir foram instalados com êxito:
    1. Gerenciamento de plugin 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-ins do XR na janela Project Configurações.
  4. Verifique se inicializar XR na inicialização está marcado.
  5. (Opcional) se estiver direcionando HoloLens 2, verifique se você está na plataforma UWP e selecione Microsoft HoloLens conjunto de recursos

OpenXR de gerenciamento de plugin

Observação

Se você tiver um projeto pré-existente que esteja usando 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 os HoloLens 2 hands e os controladores de movimento de Windows Mixed Reality são suportados nativamente. O suporte para hardware adicional será adicionado em versões futuras.

Configurando o MRTK para o pipeline do SDK do XR

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

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

se estiver usando outros tempos de execução do xr na configuração de gerenciamento de Plug-in do 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 suporte a perfis e amostras com o XR SDK.

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

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

A guia do SDK do XR

Câmera

Adicionar os seguintes provedores de dados

Configurações da câmera do XR SDK

Entrada

Adicionar os seguintes provedores de dados

Plug-in OpenXR Windows Plug-in 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 seguintes provedores de dados

Plug-in OpenXR Windows Plug-in XR
XRSDKBoundarySystem XRSDKBoundarySystem

Configurações de limite do SDK do XR

Conscientização espacial

Adicionar os seguintes provedores de dados

Configurações de reconhecimento espacial do SDK do XR

Mapeamentos de controlador

se você estiver usando perfis de mapeamento de controlador personalizado, abra um deles e execute o item de menu Toolkit da realidade misturada-> utilitários-> Update-> controller mappings para garantir que os novos tipos de controlador SDK do XR sejam definidos.

Confira também