Pacotes MRTK

O Mixed Reality Toolkit (MRTK) é uma coleção de pacotes que permitem o desenvolvimento de aplicações de realidade mista através da plataforma transversal Dersequiramento de hardware e plataformas de Realidade Mista.

O MRTK está disponível como pacotes de ativos (.unitypackage) e através do Gestor de Pacotes de Unidade.

Pacotes de ativos

O ativo MRTK (.unitypackage) pode ser descarregado a partir de GitHub.

Alguns dos benefícios da utilização de pacotes de ativos incluem:

  • Disponível para Unidade 2018.4 e mais recente
  • Fácil de fazer alterações ao MRTK
    • MrTK está na pasta Ativos

Alguns dos desafios são:

  • MrTK faz parte da pasta de Ativos do projeto, levando a
    • Projetos maiores
    • Tempos de compilação mais lentos
  • Sem gestão de dependência
    • Os clientes são obrigados a resolver as dependências dos pacotes manualmente
  • Processo de atualização manual
    • Múltiplos passos
    • Grandes (mais de 3000 ficheiros) atualizações de controlo de origem
    • Risco de perda de alterações feitas ao MRTK
  • Importar o pacote de exemplos normalmente significa, incluindo todos os exemplos

Os pacotes disponíveis são:

Estes pacotes são lançados e suportados pela Microsoft a partir do código fonte na sucursal mrtk_release na GitHub.

Pacote de fundação

A Mixed Reality Toolkit Foundation é o conjunto de código que permite à sua aplicação alavancar a funcionalidade comum através de Plataformas de Realidade Mista.

Pacote da Fundação MRTK da FundaçãoPakage

O pacote da Fundação MRTK contém o seguinte.

Pasta Componente Descrição
MRTK/Core Interface e definições de tipo, classes base, shader padrão.
MRTK/Core/Fornecedores Fornecedores de dados agnósticos da plataforma
Mãos Suporte de classe base e serviços para rastreio manual.
InputAnimation Suporte para registar o movimento da cabeça e os dados de rastreio da mão.
Insiculação Suporte para simulação in-editor de entrada de mãos e olhos.
ObjectMeshObserver Observador de consciência espacial usando um modelo 3D como dados.
UnidadeInput Dispositivos de entrada comuns (joystick, rato, etc.) implementada através da API de entrada da Unidade.
MRTK/Fornecedores Fornecedores de dados específicos da plataforma
LeapMotion Suporte para o controlador UltraLeap Leap Motion.
OpenVR Suporte para dispositivos OpenVR.
Oculus Suporte para dispositivos Oculus, como o Quest.
UnidadeAR (Experimental) O fornecedor de definições de câmara que permite a utilização do MRTK com dispositivos AR móveis.
WindowsMixedReality Suporte para dispositivos Windows Mixed Reality, incluindo Microsoft HoloLens e auscultadores imersivos.
Windows Suporte para APIs específicos Windows Microsoft, por exemplo, discurso e ditado.
XR SDK (Experimental) Apoio ao novo quadro XR da Unidade na Unidade 2019.3 e mais recente.
MRTK/SDK
Experimental Funcionalidades experimentais, incluindo shaders, controlos de interface de utilizador e gestores individuais de sistemas.
Funcionalidades Funcionalidade que se baseia no pacote da Fundação.
Perfis Perfis predefinidos para os sistemas e serviços do Microsoft Mixed Reality Toolkit.
StandardAssets Ativos comuns; modelos, texturas, materiais, etc.
MRTK/SceneSystemResources Ativos e recursos utilizados pelo Sistema de Cena
MRTK/Serviços
Sistema de Fronteiras Sistema implementando suporte de fronteira VR.
Sistema de Câmara Implementação de câmaras de implementação e gestão.
Sistema de Diagnóstico Implementação de sistemas em diagnósticos de aplicações, por exemplo um perfilador visual.
Sistema de Entrada Sistema que fornece suporte para aceder e manusear a entrada do utilizador.
Sistema de Cena Sistema que fornece suporte a aplicações multi-cena.
Sistema de Sensibilização Espacial Sistema que fornece suporte para a consciencialização do ambiente do utilizador.
TeleportSystem Sistema que fornece suporte para teletransporte (movendo-se sobre a experiência em saltos).
MRTK/StandardAssets MrTK Standard shader, materiais básicos e outros ativos padrão para experiências de realidade mista

