Pacotes do MRTK
a realidade misturada Toolkit (MRTK) é uma coleção de pacotes que habilitam o desenvolvimento de aplicativos de realidade mista entre plataformas, fornecendo suporte para hardware e plataformas de realidade misturada.
o MRTK está disponível como pacotes de ativo (. unitypackage) e por meio do Gerenciador de Pacotes do Unity.
Pacotes de ativos
O ativo MRTK (. unitypackage) pode ser baixado de GitHub.
Alguns dos benefícios de usar pacotes de ativos incluem:
- Disponível para o Unity 2018,4 e mais recente
- Fácil de fazer alterações no MRTK
- MRTK está na pasta de 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 gerenciamento de dependência
- Os clientes são obrigados a resolver dependências de pacote manualmente
- Processo de atualização manual
- Várias etapas
- Atualizações de controle do código-fonte grandes (mais de 3.000 arquivos)
- Risco de perder as alterações feitas no MRTK
- A importação do pacote de exemplos normalmente significa incluir todos os exemplos
Os pacotes disponíveis são:
Esses pacotes são liberados e têm suporte da Microsoft do código-fonte no mrtk_release branch no github.
Pacote do Foundation
a realidade misturada Toolkit Foundation é o conjunto de códigos que permite que seu aplicativo aproveite a funcionalidade comum entre plataformas de realidade misturada.
Pacote do MRTK Foundation
O pacote do 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/núcleo/provedores | Provedores de dados independentes de plataforma | |
| Participação | Suporte de classe base e serviços para acompanhamento à mão. | |
| InputAnimation | Suporte para registro de movimentação de cabeçalho e dados de rastreamento de mão. | |
| InputSimulation | Suporte para simulação de entrada e de olho no editor. | |
| ObjectMeshObserver | O observador de conscientização 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 UltraLeap Leap. | |
| 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 de MRTK com dispositivos móveis. | |
| WindowsMixedReality | suporte para dispositivos Windows Mixed Reality, incluindo headsets de Microsoft HoloLens e de imersão. | |
| Windows | suporte para APIs específicas da Microsoft Windows, por exemplo, fala e ditado. | |
| SDK do XR | Experimental Suporte para o novo XR Framework do Unity no Unity 2019,3 e mais recente. | |
| MRTK/SDK | ||
| Habilitação | Recursos experimentais, incluindo sombreadores, controles de interface do usuário e gerentes de sistema individuais. | |
| Recursos | Funcionalidade que se baseia no pacote base. | |
| Perfis | perfis padrão para a realidade mista da Microsoft Toolkit sistemas e serviços. | |
| StandardAssets | Ativos comuns; modelos, texturas, materiais, etc. | |
| MRTK/SceneSystemResources | Ativos e recursos usados pelo sistema de cena | |
| MRTK/serviços | ||
| BoundarySystem | Sistema implementando suporte de limite VR. | |
| CameraSystem | Sistema implementando a configuração e o gerenciamento da câmera. | |
| DiagnosticsSystem | Sistema implementando no Application Diagnostics, 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 a conscientização do ambiente do usuário. | |
| TeleportSystem | Sistema que fornece suporte para teleportabilidade (mudando 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 misturada |
Pacote de extensões
O pacote opcional Microsoft. MixedRealityToolkit. Unity. Extensions inclui serviços adicionais que estendem a funcionalidade do Toolkit de realidade misturada da Microsoft.
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 o tratamento da perda de acompanhamento em Microsoft HoloLens dispositivos. | |
| 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 mixed reality Toolkit. Essas ferramentas estão localizadas no menu Utilitários Toolkit > 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 um 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 ajuda na atualização de código que usa componentes do MRTK preterido. | |
| OptimizeWindow | Utilitário para ajudar a automatizar a configuração de um projeto de realidade misturada para o melhor desempenho no Unity. | |
| ReserializeAssetsUtility | Fornece suporte para reserializar arquivos específicos do Unity. | |
| RuntimeTools/Tools/ControllerMappingTool | Utilitário que permite aos desenvolvedores determinar 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. |
Testar pacote de utilitários
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 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 de mão. |
Pacote de exemplos
O pacote de exemplos contém demonstrações, scripts de exemplo e cenas de exemplo que exerçam a funcionalidade no pacote de base. Este pacote contém a cena HandInteractionExample (imagem abaixo) que contém objetos de exemplo que respondem a vários tipos de entrada à mão (articulados e não articulados).
Esse 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 e local de pasta.
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. |
Unity Gerenciador de Pacotes
Para experiências que estão sendo criadas usando o Unity 2019.4 e mais novas, o MRTK está disponível por meio do Unity Gerenciador de Pacotes.
Alguns dos benefícios de usar pacotes de ativos incluem:
- Projetos menores
- Soluções de Visual Studio limpeza
- Menos arquivos para fazer check-in (o MRTK é uma referência simples no
Packages/manifest.jsonarquivo)
- Compilação mais rápida
- O Unity não precisa recompilar o MRTK durante a criação
- Resolução de dependência
- Os pacotes do 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 são removidas durante a resolução do pacote
- O MRTK não dá suporte a pacotes UPM com o Unity 2018.4
Pacote foundation
O pacote de base ( com.microsoft.mixedreality.toolkit.foundation ) forma a base do Toolkit.
| Pasta | Componente | Descrição |
|---|---|---|
| MRTK/Core | Definições de interface e tipo, classes base, sombreador padrão. | |
| MRTK/Core/Providers | Provedores de dados agnósticos de plataforma | |
| Mãos | Suporte de classe base e serviços para acompanhamento de mão. | |
| InputAnimation | Suporte para gravação de movimentação de cabeça e dados de acompanhamento de 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 (pixel, 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 UltraLeap Leap. | |
| 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 de MRTK com dispositivos móveis. | |
| WindowsMixedReality | suporte para dispositivos Windows Mixed Reality, incluindo headsets de Microsoft HoloLens e de imersão. | |
| Windows | suporte para APIs específicas da Microsoft Windows, por exemplo, fala e ditado. | |
| SDK do XR | Experimental Suporte para o novo XR Framework do Unity no Unity 2019,3 e mais recente. | |
| MRTK/SDK | ||
| Habilitação | Recursos experimentais, incluindo sombreadores, controles de interface do usuário e gerentes de sistema individuais. | |
| Recursos | Funcionalidade que se baseia no pacote base. | |
| Perfis | perfis padrão para a realidade mista da Microsoft Toolkit sistemas e serviços. | |
| StandardAssets | Ativos comuns; modelos, texturas, materiais, etc. | |
| MRTK/serviços | ||
| BoundarySystem | Sistema implementando suporte de limite VR. | |
| CameraSystem | Sistema implementando a configuração e o gerenciamento da câmera. | |
| DiagnosticsSystem | Sistema implementando no Application Diagnostics, 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 a conscientização do ambiente do usuário. | |
| TeleportSystem | Sistema que fornece suporte para teleportabilidade (mudando 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 MRTK
- Materiais básicos usando o sombreador padrão do MRTK
- Arquivos de áudio
- Fontes
- Texturas
- Ícones
Observação
Para evitar alterações significativas com base nas definições de assembly, os scripts usados para controlar alguns recursos do sombreador Standard MRTK não estão incluídos no pacote de ativos padrão. Esses scripts podem ser encontrados no pacote base da 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 | ||
| HandPhysicsService | Serviço que adiciona suporte de física a mãos articuladas. | |
| LostTrackingService | serviço que simplifica a 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 (na editora do Unity) que contém os bastidores de exemplo e os ativos. |
mais detalhes sobre o processo de uso de pacotes que contêm projetos de exemplo podem ser encontrados na realidade misturada Toolkit e no artigo Gerenciador de Pacotes do Unity.
Dependências:
- Foundation (
com.microsoft.mixedreality.toolkit.foundation)
Pacote de ferramentas
O pacote de ferramentas opcionais ( com.microsoft.mixedreality.toolkit.tools) contém ferramentas úteis para a criação de 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 um grafo de dependência de ativos em um projeto. | |
| ExtensionServiceCreator | Assistente para auxiliar na criação de serviços de extensão. | |
| MigrationWindow | Ferramenta que ajuda a atualizar o código que usa componentes MRTK preteridos. | |
| OptimizeWindow | Utilitário para ajudar a automatizar a configuração de um projeto de realidade misturada para o melhor desempenho no Unity. | |
| ReserializeAssetsUtility | Fornece suporte para reserialização de arquivos específicos do Unity. | |
| RuntimeTools/ferramentas/ControllerMappingTool | Utilitário que permite aos desenvolvedores determinar rapidamente os mapeamentos do Unity para controladores de hardware. | |
| ScreenshotUtility | Habilita a captura de imagens do aplicativo no editor do Unity. | |
| TextureCombinerWindow | Utilitário para combinar texturas de gráficos. | |
| Caixa de Ferramentas | A interface do usuário facilita a descoberta e o uso de componentes do MRTK UX. |
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 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 | 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 de mão. |
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 na realidade misturada Toolkit e no artigo Gerenciador de Pacotes do Unity.
| Pasta | Componente | Descrição |
|---|---|---|
| MRTK/exemplos | ||
| Amostras ~ | Uma pasta oculta (na editora do Unity) que contém os bastidores de exemplo e os ativos. | |
| 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)