Pacotes do MRTK — MRTK2
O MRTK (Realidade Misturada) é uma coleção de pacotes que permitem o desenvolvimento de aplicativos de Realidade Misturada multiplataforma, fornecendo suporte para hardware e plataformas de Realidade Misturada.
O MRTK está disponível como pacotes de ativos (.unitypackage) e por meio do Gerenciador de Pacotes do Unity.
Pacotes de ativo
O ativo MRTK (.unitypackage) pode ser baixado do GitHub.
Alguns dos benefícios de usar pacotes de ativos incluem:
- Disponível para 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ência
- Os clientes são obrigados a resolver as dependências do pacote manualmente
- Processo de atualização manual
- Várias etapas
- Atualizações de controle do código-fonte grandes (3000+ arquivos)
- 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 de fundação
O Mixed Reality Toolkit Foundation é o conjunto de código que permite que seu aplicativo aproveite a funcionalidade comum em plataformas de realidade misturada.
Pacote de Fundação MRTK
O pacote MRTK Foundation contém o seguinte.
| Pasta | Componente | Descrição |
|---|---|---|
| MRTK/Núcleo | Definições de interface e tipo, classes base, sombreador padrão. | |
| MRTK/Core/Provedores | Provedores de dados independentes de plataforma | |
| Mãos | Suporte de classe base e serviços para rastreamento de mãos. | |
| Animação de entrada | Suporte para gravação de dados de movimento da cabeça e rastreamento manual. | |
| Simulação de entrada | Suporte para simulação no editor de entrada de mão e olho. | |
| ObjectMeshObserver | Observador de consciência espacial usando um modelo 3D como dados. | |
| Entrada de unidade | 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 | |
| Movimento de salto | 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 de câmera que habilita o uso do MRTK com dispositivos AR móveis. | |
| WindowsRealidade Misturada | Suporte para dispositivos Windows Mixed Reality, incluindo Microsoft HoloLens e headsets imersivos. | |
| 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 shaders, 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 | Bens comuns; modelos, texturas, materiais, etc. | |
| MRTK/SceneSystemResources | Recursos e recursos usados pelo Sistema de Cena | |
| MRTK/Serviços | ||
| Sistema de Limites | Sistema que implementa suporte de limite VR. | |
| Sistema de câmera | Sistema implementando configuração e gerenciamento de câmeras. | |
| Sistema de diagnóstico | Implementação de sistema em diagnósticos de aplicativos, por exemplo, um criador de perfil visual. | |
| Sistema de entrada | Sistema que fornece suporte para acessar e manipular a entrada do usuário. | |
| Sistema de Cena | Sistema que fornece suporte a aplicativos de várias cenas. | |
| Sistema de Consciência Espacial | Sistema que fornece suporte para conscientização do ambiente do usuário. | |
| Sistema de Teletransporte | Sistema que fornece suporte para teletransporte (movendo-se sobre a experiência em saltos). | |
| MRTK/Ativos Padrão | 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 Mixed Reality Toolkit.
Observação
O pacote de extensões requer Microsoft.MixedRealityToolkit.Unity.Foundation.
| Pasta | Componente | Descrição |
|---|---|---|
| MRTK/Extensões | ||
| Serviço de Física Manual | Serviço que adiciona suporte físico às mãos articuladas. | |
| Serviço de rastreamento perdido | Serviço que simplifica o tratamento da perda de rastreamento em dispositivos Microsoft HoloLens. | |
| Serviço de transição 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 aprimoram a experiência de desenvolvimento de realidade misturada usando o Microsoft Mixed Reality Toolkit. Essas ferramentas estão localizadas no menu Realidade Misturada Toolkit > Utilities 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. | |
| Janela de dependência | Ferramenta que cria um gráfico de dependência de ativos em um projeto. | |
| ExtensionServiceCreator | Assistente para auxiliar na criação de serviços de extensão. | |
| Janela de migração | Ferramenta que auxilia na atualização do código que usa componentes preteridos do MRTK. | |
| 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 serialização de arquivos específicos do Unity. | |
| RuntimeTools/Tools/ControllerMappingTool | Utilitário que permite que os desenvolvedores determinem rapidamente mapeamentos do Unity para controladores de hardware. | |
| Utilitário de captura de tela | Permite a captura de imagens de aplicativos no editor do Unity. | |
| Janela Combinadora de Textura | Utilitário para combinar texturas gráficas. | |
| Caixa de Ferramentas | Interface do usuário que facilita a descoberta e o uso de componentes de experiência do usuário 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 facilmente testes de modo de reprodução. Esses utilitários são especialmente úteis para desenvolvedores que criam componentes MRTK.
| Pasta | Componente | Descrição |
|---|---|---|
| MRTK/Testes | ||
| Utilitários de teste | Métodos para simplificar a criação de testes de modo de jogo, incluindo utilitários de simulação de mãos. |
Pacote de exemplos
O pacote de exemplos contém demonstrações, scripts de exemplo e cenas de exemplo que exercitam a funcionalidade no pacote básico. Este pacote contém a cena HandInteractionExample (ilustrada 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
De forma mais geral, qualquer novo recurso no MRTK deve conter um exemplo correspondente no pacote de exemplos, seguindo aproximadamente a mesma estrutura de pastas e local.
Observação
O pacote de exemplos requer Microsoft.MixedRealityToolkit.Unity.Foundation.
| Pasta | Componente | Descrição |
|---|---|---|
| MRTK/Exemplos | ||
| Demonstrações | Cenas simples ilustrando uma ou duas características relacionadas. | |
| 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 mais recente, o MRTK está disponível por meio do Gerenciador de Pacotes do Unity.
Alguns dos benefícios de usar pacotes de ativos incluem:
- Projetos menores
- Soluções mais limpas do Visual Studio
- Menos arquivos para fazer 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 compilaçã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.jsonarquivo
- Alterar a versão no
Alguns dos desafios são:
- 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 fundação
O pacote básico (com.microsoft.mixedreality.toolkit.foundation) forma a base do Realidade Misturada Toolkit.
| Pasta | Componente | Descrição |
|---|---|---|
| MRTK/Núcleo | Definições de interface e tipo, classes base, sombreador padrão. | |
| MRTK/Core/Provedores | Provedores de dados independentes de plataforma | |
| Mãos | Suporte de classe base e serviços para rastreamento de mãos. | |
| Animação de entrada | Suporte para gravação de dados de movimento da cabeça e rastreamento manual. | |
| Simulação de entrada | Suporte para simulação no editor de entrada de mão e olho. | |
| ObjectMeshObserver | Observador de consciência espacial usando um modelo 3D como dados. | |
| Entrada de unidade | 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 | |
| Movimento de salto | 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 de câmera que habilita o uso do MRTK com dispositivos AR móveis. | |
| WindowsRealidade Misturada | Suporte para dispositivos Windows Mixed Reality, incluindo Microsoft HoloLens e headsets imersivos. | |
| 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 shaders, 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 | Bens comuns; modelos, texturas, materiais, etc. | |
| MRTK/Serviços | ||
| Sistema de Limites | Sistema que implementa suporte de limite VR. | |
| Sistema de câmera | Sistema implementando configuração e gerenciamento de câmeras. | |
| Sistema de diagnóstico | Implementação de sistema em diagnósticos de aplicativos, por exemplo, um criador de perfil visual. | |
| Sistema de entrada | Sistema que fornece suporte para acessar e manipular a entrada do usuário. | |
| Sistema de Cena | Sistema que fornece suporte a aplicativos de várias cenas. | |
| Sistema de Consciência Espacial | Sistema que fornece suporte para conscientização do ambiente do usuário. | |
| Sistema de Teletransporte | Sistema que fornece suporte para teletransporte (movendo-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 recomendados para todas as experiências de realidade misturada, incluindo:
- Sombreador padrão do MRTK
- Materiais básicos usando o sombreador MRTK Standard
- 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 MRTK Standard não estão incluídos no pacote de ativos padrão. Esses scripts podem ser encontrados no pacote básico 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 Física Manual | Serviço que adiciona suporte físico às mãos articuladas. | |
| Serviço de rastreamento perdido | Serviço que simplifica a entrega de perda de rastreamento em dispositivos Microsoft HoloLens. | |
| Serviço de transição de cena | 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 amostra. |
Mais detalhes sobre o processo de uso de pacotes que contêm projetos de exemplo podem ser encontrados no artigo Realidade Misturada 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 ú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. | |
| Janela de dependência | Ferramenta que cria um gráfico de dependência de ativos em um projeto. | |
| ExtensionServiceCreator | Assistente para auxiliar na criação de serviços de extensão. | |
| Janela de migração | Ferramenta que auxilia na atualização do código que usa componentes preteridos do MRTK. | |
| 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 serialização de arquivos específicos do Unity. | |
| RuntimeTools/Tools/ControllerMappingTool | Utilitário que permite que os desenvolvedores determinem rapidamente mapeamentos do Unity para controladores de hardware. | |
| ScreenshotUtility | Permite a captura de imagens de aplicativos no editor do Unity. | |
| Janela Combinadora de Textura | Utilitário para combinar texturas gráficas. | |
| Caixa de Ferramentas | Interface do usuário que facilita a descoberta e o uso de componentes de experiência do usuário do MRTK. |
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 no modo de reprodução. Esses utilitários são especialmente úteis para desenvolvedores que criam componentes MRTK.
| Pasta | Componente | Descrição |
|---|---|---|
| MRTK/Testes | ||
| Utilitários de teste | Métodos para simplificar a criação de testes de modo de jogo, incluindo utilitários de simulação de mãos. |
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 que contêm projetos de exemplo podem ser encontrados no artigo Realidade Misturada Toolkit e Unity Package Manager .
| Pasta | Componente | Descrição |
|---|---|---|
| MRTK/Exemplos | ||
| Amostras~ | Uma pasta oculta (no Editor do Unity) que contém as cenas e os ativos de amostra. | |
| 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)