Pacote de extensões

O pacote opcional Microsoft.MixedRealityToolkit.Unitário.Extensions inclui serviços adicionais que alargam a funcionalidade do Microsoft Mixed Reality Toolkit.

Nota

O pacote de extensões requer Microsoft.MixedRealityToolkit.Unity.Foundation.

Pasta Componente Descrição
MRTK/Extensões
Serviço de Fisicia Manual Serviço que adiciona suporte físico às mãos articuladas.
Serviço De Pista Perdida Serviço que simplifica o manuseamento da perda de rastreamento em dispositivos Microsoft HoloLens.
Serviço de Transporte de Cena Serviço que simplifica a adição de transições de cena suaves.

Pacote de ferramentas

O pacote opcional Microsoft.MixedRealityToolkit.Unity.Tools inclui ferramentas úteis que melhoram a experiência de desenvolvimento de realidade mista utilizando o Microsoft Mixed Reality Toolkit. Estas ferramentas estão localizadas no menu De Utilidades de Ferramentas de Realidade Mista no Editor de Unidade.

Nota

O pacote de ferramentas requer Microsoft.MixedRealityToolkit.Unity.Foundation.

Pasta Componente Descrição
MRTK/Ferramentas
BuildWindow Ferramenta que ajuda a simplificar o processo de construção e implementação de aplicações UWP.
DependênciaWindow Ferramenta que cria um gráfico de dependência de ativos num projeto.
ExtensãoServiceCreator Assistente para ajudar na criação de serviços de extensão.
MigrationWindow Ferramenta que ajuda na atualização do código que utiliza componentes MRTK precários.
OptimizeWindow Utilitário para ajudar a automatizar um projeto de realidade mista para o melhor desempenho em Unidade.
ReserializeAsse a Pensão Fornece suporte para reserializar ficheiros de unidade específicos.
RuntimeTois/Ferramentas/ControladorMappingTool Utilitário que permite aos desenvolvedores determinar rapidamente mapeamentos de Unidade para controladores de hardware.
ScreenshotUtility Permite capturar imagens de aplicações no editor da Unidade.
TextureCombinerWindow Utilitário para combinar texturas gráficas.
Caixa de ferramentas UI que facilita a descoberta e utilização de componentes MRTK UX.

Pacote de serviços públicos de teste

O pacote opcional Microsoft.MixedRealityToolkit.TestUtilities é uma coleção de scripts auxiliares que permitem aos desenvolvedores criar facilmente testes de modo de reprodução. Estes utilitários são especialmente úteis para desenvolvedores que criam componentes MRTK.

Pasta Componente Descrição
MRTK/Testes
Testutilidades Métodos para simplificar a criação de testes de modo de jogo, incluindo utilitários de simulação manual.

Pacote de exemplos

O pacote de exemplos contém demonstrações, scripts de amostra e cenas de amostra que exercitam a funcionalidade no pacote de fundação. Este pacote contém a cena HandInteractionExample (na imagem abaixo) que contém objetos de amostra que respondem a vários tipos de entrada manual (articulada e não articulada).

Cena de HandInteractionExample

Este pacote também contém demonstrações de rastreio ocular, que são documentados aqui

De um modo mais geral, qualquer nova funcionalidade no MRTK deve conter um exemplo correspondente no pacote de exemplos, seguindo aproximadamente a mesma estrutura e localização da mesma pasta.

Nota

O pacote de exemplos requer Microsoft.MixedRealityToolkit.Unity.Foundation.

Pasta Componente Descrição
MRTK/Exemplos
Demos Cenas simples que ilustram uma ou duas características relacionadas.
Experimental Cenas de demonstração ilustrando características experimentais.
StandardAssets Bens comuns partilhados por várias cenas de demonstração.

Gestor de Pacotes de unidade

