Compartilhar via

Atualizando do HoloToolkit — MRTK2

  • Artigo

Um guia para ajudá-lo com a migração do HoloLens Toolkit (HTK) para o Realidade Misturada Toolkit (MRTK).

Controlador e entrada manual

Instalação e configuração

Métodos HTK 2017 MRTK v2
Tipo Eventos específicos para botões, com informações de tipo de entrada quando relevante. Entrada baseada em ação / gesto, transmitida por meio de eventos.
Instalação Coloque o InputManager na cena. Ative o sistema de entrada no Perfil de configuração e especifique um tipo de sistema de entrada concreto.
Configuração Configurado no Inspetor, em cada script individual na cena. Configurado por meio do Perfil do Sistema de Entrada de Realidade Misturada e seu perfil relacionado, listado abaixo.

Perfis relacionados:

  • Perfil de mapeamento do controlador de realidade misturada
  • Perfil de visualização do controlador de realidade misturada
  • Perfil de gestos de realidade misturada
  • Perfil de Ações de Entrada de Realidade Misturada
  • Perfil de regras de ação de entrada de realidade misturada
  • Perfil de ponteiro de realidade misturada

As configurações do Provedor de Foco são modificadas no objeto Câmera Principal na cena.

Os componentes de suporte à plataforma (por exemplo, Windows Mixed Reality Gerenciador de Dispositivos) devem ser adicionados aos provedores de dados do serviço correspondente.

Mapeamentos de interface e eventos

Alguns eventos não têm mais eventos exclusivos e agora contêm um MixedRealityInputAction. Essas ações são especificadas no perfil Ações de Entrada e mapeadas para controladores e plataformas específicos no perfil Mapeamento de Controlador. Eventos como OnInputDown agora devem verificar o tipo MixedRealityInputAction.

Sistemas de entrada relacionados:

HTK 2017 MRTK v2 Mapeamento de ações
IControllerInputHandler IMixedRealityInputHandler<Vector2> Mapeado para o touchpad ou thumbstick
IControllerTouchpadHandler IMixedRealityInputHandler Mapeado para o touchpad
IFocusable IMixedRealityFocusHandler
IGamePadHandler IMixedRealitySourceStateHandler
IHoldHandler IMixedRealityGestureHandler Mapeado para segurar no perfil de gestos
IInputClickHandler IMixedRealityPointerHandler
IInputHandler IMixedRealityInputHandler Mapeado para os botões do controlador ou toque com a mão
IManipulationHandler IMixedRealityGestureHandler<Vector3> Mapeado para manipulação no perfil de gestos
INavigationHandler IMixedRealityGestureHandler<Vector3> Mapeado para navegação no Perfil de gestos
IPointerSpecificFocusable IMixedRealityFocusChangedHandler
ISelectHandler IMixedRealityInputHandler<float> Mapeado para a posição de disparo
ISourcePositionHandler IMixedRealityInputHandler<Vector3> ou IMixedRealityInputHandler<MixedRealityPose> Mapeado para a posição do ponteiro ou posição de alça
ISourceRotationHandler IMixedRealityInputHandler<Quaternion> ou IMixedRealityInputHandler<MixedRealityPose> Mapeado para a posição do ponteiro ou posição de alça
ISourceStateHandler IMixedRealitySourceStateHandler
IXboxControllerHandler IMixedRealityInputHandler e IMixedRealityInputHandler<Vector2> Mapeado para os vários botões do controlador e thumbsticks

Câmera

Métodos HTK 2017 MRTK v2
Instalação Exclua MainCamera, adicione o pré-fabricado MixedRealityCameraParent / MixedRealityCamera / HoloLensCamera à cena ou use o item de menu Configurar Aplicar Configurações de Cena de Realidade > > Misturada. MainCamera parented em MixedRealityPlayspace por meio do Realidade Misturada Toolkit > Adicionar à cena e configurar...
Configuração Configuração de configurações da câmera executada na instância pré-fabricada. Configurações de câmera definidas no Perfil de Câmera de Realidade Misturada.

Fala

Reconhecimento de palavra-chave

Métodos HTK 2017 MRTK v2
Instalação Adicione um SpeechInputSource à sua cena. O serviço de palavra-chave (por exemplo, Gerenciador de Entrada de Fala do Windows) deve ser adicionado aos provedores de dados do sistema de entrada.
Configuração As palavras-chave reconhecidas são configuradas no inspetor do SpeechInputSource. As palavras-chave são configuradas no Perfil de Comandos de Fala de Realidade Misturada.
Manipuladores de eventos ISpeechHandler IMixedRealitySpeechHandler

Ditado

Métodos HTK 2017 MRTK v2
Instalação Adicione um DictationInputManager à sua cena. O suporte ao ditado requer que o serviço (por exemplo, Windows Dictation Input Manager) seja adicionado aos provedores de dados do Sistema de Entrada.
Manipuladores de eventos IDictationHandler IMixedRealityDictationHandlerIMixedRealitySpeechHandler

Consciência espacial / mapeamento

Mesh

Métodos HTK 2017 MRTK v2
Instalação Adicione o pré-fabricado SpatialMapping à cena. Habilite o Sistema de Reconhecimento Espacial no Perfil de Configuração e adicione um observador espacial (por exemplo, Windows Mixed Reality Spatial Mesh Observer) aos provedores de dados do Sistema de Reconhecimento Espacial.
Configuração Configure a instância de cena no inspetor. Defina as configurações no perfil de cada observador espacial.

Aviões

Métodos HTK 2017 MRTK v2
Instalação Use o SurfaceMeshesToPlanes script. Ainda não implementado.

Compreensão espacial

Métodos HTK 2017 MRTK v2
Instalação Adicione o pré-fabricado SpatialUnderstanding à cena. Ainda não implementado.
Configuração Configure a instância de cena no inspetor. Ainda não implementado.

Limite

Métodos HTK 2017 MRTK v2
Instalação Adicione o BoundaryManager script à cena. Habilite o sistema de limites no perfil de configuração.
Configuração Configure a instância de cena no inspetor. Defina as configurações no perfil de visualização de limite.

Compartilhamento

Métodos HTK 2017 MRTK v2
Instalação Serviço de compartilhamento: adicione o pré-fabricado de compartilhamento à cena. UNet: use o exemplo SharingWithUNET. Em andamento
Configuração Configure as instâncias de cena no inspetor. Em andamento

UX

Métodos HTK 2017 MRTK v2
Botão Objetos interacionáveis Botão
Interativo Objetos interacionáveis Interacionável
Caixa delimitadora Caixa delimitadora Caixa delimitadora
Barra de aplicativos Barra de aplicativos Barra de aplicativos
Manipulação de uma mão (Grb e Move) Arrastável à mão Manipulador de manipulação
Manipulação de duas mãos (agarrar/mover/girar/escalar) TwoHandManipulatable Manipulador de manipulação
Teclado Estrutura pré-fabricada de teclado Teclado do sistema
Dica de Ferramenta Tooltip Tooltip
Coleção de objetos Coleção de objetos Coleção de objetos
Solver Solver Solver

Utilidades

Alguns utilitários foram reconciliados como duplicatas com o sistema Solver. Registre um problema se algum dos scripts necessários estiver faltando.

HTK 2017 MRTK v2
Outdoor Billboard
Tagalong RadialView ou Orbital Solver
Tamanho Angular Fixo ConstantViewSizeSolver
Exibição de fps Sistema de diagnóstico (no perfil de configuração)
Quase desvanecimento Sombreador padrão do Realidade Misturada Toolkit