Pacotes MRTK — MRTK2
O Mixed Reality Toolkit (MRTK) é uma coleção de pacotes que permitem o desenvolvimento de aplicativos de Realidade Mista multiplataforma, fornecendo suporte para hardware e plataformas de Realidade Mista.
O MRTK está disponível como pacotes de ativos (.unitypackage) e através do Unity Package Manager.
Pacotes de ativos
O ativo MRTK (.unitypackage) pode ser baixado do GitHub.
Alguns dos benefícios do uso de pacotes de ativos incluem:
- Disponível para Unity 2018.4 e versões mais recentes
- Fácil de fazer alterações no MRTK
- 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ência
- Os clientes são obrigados a resolver dependências de pacotes manualmente
- Processo de atualização manual
- Várias etapas
- Atualizações de controle do código-fonte grandes (3000+ arquivo)
- Risco de perda das 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 suportados pela Microsoft a partir do código-fonte no GitHub.
Pacote Foundation
O Mixed Reality Toolkit Foundation é o conjunto de código que permite que seu aplicativo aproveite a funcionalidade comum em plataformas de realidade mista.
Pacote Fundação MRTK
O pacote MRTK Foundation contém o seguinte.
| Pasta | Componente | Description |
|---|---|---|
| MRTK/Núcleo | Definições de interface e tipo, classes base, sombreador padrão. | |
| MRTK/Core/Fornecedores | Fornecedores de dados agnósticos da plataforma | |
| Mãos | Suporte de classe base e serviços para rastreamento de mãos. | |
| InputAnimation | Suporte para gravação de movimento da cabeça e dados de rastreamento de mãos. | |
| InputSimulation | Suporte para simulação no editor de entrada de mãos e olhos. | |
| ObjectMeshObserver | Observador de consciência espacial usando um modelo 3D como dados. | |
| UnityInput | Dispositivos de entrada comuns (joystick, mouse, etc.) implementados através da API de entrada do Unity. | |
| MRTK/Fornecedores | Fornecedores de dados específicos da plataforma | |
| LeapMotion [en] | Suporte para o controlador UltraLeap Leap Motion. | |
| OpenVR | Suporte para dispositivos OpenVR. | |
| Oculus | Suporte para dispositivos Oculus, como o Quest. | |
| UnityAR | (Experimental) Provedor de configurações da câmera que permite o uso do MRTK com dispositivos móveis de RA. | |
| WindowsMixedReality | Suporte para dispositivos Windows Mixed Reality, incluindo Microsoft HoloLens e auriculares imersivos. | |
| Windows | Suporte para APIs específicas do Microsoft Windows, por exemplo, fala e ditado. | |
| XR SDK | (Experimental) Suporte para a nova estrutura XR do Unity no Unity 2019.3 e mais recente. | |
| MRTK/SDK | ||
| Experimental | Recursos experimentais, incluindo sombreadores, controles de interface do usuário e gerenciadores de sistema individuais. | |
| Funcionalidades | Funcionalidade que se baseia no pacote Foundation. | |
| Perfis | Perfis padrão para os sistemas e serviços do Microsoft Mixed Reality Toolkit. | |
| StandardAssets | Bens comuns; modelos, texturas, materiais, etc. | |
| MRTK/SceneSystemRecursos | Ativos e recursos utilizados pelo Scene System | |
| MRTK/Serviços | ||
| BoundarySystem | Sistema de implementação de suporte de limite VR. | |
| Sistema de câmara | Sistema de implementação de configuração e gestão de câmaras. | |
| Sistema de Diagnóstico | Implementação de sistema em diagnósticos de aplicações, por exemplo um profiler visual. | |
| Sistema de Entrada | Sistema que fornece suporte para acessar e lidar com a entrada do usuário. | |
| Sistema de Cena | Sistema que fornece suporte a aplicativos em várias cenas. | |
| SpatialAwarenessSystem | Sistema de suporte para conscientização do ambiente do usuário. | |
| TeleportSystem | Sistema de suporte para teletransporte (movimentando-se sobre a experiência em saltos). | |
| MRTK/StandardAssets | Sombreador padrão MRTK, materiais básicos e outros ativos padrão para experiências de realidade mista |
Pacote de extensões
O pacote opcional Microsoft.MixedRealityToolkit.Unity.Extensions inclui serviços adicionais que estendem a funcionalidade do Microsoft Mixed Reality Toolkit.
Nota
O pacote de extensões requer Microsoft.MixedRealityToolkit.Unity.Foundation.
| Pasta | Componente | Description |
|---|---|---|
| MRTK/Extensões | ||
| HandPhysicsService | Serviço que acrescenta suporte físico às mãos articuladas. | |
| LostTrackingService | Serviço que simplifica o tratamento 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 mista usando o Microsoft Mixed Reality Toolkit. Essas ferramentas estão localizadas no menu Utilitários do Kit de Ferramentas de Realidade > Mista no Editor Unity.
Nota
O pacote de ferramentas requer Microsoft.MixedRealityToolkit.Unity.Foundation.
| Pasta | Componente | Description |
|---|---|---|
| MRTK/Ferramentas | ||
| BuildWindow | Ferramenta que ajuda a simplificar o processo de criação e implantação de aplicativos UWP. | |
| DependencyWindow | Ferramenta que cria um gráfico 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 MRTK preteridos. | |
| OptimizeWindow | Utilitário para ajudar a automatizar a configuração de um projeto de realidade mista para o melhor desempenho no Unity. | |
| ReserializeAssetsUtility | Fornece suporte para reserializar arquivos Unity específicos. | |
| RuntimeTools/Tools/ControllerMappingTool | Utilitário que permite aos desenvolvedores determinar rapidamente mapeamentos Unity para controladores de hardware. | |
| ScreenshotUtility | Permite capturar imagens de aplicativos no editor 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 MRTK UX. |
Pacote de utilitários 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. Esses utilitários são especialmente úteis para desenvolvedores que criam componentes MRTK.
| Pasta | Componente | Description |
|---|---|---|
| MRTK/Testes | ||
| TestUtilities | 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 exemplo e cenas de exemplo que exercem a funcionalidade no pacote básico. Este pacote contém a cena HandInteractionExample (imagem abaixo) que contém objetos de exemplo que respondem a vários tipos de entrada manual (articulada e não articulada).
Este pacote também contém demonstrações de rastreamento ocular, que estão documentadas aqui
Mais geralmente, qualquer novo recurso no MRTK deve conter um exemplo correspondente no pacote de exemplos, seguindo aproximadamente a mesma estrutura de pastas e local.
Nota
O pacote de exemplos requer Microsoft.MixedRealityToolkit.Unity.Foundation.
| Pasta | Componente | Description |
|---|---|---|
| MRTK/Exemplos | ||
| Demonstrações | Cenas simples que ilustram uma ou duas características relacionadas. | |
| Experimental | Cenas de demonstração ilustrando recursos experimentais. | |
| StandardAssets | Ativos comuns compartilhados por várias cenas de demonstração. |
Gerenciador de Pacotes Unity
Para experiências que estão sendo criadas usando o Unity 2019.4 e versões mais recentes, o MRTK está disponível através do Gerenciador de Pacotes Unity.
Alguns dos benefícios do uso de pacotes de ativos incluem:
- Projetos de menor dimensão
- Soluções mais limpas do Visual Studio
- Menos arquivos para check-in (MRTK é uma referência simples no
Packages/manifest.jsonarquivo)
- Compilação mais rápida
- O Unity não precisa recompilar o MRTK durante a construção
- Resolução de dependências
- 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.jsonficheiro
- 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 suporta pacotes UPM com o Unity 2018.4
Pacote Foundation
O pacote básico (com.microsoft.mixedreality.toolkit.foundation) forma a base do Mixed Reality Toolkit.
| Pasta | Componente | Description |
|---|---|---|
| MRTK/Núcleo | Definições de interface e tipo, classes base, sombreador padrão. | |
| MRTK/Core/Fornecedores | Fornecedores de dados agnósticos da plataforma | |
| Mãos | Suporte de classe base e serviços para rastreamento de mãos. | |
| InputAnimation | Suporte para gravação de movimento da cabeça e dados de rastreamento de mãos. | |
| InputSimulation | Suporte para simulação no editor de entrada de mãos e olhos. | |
| ObjectMeshObserver | Observador de consciência espacial usando um modelo 3D como dados. | |
| UnityInput | Dispositivos de entrada comuns (joystick, mouse, etc.) implementados através da API de entrada do Unity. | |
| MRTK/Fornecedores | Fornecedores de dados específicos da plataforma | |
| LeapMotion [en] | Suporte para o controlador UltraLeap Leap Motion. | |
| OpenVR | Suporte para dispositivos OpenVR. | |
| Oculus | Suporte para dispositivos Oculus, como o Quest. | |
| UnityAR | (Experimental) Provedor de configurações da câmera que permite o uso do MRTK com dispositivos móveis de RA. | |
| WindowsMixedReality | Suporte para dispositivos Windows Mixed Reality, incluindo Microsoft HoloLens e auriculares imersivos. | |
| Windows | Suporte para APIs específicas do Microsoft Windows, por exemplo, fala e ditado. | |
| XR SDK | (Experimental) Suporte para a nova estrutura XR do Unity no Unity 2019.3 e mais recente. | |
| MRTK/SDK | ||
| Experimental | Recursos experimentais, incluindo sombreadores, controles de interface do usuário e gerenciadores de sistema individuais. | |
| Funcionalidades | Funcionalidade que se baseia no pacote Foundation. | |
| Perfis | Perfis padrão para os sistemas e serviços do Microsoft Mixed Reality Toolkit. | |
| StandardAssets | Bens comuns; modelos, texturas, materiais, etc. | |
| MRTK/Serviços | ||
| BoundarySystem | Sistema de implementação de suporte de limite VR. | |
| Sistema de câmara | Sistema de implementação de configuração e gestão de câmaras. | |
| Sistema de Diagnóstico | Implementação de sistema em diagnósticos de aplicações, por exemplo um profiler visual. | |
| Sistema de Entrada | Sistema que fornece suporte para acessar e lidar com a entrada do usuário. | |
| Sistema de Cena | Sistema que fornece suporte a aplicativos em várias cenas. | |
| SpatialAwarenessSystem | Sistema de suporte para conscientização do ambiente do usuário. | |
| TeleportSystem | Sistema de suporte para teletransporte (movimentando-se 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 mista, incluindo:
- Sombreador padrão MRTK
- Materiais básicos usando o sombreador padrão MRTK
- Arquivos de áudio
- Tipos de letra
- Texturas
- Ícones
Nota
Para evitar alterações de quebra com base em definições de assembly, os scripts usados para controlar alguns recursos do sombreador MRTK Standard 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 opcionais (com.microsoft.mixedreality.toolkit.extensions) contém componentes adicionais que expandem a funcionalidade do MRTK.
| Pasta | Componente | Description |
|---|---|---|
| MRTK/Extensões | ||
| HandPhysicsService | Serviço que acrescenta suporte físico às mãos articuladas. | |
| LostTrackingService | Serviço que simplifica a entrega de 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 Unity) que contém as cenas e os recursos de exemplo. |
Mais detalhes sobre o processo de uso de pacotes contendo projetos de exemplo podem ser encontrados no artigo Mixed Reality Toolkit e Unity Package Manager .
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, essas ferramentas são componentes do editor e seu código não é fornecido como parte de um aplicativo.
| Pasta | Componente | Description |
|---|---|---|
| MRTK/Ferramentas | ||
| BuildWindow | Ferramenta que ajuda a simplificar o processo de criação e implantação de aplicativos UWP. | |
| DependencyWindow | Ferramenta que cria um gráfico 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 MRTK preteridos. | |
| OptimizeWindow | Utilitário para ajudar a automatizar a configuração de um projeto de realidade mista para o melhor desempenho no Unity. | |
| ReserializeAssetsUtility | Fornece suporte para reserializar arquivos Unity específicos. | |
| RuntimeTools/Tools/ControllerMappingTool | Utilitário que permite aos desenvolvedores determinar rapidamente mapeamentos Unity para controladores de hardware. | |
| ScreenshotUtility | Permite capturar imagens de aplicativos no editor 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 MRTK UX. |
Dependências:
- Fundação (
com.microsoft.mixedreality.toolkit.foundation)
Pacote de utilitários 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 que os desenvolvedores criem facilmente testes de modo de reprodução. Esses utilitários são especialmente úteis para desenvolvedores que criam componentes MRTK.
| Pasta | Componente | Description |
|---|---|---|
| MRTK/Testes | ||
| TestUtilities | 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 uso de pacotes contendo projetos de exemplo podem ser encontrados no artigo Mixed Reality Toolkit e Unity Package Manager .
| Pasta | Componente | Description |
|---|---|---|
| MRTK/Exemplos | ||
| Amostras~ | Uma pasta oculta (no Editor Unity) que contém as cenas e os recursos de exemplo. | |
| StandardAssets | Ativos comuns compartilhados por várias cenas de demonstração. |
Dependências:
- Fundação (
com.microsoft.mixedreality.toolkit.foundation) - Extensões (
com.microsoft.mixedreality.toolkit.extensions)