Para experiências que estão a ser criadas com a Unidade 2019.4 e mais recentes, o MRTK está disponível através do Gestor de Pacotes de Unidade.

Alguns dos benefícios da utilização de pacotes de ativos incluem:

  • Projetos mais pequenos
    • Soluções de Visual Studio mais limpa
    • Menos ficheiros para fazer o check-in (MRTK é uma referência simples no Packages/manifest.json ficheiro)
  • Compilação mais rápida
    • Unidade não precisa de recompletar MRTK durante a construção
  • Resolução de dependência
    • Os pacotes MRTK necessários são automaticamente instalados ao especificar pacotes com dependências
  • Atualização fácil para as novas versões MRTK
    • Alterar a versão no Packages/manifest.json ficheiro

Alguns dos desafios são:

  • MRTK é imutável
    • Não é possível fazer alterações sem que sejam removidas durante a resolução do pacote
  • MRTK não suporta pacotes UPM com Unidade 2018.4

Pacote de fundação

O pacote de fundações com.microsoft.mixedreality.toolkit.foundation () forma a base do Conjunto de Ferramentas de Realidade Mista.

Pasta Componente Descrição
MRTK/Core Interface e definições de tipo, classes base, shader padrão.
MRTK/Core/Fornecedores Fornecedores de dados agnósticos da plataforma
Mãos Suporte de classe base e serviços para rastreio manual.
InputAnimation Suporte para registar o movimento da cabeça e os dados de rastreio da mão.
Insiculação Suporte para simulação in-editor de entrada de mãos e olhos.
ObjectMeshObserver Observador de consciência espacial usando um modelo 3D como dados.
UnidadeInput Dispositivos de entrada comuns (joystick, rato, etc.) implementada através da API de entrada da Unidade.
MRTK/Fornecedores Fornecedores de dados específicos da plataforma
LeapMotion Suporte para o controlador UltraLeap Leap Motion.
OpenVR Suporte para dispositivos OpenVR.
Oculus Suporte para dispositivos Oculus, como o Quest.
UnidadeAR (Experimental) O fornecedor de definições de câmara que permite a utilização do MRTK com dispositivos AR móveis.
WindowsMixedReality Suporte para dispositivos Windows Mixed Reality, incluindo Microsoft HoloLens e auscultadores imersivos.
Windows Suporte para APIs específicos Windows Microsoft, por exemplo, discurso e ditado.
XR SDK (Experimental) Apoio ao novo quadro XR da Unidade na Unidade 2019.3 e mais recente.
MRTK/SDK
Experimental Funcionalidades experimentais, incluindo shaders, controlos de interface de utilizador e gestores individuais de sistemas.
Funcionalidades Funcionalidade que se baseia no pacote da Fundação.
Perfis Perfis predefinidos para os sistemas e serviços do Microsoft Mixed Reality Toolkit.
StandardAssets Ativos comuns; modelos, texturas, materiais, etc.
MRTK/Serviços
Sistema de Fronteiras Sistema implementando suporte de fronteira VR.
Sistema de Câmara Implementação de câmaras de implementação e gestão.
Sistema de Diagnóstico Implementação de sistemas em diagnósticos de aplicações, por exemplo um perfilador visual.
Sistema de Entrada Sistema que fornece suporte para aceder e manusear a entrada do utilizador.
Sistema de Cena Sistema que fornece suporte a aplicações multi-cena.
Sistema de Sensibilização Espacial Sistema que fornece suporte para a consciencialização do ambiente do utilizador.
TeleportSystem Sistema que fornece suporte para teletransporte (movendo-se sobre a experiência em saltos).

Dependências:

  • Ativos Standard com.microsoft.mixedreality.toolkit.standardassets ()

Ativos Padrão

