Pacotes mrtk — MRTK2
Realidade Misturada Toolkit (MRTK) é uma coleção de pacotes que permitem o desenvolvimento de aplicativos Realidade Misturada multiplataforma fornecendo suporte para Realidade Misturada hardware e plataformas.
O MRTK está disponível como pacotes de ativos (.unitypackage) e por meio do Gerenciador de Pacotes do Unity.
Pacotes de ativos
O ativo do MRTK (.unitypackage) pode ser baixado do GitHub.
Alguns dos benefícios do uso de pacotes de ativos incluem:
- Disponível para o Unity 2018.4 e versões mais recentes
- Fácil de fazer alterações no MRTK
- O MRTK está na pasta Ativos
Alguns dos desafios são:
- O MRTK faz parte da pasta Ativos do projeto, levando a
- Projetos maiores
- Tempos de compilação mais lentos
- Sem gerenciamento de dependências
- Os clientes precisam resolve dependências de pacote manualmente
- Processo de atualização manual
- Várias etapas
- Atualizações de controle do código-fonte grandes (mais de 3000 arquivos)
- Risco de perda de alterações feitas no MRTK
- Importar o pacote de exemplos normalmente significa incluir todos os exemplos
Os pacotes disponíveis são:
Esses pacotes são lançados e compatíveis com a Microsoft do código-fonte no GitHub.
Pacote de base
O Realidade Misturada Toolkit Foundation é o conjunto de códigos que permite que seu aplicativo aproveite a funcionalidade comum entre plataformas Realidade Misturada.
MRTK Foundation PackageO pacote mrtk foundation contém o seguinte.
Pasta | Componente | Descrição |
---|---|---|
MRTK/Core | Definições de interface e tipo, classes base, sombreador padrão. | |
MRTK/Core/Providers | Provedores de dados independentes de plataforma | |
Mãos | Suporte de classe base e serviços para acompanhamento manual. | |
InputAnimation | Suporte para registrar a movimentação da cabeça e os dados de acompanhamento da mão. | |
InputSimulation | Suporte para simulação no editor de entrada de mão e olho. | |
ObjectMeshObserver | Observador de reconhecimento espacial usando um modelo 3D como os dados. | |
UnityInput | Dispositivos de entrada comuns (joystick, mouse etc.) implementados por meio da API de entrada do Unity. | |
MRTK/Provedores | Provedores de dados específicos da plataforma | |
LeapMotion | Suporte para o controlador de Movimento Bissexto UltraLeap. | |
OpenVR | Suporte para dispositivos OpenVR. | |
Oculus | Suporte para dispositivos Oculus, como o Quest. | |
UnityAR | (Experimental) Provedor de configurações de câmera habilitando o uso do MRTK com dispositivos AR móveis. | |
WindowsMixedReality | Suporte para dispositivos Windows Mixed Reality, incluindo headsets imersivos e Microsoft HoloLens. | |
Windows | Suporte para APIs específicas do Microsoft Windows, por exemplo, fala e ditado. | |
SDK do XR | (Experimental) Suporte para a nova estrutura XR do Unity no Unity 2019.3 e mais recente. | |
MRTK/SDK | ||
Habilitação | Recursos experimentais, incluindo sombreadores, controles de interface do usuário e gerenciadores de sistema individuais. | |
Recursos | Funcionalidade que se baseia no pacote Foundation. | |
Perfis | Perfis padrão para os sistemas e serviços do Microsoft Realidade Misturada Toolkit. | |
StandardAssets | Ativos comuns; modelos, texturas, materiais etc. | |
MRTK/SceneSystemResources | Ativos e recursos usados pelo Sistema de Cena | |
MRTK/Serviços | ||
BoundarySystem | Sistema que implementa o suporte ao limite de VR. | |
CameraSystem | Sistema que implementa a configuração e o gerenciamento da câmera. | |
DiagnosticsSystem | Implementação do sistema no aplicativo diagnóstico, por exemplo, um criador de perfil visual. | |
InputSystem | Sistema que fornece suporte para acessar e manipular a entrada do usuário. | |
SceneSystem | Sistema que fornece suporte a aplicativos de várias cenas. | |
SpatialAwarenessSystem | Sistema que fornece suporte para reconhecimento do ambiente do usuário. | |
TeleportSystem | Sistema que fornece suporte para teletransporte (movimentação sobre a experiência em saltos). | |
MRTK/StandardAssets | Sombreador padrão do MRTK, materiais básicos e outros ativos padrão para experiências de realidade misturada |
Pacote de extensões
O pacote opcional Microsoft.MixedRealityToolkit.Unity.Extensions inclui serviços adicionais que estendem a funcionalidade do Microsoft Realidade Misturada Toolkit.
Observação
O pacote de extensões requer Microsoft.MixedRealityToolkit.Unity.Foundation.
Pasta | Componente | Descrição |
---|---|---|
MRTK/Extensões | ||
HandPhysicsService | Serviço que adiciona suporte físico a mãos articuladas. | |
LostTrackingService | Serviço que simplifica a manipulação da perda de rastreamento em dispositivos Microsoft HoloLens. | |
SceneTransitionService | 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 aprimoram a experiência de desenvolvimento de realidade misturada usando o Microsoft Realidade Misturada Toolkit. Essas ferramentas estão localizadas no menu utilitários do kit de ferramentas > Realidade Misturada no Editor do Unity.
Observação
O pacote de ferramentas requer Microsoft.MixedRealityToolkit.Unity.Foundation.
Pasta | Componente | Descrição |
---|---|---|
MRTK/Ferramentas | ||
BuildWindow | Ferramenta que ajuda a simplificar o processo de criação e implantação de aplicativos UWP. | |
DependencyWindow | Ferramenta que cria uma grafo de dependência de ativos em um projeto. | |
ExtensionServiceCreator | Assistente para ajudar na criação de serviços de extensão. | |
MigrationWindow | Ferramenta que auxilia na atualização de código que usa componentes do MRTK preteridos. | |
OptimizeWindow | Utilitário para ajudar a automatizar a configuração de um projeto de realidade misturada para obter o melhor desempenho no Unity. | |
ReserializeAssetsUtility | Fornece suporte para reserializar arquivos específicos do Unity. | |
RuntimeTools/Tools/ControllerMappingTool | Utilitário que permite que os desenvolvedores determinem rapidamente os mapeamentos do Unity para controladores de hardware. | |
ScreenshotUtility | Habilita a captura de imagens de aplicativo no editor do Unity. | |
TextureCombinerWindow | Utilitário para combinar texturas gráficas. | |
Caixa de Ferramentas | Interface do usuário que facilita a descoberta e o uso de componentes de UX do MRTK. |
Pacote de utilitários de teste
O pacote opcional Microsoft.MixedRealityToolkit.TestUtilities é uma coleção de scripts auxiliares que permitem que os desenvolvedores criem testes de modo de reprodução facilmente. Esses utilitários são especialmente úteis para desenvolvedores que criam componentes do MRTK.
Pasta | Componente | Descrição |
---|---|---|
MRTK/Testes | ||
TestUtilities | Métodos para simplificar a criação de testes de modo de reprodução, incluindo utilitários de simulação manual. |
Pacote de exemplos
O pacote de exemplos contém demonstrações, scripts de exemplo e cenas de exemplo que exercem a funcionalidade no pacote de base. Esse pacote contém a cena HandInteractionExample (foto abaixo) que contém objetos de exemplo que respondem a vários tipos de entrada manual (articulados e não articulados).
Este pacote também contém demonstrações de acompanhamento ocular, que estão documentadas aqui
Em geral, qualquer novo recurso no MRTK deve conter um exemplo correspondente no pacote de exemplos, seguindo aproximadamente a mesma estrutura de pasta e local.
Observação
O pacote de exemplos requer Microsoft.MixedRealityToolkit.Unity.Foundation.
Pasta | Componente | Descrição |
---|---|---|
MRTK/Exemplos | ||
Demonstrações | Cenas simples ilustrando um ou dois recursos relacionados. | |
Habilitação | Cenas de demonstração ilustrando recursos experimentais. | |
StandardAssets | Ativos comuns compartilhados por várias cenas de demonstração. |
Gerenciador de Pacotes do Unity
Para experiências que estão sendo criadas usando o Unity 2019.4 e versões mais recentes, o MRTK está disponível por meio do Gerenciador de Pacotes do Unity.
Alguns dos benefícios do uso de pacotes de ativos incluem:
- Projetos menores
- Soluções mais limpas do Visual Studio
- Menos arquivos para marcar (MRTK é uma referência simples no
Packages/manifest.json
arquivo)
- Compilação mais rápida
- O Unity não precisa recompilar o MRTK durante a construção
- Resolução de dependência
- Os pacotes mrtk necessários são instalados automaticamente ao especificar pacotes com dependências
- Atualização fácil para novas versões do MRTK
- Alterar a versão no
Packages/manifest.json
arquivo
- Alterar a versão no
Alguns dos desafios são:
- MRTK é imutável
- Não é possível fazer alterações sem que elas sejam removidas durante a resolução do pacote
- O MRTK não dá suporte a pacotes UPM com o Unity 2018.4
Pacote de base
O pacote de base (com.microsoft.mixedreality.toolkit.foundation
) forma a base de Realidade Misturada Toolkit.
Pasta | Componente | Descrição |
---|---|---|
MRTK/Core | Definições de interface e tipo, classes base, sombreador padrão. | |
MRTK/Core/Providers | Provedores de dados independentes de plataforma | |
Mãos | Suporte de classe base e serviços para acompanhamento manual. | |
InputAnimation | Suporte para registrar dados de movimentação da cabeça e acompanhamento manual. | |
InputSimulation | Suporte para simulação no editor de entrada de mão e olho. | |
ObjectMeshObserver | Observador de reconhecimento espacial usando um modelo 3D como os dados. | |
UnityInput | Dispositivos de entrada comuns (joystick, mouse etc.) implementados por meio da API de entrada do Unity. | |
MRTK/Provedores | Provedores de dados específicos da plataforma | |
LeapMotion | Suporte para o controlador de Movimento Bissexto UltraLeap. | |
OpenVR | Suporte para dispositivos OpenVR. | |
Oculus | Suporte para dispositivos Oculus, como o Quest. | |
UnityAR | (Experimental) Provedor de configurações de câmera habilitando o uso do MRTK com dispositivos AR móveis. | |
WindowsMixedReality | Suporte para dispositivos Windows Mixed Reality, incluindo headsets imersivos e Microsoft HoloLens. | |
Windows | Suporte para APIs específicas do Microsoft Windows, por exemplo, fala e ditado. | |
SDK do XR | (Experimental) Suporte para a nova estrutura XR do Unity no Unity 2019.3 e mais recente. | |
MRTK/SDK | ||
Habilitação | Recursos experimentais, incluindo sombreadores, controles de interface do usuário e gerenciadores de sistema individuais. | |
Recursos | Funcionalidade que se baseia no pacote Foundation. | |
Perfis | Perfis padrão para os sistemas e serviços do Microsoft Realidade Misturada Toolkit. | |
StandardAssets | Ativos comuns; modelos, texturas, materiais etc. | |
MRTK/Serviços | ||
BoundarySystem | Sistema que implementa o suporte ao limite de VR. | |
CameraSystem | Sistema que implementa a configuração e o gerenciamento da câmera. | |
DiagnosticsSystem | Implementação do sistema no aplicativo diagnóstico, por exemplo, um criador de perfil visual. | |
InputSystem | Sistema que fornece suporte para acessar e manipular a entrada do usuário. | |
SceneSystem | Sistema que fornece suporte a aplicativos de várias cenas. | |
SpatialAwarenessSystem | Sistema que fornece suporte para reconhecimento do ambiente do usuário. | |
TeleportSystem | Sistema que fornece suporte para teletransporte (movimentação sobre a experiência em saltos). |
Dependências:
- Ativos Padrão (
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 misturada, incluindo:
- Sombreador padrão do MRTK
- Materiais básicos usando o sombreador Padrão do MRTK
- Arquivos de áudio
- Fontes
- Texturas
- Ícones
Observação
Para evitar alterações interruptivas com base em definições de assembly, os scripts usados para controlar alguns recursos do sombreador Padrão do MRTK não estão incluídos no pacote de ativos padrão. Esses scripts podem ser encontrados no pacote de base na MRTK/Core/Utilities/StandardShader
pasta .
Dependências: nenhuma
Pacotes de extensão
O pacote de extensões opcional (com.microsoft.mixedreality.toolkit.extensions)
contém componentes adicionais que expandem a funcionalidade do MRTK.
Pasta | Componente | Descrição |
---|---|---|
MRTK/Extensões | ||
HandPhysicsService | Serviço que adiciona suporte físico a mãos articuladas. | |
LostTrackingService | Serviço que simplifica a entrega da perda de rastreamento em dispositivos Microsoft HoloLens. | |
SceneTransitionService | Serviço que simplifica a adição de transições de cena suaves. | |
Amostras~ | Uma pasta oculta (no Editor do Unity) que contém as cenas e os ativos de exemplo. |
Mais detalhes sobre o processo de uso de pacotes que contêm projetos de exemplo podem ser encontrados no artigo kit de ferramentas Realidade Misturada e Gerenciador de Pacotes do Unity.
Dependências:
- Foundation (
com.microsoft.mixedreality.toolkit.foundation
)
Pacote de ferramentas
O pacote de ferramentas opcional (com.microsoft.mixedreality.toolkit.tools)
contém ferramentas que são úteis para criar experiências de realidade misturada. Em geral, essas ferramentas são componentes do editor e seu código não é fornecido como parte de um aplicativo.
Pasta | Componente | Descrição |
---|---|---|
MRTK/Ferramentas | ||
BuildWindow | Ferramenta que ajuda a simplificar o processo de criação e implantação de aplicativos UWP. | |
DependencyWindow | Ferramenta que cria uma grafo de dependência de ativos em um projeto. | |
ExtensionServiceCreator | Assistente para ajudar na criação de serviços de extensão. | |
MigrationWindow | Ferramenta que auxilia na atualização de código que usa componentes do MRTK preteridos. | |
OptimizeWindow | Utilitário para ajudar a automatizar a configuração de um projeto de realidade misturada para obter o melhor desempenho no Unity. | |
ReserializeAssetsUtility | Fornece suporte para reserializar arquivos específicos do Unity. | |
RuntimeTools/Tools/ControllerMappingTool | Utilitário que permite que os desenvolvedores determinem rapidamente os mapeamentos do Unity para controladores de hardware. | |
ScreenshotUtility | Habilita a captura de imagens de aplicativo no editor do Unity. | |
TextureCombinerWindow | Utilitário para combinar texturas gráficas. | |
Caixa de Ferramentas | Interface do usuário que facilita a descoberta e o uso de componentes de UX do MRTK. |
Dependências:
- Foundation (
com.microsoft.mixedreality.toolkit.foundation
)
Pacote de utilitários de teste
O pacote de utilitários de teste opcional (com.microsoft.mixedreality.toolkit.testutilities
) contém uma coleção de scripts auxiliares que permitem que os desenvolvedores criem facilmente testes de modo de reprodução. Esses utilitários são especialmente úteis para desenvolvedores que criam componentes do MRTK.
Pasta | Componente | Descrição |
---|---|---|
MRTK/Testes | ||
TestUtilities | Métodos para simplificar a criação de testes de modo de reprodução, incluindo utilitários de simulação manual. |
Dependências:
- Foundation (
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 uso de pacotes que contêm projetos de exemplo podem ser encontrados no artigo kit de ferramentas Realidade Misturada e Gerenciador de Pacotes do Unity.
Pasta | Componente | Descrição |
---|---|---|
MRTK/Exemplos | ||
Amostras~ | Uma pasta oculta (no Editor do Unity) que contém as cenas e os ativos de exemplo. | |
StandardAssets | Ativos comuns compartilhados por várias cenas de demonstração. |
Dependências:
- Foundation (
com.microsoft.mixedreality.toolkit.foundation
) - Extensões (
com.microsoft.mixedreality.toolkit.extensions
)