Upgrade da HoloToolkit

Um guia para o ajudar na migração de HoloLens Toolkit (HTK) para Mixed Reality Toolkit (MRTK).

Controlador e entrada de mão

Instalação e configuração

Métodos HTK 2017 MRTK v2
Tipo Eventos específicos para botões, com informação do tipo de entrada quando relevante. Entrada baseada em ação / gesto, transmitida através de eventos.
Configuração Coloque o InputManager no local. Ativar o sistema de entrada no Perfil de Configuração e especificar um tipo de sistema de entrada de betão.
Configuração Configurado no Inspetor, em cada guião individual na cena. Configurado através do Perfil do Sistema de Entrada de Realidade Mista e do seu perfil relacionado, listado abaixo.

Perfis relacionados:

  • Perfil de mapeamento do controlador de realidade mista
  • Perfil de visualização do controlador de realidade mista
  • Perfil de gestos de realidade mista
  • Perfil de ações de entrada de realidade mista
  • Perfil de regras de ação de entrada de realidade mista
  • Perfil de ponteiro de realidade mista

As definições do Gaze Provider são modificadas no objeto da Câmara Principal na cena.

Os componentes de suporte da plataforma (por exemplo, Windows Mixed Reality Gestor de Dispositivos) devem ser adicionados aos fornecedores de dados do seu serviço correspondente.

Mapeamentos de interface e eventos

Alguns eventos já não têm eventos únicos e agora contêm uma MixedRealityInputAction. Estas ações são especificadas no perfil de Ações de Entrada e mapeadas para controladores e plataformas específicas no perfil de Mapeamento do Controlador. Eventos como OnInputDown deve agora verificar o tipo MixedRealityInputAction.

Sistemas de entrada relacionados:

HTK 2017 MRTK v2 Mapeamento de ação
IControllerInputHandler IMixedRealityInputHandler<Vector2> Mapeado para o touchpad ou polegar
IControllerTouchpadHandler IMixedRealityInputHandler Mapeado para o touchpad
IFocusable IMixedRealityFocusHandler
IGamePadHandler IMixedRealitySourceStateHandler
IHoldHandler IMixedRealityGestureHandler Mapeado para manter no Perfil de Gestos
IInputClickHandler IMixedRealityPointerHandler
IInputHandler IMixedRealityInputHandler Mapeado para os botões do controlador ou torneira de mão
IManipulationHandler IMixedRealityGestureHandler<Vector3> Mapeado para manipulação no Perfil de Gestos
INavigationHandler IMixedRealityGestureHandler<Vector3> Mapeado para a navegação no Perfil de Gestos
IPointerSpecificFocusable IMixedRealityFocusChangedHandler
ISelectHandler IMixedRealityInputHandler<float> Mapeado para desencadear posição
ISourcePositionHandler IMixedRealityInputHandler<Vector3> ou IMixedRealityInputHandler<MixedRealityPose> Mapeado para a posição do ponteiro ou posição de aderência
ISourceRotationHandler IMixedRealityInputHandler<Quaternion> ou IMixedRealityInputHandler<MixedRealityPose> Mapeado para a posição do ponteiro ou posição de aderência
ISourceStateHandler IMixedRealitySourceStateHandler
IXboxControllerHandler IMixedRealityInputHandler e IMixedRealityInputHandler<Vector2> Mapeado para os vários botões do controlador e polegares

Câmara

Métodos HTK 2017 MRTK v2
Configuração Delete MainCamera, adicionar MixedRealityCameraParent / MixedRealityCamera / HoloLensCamera prefab para a cena ou usar Configuração de Ferramentas de Realidade Mista Aplicar Cena de Realidade Mista Definições item do > menu. MainCamera parented under MixedRealityPlayspace via Mixed Reality Toolkit > Add to Scene and Configure...
Configuração Configuração de definições de câmara realizada em instância pré-fabricada. Definições de câmara configuradas no Perfil da Câmara de Realidade Mista.

Voz

Reconhecimento de palavras-chave

Métodos HTK 2017 MRTK v2
Configuração Adicione um SpeechInputSource à sua cena. O serviço de palavras-chave (por exemplo, Windows Gestor de Entrada de Discurso) deve ser adicionado aos fornecedores de dados do sistema de entrada.
Configuração Palavras-chave reconhecidas estão configuradas no inspetor do SpeechInputSource. As palavras-chave estão configuradas no perfil de comandos de discurso de realidade mista.
Processadores de eventos ISpeechHandler IMixedRealitySpeechHandler

Ditado

Métodos HTK 2017 MRTK v2
Configuração Adicione um DitadoInputManager à sua cena. O suporte de ditado requer que o serviço (por exemplo, Windows Gestor de Inputs de Ditado) seja adicionado aos fornecedores de dados do Sistema de Entrada.
Processadores de eventos IDictationHandler IMixedRealityDictationHandlerIMixedRealitySpeechHandler

Consciência espacial / mapeamento

Malha

Métodos HTK 2017 MRTK v2
Configuração Adicione o pré-teste de SpatialMapping à cena do crime. Capacitar o Sistema de Sensibilização Espacial no Perfil de Configuração e adicionar um observador espacial (por exemplo, Windows Mixed Reality Observador de Malha Espacial) aos fornecedores de dados do Sistema de Sensibilização Espacial.
Configuração Configure o caso da cena no inspetor. Configure as definições no perfil de cada observador espacial.

Aviões

Métodos HTK 2017 MRTK v2
Configuração Usa o SurfaceMeshesToPlanes guião. Ainda não implementado.

Compreensão espacial

Métodos HTK 2017 MRTK v2
Configuração Adicione o prefácio EspacialUnderstanding à cena do crime. Ainda não implementado.
Configuração Configure o caso da cena no inspetor. Ainda não implementado.

Limite

Métodos HTK 2017 MRTK v2
Configuração Adicione o BoundaryManager guião à cena do crime. Ativar o Sistema de Definição no Perfil de Configuração.
Configuração Configure o caso da cena no inspetor. Configurar as definições no perfil de Visualização de Limites.

Partilhar

Métodos HTK 2017 MRTK v2
Configuração Serviço de partilha: Adicionar a partilha pré-fabricada à cena. UNet: Use sharingWithUNET exemplo. Em curso
Configuração Configure os casos de cena no inspetor. Em curso

UX

Métodos HTK 2017 MRTK v2
Botão Objetos interagiáveis Botão
Interagivel Objetos interagiáveis Interagivel
Caixa de delimitação Caixa de delimitação Caixa de delimitação
App Bar App Bar App Bar
Manipulação de Uma Mão (Grb e Move) HandDraggable Manipulador de Manipulação
Manipulação de duas mãos (Agarrar/Mover/Rodar/Escalar) TwoHandManipulatable Manipulador de Manipulação
Teclado Pré-fabricado de teclado Teclado do sistema
Descrição Descrição Descrição
Coleção de Objetos Coleção de Objetos Coleção de Objetos
Solver Solver Solver

Utilitários

Alguns utilitários foram reconciliados como duplicados com o sistema Solver. Por favor, preencha um problema se algum dos scripts de que precisa estiver desaparecido.

HTK 2017 MRTK v2
Outdoor Billboard
Tagalong RadialViewou OrbitalRadialView
Tamanho fixo ConstantViewSizeConstantViewSize
FpsDisplay Sistema de Diagnóstico (no Perfil de Configuração)
NearFade Incorporado para o kit de ferramentas de realidade mista shader standard