O pacote de ativos padrão com.microsoft.mixedreality.toolkit.standardassets) (é uma coleção de componentes que são recomendados para todas as experiências de realidade mista, incluindo:

  • Shader Padrão MRTK
  • Materiais básicos que utilizam o shader padrão MRTK
  • Ficheiros áudio
  • Fontes
  • Texturas
  • Ícones

Nota

Para evitar alterações com base nas definições de montagem, os scripts utilizados para controlar algumas características do shader padrão MRTK não estão incluídos no pacote de ativos padrão. Estes scripts podem ser encontrados no pacote de fundação na MRTK/Core/Utilities/StandardShader pasta.

Dependências: nenhuma

Pacotes de extensão

O pacote de extensões opcionais com.microsoft.mixedreality.toolkit.extensions) (contém componentes adicionais que expandem a funcionalidade do MRTK.

Pasta Componente Descrição
MRTK/Extensões
Serviço de Fisicia Manual Serviço que adiciona suporte físico às mãos articuladas.
Serviço De Pista Perdida Serviço que simplifica a entrega de perdas de rastreamento em dispositivos Microsoft HoloLens.
Serviço de Transporte de Cena Serviço que simplifica a adição de transições de cena suaves.
Amostras~ Uma pasta escondida (no Editor de Unidade) que contém as cenas e os ativos da amostra.

Mais detalhes sobre o processo de utilização de pacotes que contenham projetos de exemplo podem ser encontrados no artigo de Gestor de Pacotes de Ferramentas de Realidade Mista.

Dependências:

  • Fundação com.microsoft.mixedreality.toolkit.foundation ( )

Pacote de ferramentas

O pacote de ferramentas opcionais com.microsoft.mixedreality.toolkit.tools) (contém ferramentas que são úteis para criar experiências de realidade mista. Em geral, estas ferramentas são componentes editoriais e o seu código não é enviado como parte de uma aplicação.

Pasta Componente Descrição
MRTK/Ferramentas
BuildWindow Ferramenta que ajuda a simplificar o processo de construção e implementação de aplicações UWP.
DependênciaWindow Ferramenta que cria um gráfico de dependência de ativos num projeto.
ExtensãoServiceCreator Assistente para ajudar na criação de serviços de extensão.
MigrationWindow Ferramenta que ajuda na atualização do código que utiliza componentes MRTK precários.
OptimizeWindow Utilitário para ajudar a automatizar um projeto de realidade mista para o melhor desempenho em Unidade.
ReserializeAsse a Pensão Fornece suporte para reserializar ficheiros de unidade específicos.
RuntimeTois/Ferramentas/ControladorMappingTool Utilitário que permite aos desenvolvedores determinar rapidamente mapeamentos de Unidade para controladores de hardware.
ScreenshotUtility Permite capturar imagens de aplicações no editor da Unidade.
TextureCombinerWindow Utilitário para combinar texturas gráficas.
Caixa de ferramentas UI que facilita a descoberta e utilização de componentes MRTK UX.

Dependências:

  • Fundação com.microsoft.mixedreality.toolkit.foundation ( )

Pacote de serviços públicos de teste

O pacote opcional de utilitários de teste com.microsoft.mixedreality.toolkit.testutilities contém uma coleção de scripts auxiliares que permitem aos desenvolvedores criar facilmente testes de modo de reprodução. Estes utilitários são especialmente úteis para desenvolvedores que criam componentes MRTK.

Pasta Componente Descrição
MRTK/Testes
Testutilidades Métodos para simplificar a criação de testes de modo de jogo, incluindo utilitários de simulação manual.

Dependências:

  • Fundação com.microsoft.mixedreality.toolkit.foundation ( )

Pacote de exemplos

O pacote de exemplos com.microsoft.mixedreality.toolkit.examples (), é estruturado para permitir que os desenvolvedores importem apenas os exemplos de interesse.

Mais detalhes sobre o processo de utilização de pacotes que contenham projetos de exemplo podem ser encontrados no artigo de Gestor de Pacotes de Ferramentas de Realidade Mista.

Pasta Componente Descrição
MRTK/Exemplos
Amostras~ Uma pasta escondida (no Editor de Unidade) que contém as cenas e os ativos da amostra.
StandardAssets Bens comuns partilhados por várias cenas de demonstração.

Dependências:

  • Fundação com.microsoft.mixedreality.toolkit.foundation ( )
  • Extensões com.microsoft.mixedreality.toolkit.extensions ( )

Ver também