Usar pacotes do MRTK3

O Microsoft MRTK3 é distribuído como um conjunto de pacotes que são importados para o Unity usando a ferramenta de recursos de realidade misturada para o Unity e o UPM (gerenciador de pacotes do Unity). Esses pacotes permitem que os desenvolvedores personalizem o MRTK em seus projetos.

Observação

Para a versão prévia privada do MRTK3, a Ferramenta de Recursos de Realidade Misturada não será usada. Para obter mais informações sobre como importar pacotes do MRTK, examine a Configuração inicial.

Dependências

Alguns pacotes do MRTK3 exigem pacotes adicionais, fornecidos pela Microsoft e/ou pelo Unity, para funcionar corretamente. Alguns desses pacotes são opcionais e habilitarão funcionalidades adicionais.

O diagrama a seguir ilustra a relação entre os pacotes do MRTK e algumas das dependências do Unity.

MRTK3 Package Graph

Observação

Ao importar pacotes por meio da Ferramenta de Recursos de Realidade Misturada, o gerenciamento de dependência é executado automaticamente.

A tabela a seguir descreve as dependências do pacote do kit de ferramentas de realidade misturada.

Nome de exibição Nome do pacote Descrição Obrigatório Opcional
Definições principais do MRTK com.microsoft.mrtk.core Definições, utilitários e componentes compartilhados.
  • com.unity.xr.interaction.toolkit
  • com.unity.xr.management
Acessibilidade do MRTK com.microsoft.mrtk.accessibility Definições, recursos e subsistema para criar experiências acessíveis de realidade misturada.
  • com.microsoft.mrtk.core
  • com.microsoft.mrtk.graphicstools.unity
  • com.unity.textmeshpro
Associação de dados e temas do MRTK com.microsoft.mrtk.data Suporte para associação de dados e temas de elementos de interface do usuário.
  • com.microsoft.mrtk.core
  • com.unity.nuget.newtonsoft-json
  • com.unity.textmeshpro
Diagnóstico do MRTK com.microsoft.mrtk.diagnostics Subsistemas e ferramentas de monitoramento de desempenho e diagnóstico.
  • com.microsoft.mrtk.core
  • com.unity.xr.management
Ambiente do MRTK com.microsoft.mrtk.environment Subsistemas e recursos ambientais, como reconhecimento espacial e limites.
  • com.microsoft.mrtk.core
  • com.unity.xr.management
Ativos estendidos do MRTK com.microsoft.mrtk.extendedassets Áudio, fonte, textura e outros ativos adicionais para uso em aplicativos.
  • com.microsoft.mrtk.standardassets
  • com.microsoft.mrtk.graphicstools.unity
Entrada do MRTK com.microsoft.mrtk.input Componentes de entrada, incluindo suporte para mãos articuladas, reconhecimento de fala offline e simulação de entrada no editor.
  • com.microsoft.mrtk.core
  • com.microsoft.mrtk.graphicstools.unity
  • com.unity.xr.interaction.toolkit
  • com.unity.inputsystem
  • com.unity.xr.management
  • com.unity.xr.openxr
  • com.unity.xr.arfoundation
Manipulação espacial do MRTK com.microsoft.mrtk.spatialmanipulation Componentes e utilitários de manipulação e posicionamento espacial, incluindo solucionadores.
  • com.microsoft.mrtk.core
  • com.microsoft.mrtk.uxcore
  • com.unity.inputsystem
  • com.unity.xr.interaction.toolkit
  • com.microsoft.mrtk.input
Ativos padrão do MRTK com.microsoft.mrtk.standardassets Ativos padrão, incluindo materiais e texturas, para uso por aplicativos.
  • com.microsoft.mrtk.graphicstools.unity
Componentes do MRTK UX com.microsoft.mrtk.uxcomponents Biblioteca de componentes do MRTK UX, contendo pré-fabricados, visuais, controles pré-fabricados e tudo para começar a criar interfaces de usuário 3D para realidade misturada.
  • com.microsoft.mrtk.uxcore
  • com.microsoft.mrtk.spatialmanipulation
  • com.microsoft.standardassets
  • com.microsoft.mrtk.data
Núcleo do MRTK UX com.microsoft.mrtk.uxcore Scripts principais de interação e visualização para criar componentes de interface de usuário da função de gerenciamento (MR).\n\nNote: isso deve ser consumido para criar bibliotecas de UX. Para criar interfaces de função de gerenciamento com uma biblioteca de componentes pré-existente, consulte com.microsoft.mrtk.uxcomponents.
  • com.microsoft.mrtk.core
  • com.microsoft.mrtk.graphicstools.unity
  • com.unity.inputsystem
  • com.unity.textmeshpro
  • com.unity.xr.interaction.toolkit
  • com.microsoft.mrtk.data
Fala do Windows do MRTK com.microsoft.mrtk.windowsspeech Implementação de subsistema de fala para APIs de fala nativa do Windows. Permite o uso do reconhecimento de fala nativa do Windows para disparar eventos e impulsionar interações do XRI.
  • com.microsoft.mrtk.core

Executar testes de pacote

Alguns pacotes do MRTK contêm testes usados para validar os componentes incluídos. Em alguns casos, esses testes exigem pacotes adicionais do MRTK não declarados como dependências.

Observação

Ao importar pacotes no Unity, os assemblies de teste não são compilados por padrão. Para habilitar a compilação de testes, use o elemento testables do arquivo manifest.json do projeto.

Para colocar uma sobrecarga mínima em aplicativos que importam o kit de ferramentas de realidade misturada, as dependências são afirmadas apenas para requisitos de runtime. A tabela a seguir descreve os pacotes adicionais necessários para habilitar a compilação e a execução dos conjuntos de teste incluídos.

Nome de exibição Nome do pacote Requisitos de teste
Definições principais do MRTK com.microsoft.mrtk.core
Acessibilidade do MRTK com.microsoft.mrtk.accessibility
Associação de dados e temas do MRTK com.microsoft.mrtk.data
Diagnóstico do MRTK com.microsoft.mrtk.diagnostics
Ambiente do MRTK com.microsoft.mrtk.environment
Ativos estendidos do MRTK com.microsoft.mrtk.extendedassets
Entrada do MRTK com.microsoft.mrtk.input
Manipulação espacial do MRTK com.microsoft.mrtk.spatialmanipulation
  • com.microsoft.mrtk.input
Ativos padrão do MRTK com.microsoft.mrtk.standardassets
Componentes do MRTK UX com.microsoft.mrtk.uxcomponents
  • com.microsoft.mrtk.input
Núcleo do MRTK UX com.microsoft.mrtk.uxcore
  • com.microsoft.mrtk.input
Fala do Windows do MRTK com.microsoft.mrtk.windowsspeech