Partilhar via


Atualizando do HoloToolkit — MRTK2

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

Controlador e entrada manual

Instalação e configuração

Métodos HTK 2017 MRTK v2
Type Eventos específicos para botões, com informações de tipo de entrada quando relevante. Entrada baseada em ação / gesto, transmitida através de eventos.
Configurar Coloque o InputManager na cena. Habilite 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 através do Perfil do Sistema de Entrada de Realidade Mista e 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 das Regras de Ação de Entrada de Realidade Mista
  • Perfil do ponteiro de realidade mista

As configurações do Provedor de Olhar são modificadas no objeto da câmera principal na cena.

Os componentes de suporte da plataforma (por exemplo, o Gerenciador de Dispositivos do Windows Mixed Reality) 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 de mapeamento do 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 manter 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 acionar a 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 thumbsticks

Câmara

Métodos HTK 2017 MRTK v2
Configurar Exclua MainCamera, adicione MixedRealityCameraParent / MixedRealityCamera / HoloLensCamera pré-fabricado à cena ou use o item de menu Mixed Reality Toolkit > Configure > Apply Mixed Reality Scene Settings. MainCamera parented em MixedRealityPlayspace via Mixed Reality Toolkit > Adicionar à cena e configurar...
Configuração Configuração de configurações da câmera realizada em instância pré-fabricada. Configurações da câmera configuradas no Perfil da câmera de realidade mista.

Voz

Reconhecimento de palavras-chave

Métodos HTK 2017 MRTK v2
Configurar Adicione um SpeechInputSource à sua cena. O serviço de palavras-chave (por exemplo, o 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 Mista.
Processadores de eventos ISpeechHandler IMixedRealitySpeechHandler

Ditado

Métodos HTK 2017 MRTK v2
Configurar Adicione um DictationInputManager à sua cena. O suporte a ditado requer que o serviço (por exemplo, o Gerenciador de Entrada de Ditado do Windows) seja adicionado aos provedores de dados do Sistema de Entrada.
Processadores de eventos IDictationHandler IMixedRealityDictationHandlerIMixedRealitySpeechHandler

Consciência espacial / mapeamento

Malha

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

Aviões

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

Compreensão espacial

Métodos HTK 2017 MRTK v2
Configurar 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
Configurar 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. Configure as configurações no perfil de visualização de limite.

Partilhar

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

UX

Métodos HTK 2017 MRTK v2
Botão Objetos interacionáveis Botão
Interacionável 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) HandDraggable Manipulador de manipulação
Manipulação de duas mãos (agarrar/mover/girar/escalar) TwoHandManipulatable Manipulador de manipulação
Teclado Teclado pré-fabricado Teclado do sistema
Descrição Tooltip Tooltip
Coleção Object Coleção Object Coleção Object
Solver Solucionador Solucionador

Utilitários

Alguns utilitários foram reconciliados como duplicados com o sistema Solver. Por favor, registre um problema se algum dos scripts que você precisa estiver faltando.

HTK 2017 MRTK v2
Cartaz Billboard
Tagalong RadialView ou Orbital Solver
FixedAngularSize ConstantViewSizeSolucionador
FpsDisplay Sistema de Diagnóstico (em Perfil de Configuração)
NearFade Sombreador padrão integrado ao Kit de Ferramentas de Realidade Mista