Atualizar a partir do HoloToolkit — MRTK2

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

Controlador e introdução 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 relevantes. Entrada baseada em ações/gestos, transmitida através de eventos.
Configuraçã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 através da Mixed Reality Perfil do Sistema de Entrada e do respetivo perfil relacionado, listado abaixo.

Perfis relacionados:

  • Perfil de Mapeamento do Controlador Mixed Reality
  • Perfil de Visualização do Controlador Mixed Reality
  • Perfil de Gestos de Mixed Reality
  • Mixed Reality Perfil de Ações de Entrada
  • Perfil de Regras de Ação de Entrada do Mixed Reality
  • Perfil de Ponteiro de Mixed Reality

As definições do Fornecedor de Gaze são modificadas no objeto Câmara Principal no local.

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

Mapeamentos de interfaces e eventos

Alguns eventos já não têm eventos exclusivos e agora contêm uma MixedRealityInputAction. Estas ações são especificadas no perfil Ações de Entrada e mapeadas para controladores e plataformas específicos no perfil mapeamento do controlador. Eventos como OnInputDown devem agora 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 manual
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 do acionador
ISourcePositionHandler IMixedRealityInputHandler<Vector3> ou IMixedRealityInputHandler<MixedRealityPose> Mapeado para posição do ponteiro ou posição de aderência
ISourceRotationHandler IMixedRealityInputHandler<Quaternion> ou IMixedRealityInputHandler<MixedRealityPose> Mapeado para posição do ponteiro ou posição de aderência
ISourceStateHandler IMixedRealitySourceStateHandler
IXboxControllerHandler IMixedRealityInputHandler e IMixedRealityInputHandler<Vector2> Mapeado para os vários botões e manípulos do controlador

Câmara

Métodos HTK 2017 MRTK v2
Configuração Elimine MainCamera, adicione MixedRealityCameraParent/MixedRealityCamera/HoloLensCamera prefab à cena ou utilize Mixed Reality item de menu Configurar > o Toolkit > Aplicar Mixed Reality Definições de Cena. MainCamera parented under MixedRealityPlayspace via Mixed Reality Toolkit > Add to Scene and Configure...
Configuração Configuração das definições da câmara executada na instância pré-fabricada. Definições da câmara configuradas no Perfil da Câmara do Mixed Reality.

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, Gestor de Entradas de Voz do Windows) tem de ser adicionado aos fornecedores 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 Voz do Mixed Reality.
Processadores de eventos ISpeechHandler IMixedRealitySpeechHandler

Ditado

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

Deteção/mapeamento espacial

Malha

Métodos HTK 2017 MRTK v2
Configuração Adicione a base de dados SpatialMapping à cena. Ative o Sistema de Sensibilização Espacial no Perfil de Configuração e adicione um observador espacial (por exemplo, Windows Mixed Reality Spatial Mesh Observer) aos fornecedores de dados do Sistema de Sensibilização Espacial.
Configuração Configure a instância de cena no inspetor. Configure as definições no perfil de cada observador espacial.

Aviões

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

Compreensão espacial

Métodos HTK 2017 MRTK v2
Configuração Adicione a prefab 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
Configuração Adicione o BoundaryManager script à cena. Ative o Sistema de Limites no Perfil de Configuração.
Configuração Configure a instância de cena no inspetor. Configure as definições no perfil Visualização de Limites.

Partilhar

Métodos HTK 2017 MRTK v2
Configuração Serviço de partilha: adicione a pré-criação de Partilha à cena. UNet: utilize 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 Interagiveis Botão
Interacionável Objetos Interagiveis Interacionável
Caixa Delimitadora Caixa Delimitadora Caixa Delimitadora
Barra de Aplicações Barra de Aplicações Barra de Aplicações
Manipulação de Uma Mão (Grb e Mover) HandDraggable Processador de Manipulação
Manipulação de Duas Mãos (Agarrar/Mover/Rodar/Dimensionar) TwoHandManipulatable Processador de Manipulação
Teclado Pré-fabricada do 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. Submeta um problema se algum dos scripts de que precisa estiver em falta.

HTK 2017 MRTK v2
Billboard Billboard
Tagalong RadialView ou OrbitalSolver
FixedAngularSize ConstantViewSizeSolver
FpsDisplay Sistema de Diagnóstico (no Perfil de Configuração)
NearFade Sombreado incorporado no Mixed Reality Toolkit Standard