Compartilhar via


Introdução ao SDK do MRTK2 e XR

O SDK do XR é 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.

Configurando o Unity para o pipeline do SDK do XR

Atualmente, o pipeline do SDK do 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-inS 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 origem do XR na inicialização está marcada.

  6. (Necessá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 Inicializar XR na Inicialização está marcado.

    Gerenciamento de plug-in XR com a guia Autônoma selecionada

  7. (Opcional) Clique na guia Windows Mixed Reality em Gerenciamento de Plug-inS 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 plug-in XR com a guia Windows selecionada

Oculus

  1. Siga o guia Como configurar o Oculus Quest no MRTK usando o pipeline do SDK XR até o final. O guia descreve as etapas necessárias para configurar o Unity e o MRTK para usar o pipeline do SDK 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 as instruções Configurar um novo projeto OpenXR com 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-inS XR na janela Configurações do Projeto.

  4. Verifique se a origem 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 grupo de recursos".

  6. (Opcional) Se estiver direcionando a Solicitação 2, verifique se você está na plataforma Android e selecione "Acompanhamento manual" e "Suporte à Meta-Solicitação".

    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"/>

Configurando o MRTK para o pipeline do SDK do XR

Use qualquer um dos perfis padrão do MRTK, que são todos configurados nos pipelines XR do Unity. Os "DefaultOpenXRConfigurationProfile" e "DefaultXRSDKConfigurationProfile" anteriores 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 main/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 do 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 XR sejam definidos.

Confira também