Notas de Versão do Microsoft Mixed Reality Toolkit 2.6

Importante

Existe um problema conhecido do compilador que afeta as aplicações criadas para o Microsoft HoloLens 2 com o ARM64. Este problema foi corrigido ao atualizar o Visual Studio 2019 para a versão 16.8 ou posterior. Se não conseguir atualizar o Visual Studio, importe o com.microsoft.mixedreality.toolkit.tools pacote para aplicar uma solução.

Novidades na versão 2.6.2

Corrige a parentalidade da malha espacial

Corrige o problema em que as malhas espaciais não estavam a ser localizadas corretamente depois de o objeto Mixed Reality Playspace ter sido movido (por exemplo, através de um teletransporte).

Novidades na versão 2.6.1

Corrige que o OpenXR não está em execução no HoloLens 2/UWP

Corrige uma regressão que impediu a execução do suporte OpenXR do MRTK no UWP.

Corrige que o Objeto de Movimento LeapManipulator não está a rodar

Corrige uma regressão em que a rotação de um Movimento Bissexto não foi tida em conta pelo script ObjectManipulator.

Atualizações de cenas de exemplo

Atualizações cena compreender a cena de exemplo para refletir corretamente o estado enviado do plug-in do Unity. Também atualiza o exemplo para deixar de ter uma dependência da cena de exemplo de deteção espacial que está a ser importada. Antes de atualizar para a 2.6.1, deve eliminar os exemplos de compreensão de cenários importados e de deteção espacial se estiverem presentes no seu projeto para evitar possíveis conflitos. Se não tiver removido esses exemplos e vir conflitos relacionados com os da consola do , remova ambos os exemplos (ou a Assets/Samples/Mixed Reality Toolkit Examples pasta) e, em seguida, tente importar novamente.

Atualizações a cena de exemplo da caixa de diálogo para descrever corretamente os cenários de caixa de diálogo atuais.

Novidades na versão 2.6.0


Adicionar suporte para OpenXR

Foi adicionado suporte inicial para o pacote de pré-visualização OpenXR do Unity e o pacote OpenXR Mixed Reality da Microsoft. Consulte a página introdução ao MRTK/XRSDK, a publicação do fórum do Unity ou a documentação da Microsoft para obter mais informações.

Importante

O OpenXR no Unity só é suportado no Unity 2020.2 e superior.

Atualmente, também suporta apenas compilações x64 e ARM64.

Utilitário de troca de ativos

Troque vários recursos numa cena do Unity com o novo utilitário Troca de Ativos.

Hp Motion Controllers agora suportados com MRTK

Os controladores para o HP Reverb G2 funcionam agora nativamente com o MRTK.

Experimental Interactive Element + State Visualizer

O Interactive Element é um ponto de entrada centralizado simplificado para o sistema de entrada MRTK. Contém métodos de gestão de estado, gestão de eventos e a lógica de definição de estado para Estados de Interação Principais. Para obter mais informações, veja Interactive Element Documentation (Documentação do Elemento Interativo).

InteractiveElementAddCoreState

A Visualização de Estado é um componente de animação que depende do Elemento Interativo. Este componente cria Clips de Animação, define keyframes e gera uma Máquina de Estado do Animador. Para obter mais informações, veja Documentação do Visualizador de Estado

StateVisualizerColorChangeOnFocus

Teletransporte com o gesto de teletransporte agora suportado em todas as plataformas

Os utilizadores podem agora utilizar o gesto de teletransporte para se deslocarem pelo espaço de jogo em todas as plataformas. Para teletransportar com um controlador em dispositivos MR com configurações predefinidas, utilize o manípulo. Para teletransportar com as mãos articuladas, faça um gesto com a palma da mão virada para cima com o índice e o polegar colado para fora, completando a teleporta enrolando o dedo indicador. Para teletransportar com a simulação de entrada, veja a nossa documentação atualizada do Serviço de Simulação de Entrada.

Gesto de Teletransporte

Scene Understanding agora disponível no MRTK como um observador experimental de sensibilização espacial

O suporte experimental do Scene Understanding é introduzido no MRTK 2.6. Os utilizadores podem incorporar as capacidades de compreensão de cenários de HoloLens 2 como observador de sensibilização espacial em projetos baseados em MRTK. Leia a documentação do Scene Understanding para obter mais informações.

Importante

O Scene Understanding só é suportado no HoloLens 2 e no Unity 2019.4 e superior.

Esta funcionalidade requer o pacote Deteção de Cenas, que está agora disponível através da Ferramenta de Funcionalidades do Mixed Reality. Ao utilizar a Ferramenta de Funcionalidades do Mixed Reality ou ao importar através do UPM, importe o exemplo Demos - SpatialAwareness antes de importar o exemplo Experimental - SceneUnderstanding devido a um problema de dependência. Veja este problema do GitHub para obter mais informações.

Compreensão do Cenário

Suporte de mudança de perfil de runtime

Agora, o MRTK permite mudar de perfil antes da inicialização da instância do MRTK (ou seja, comutador de perfil de inicialização pré-MRTK) e depois de um perfil estar em utilização ativa (ou seja, comutador de perfil ativo). O comutador anterior pode ser utilizado para ativar componentes selecionados com base nas capacidades do hardware, enquanto este último pode ser utilizado para modificar a experiência à medida que o utilizador entra numa subparte da aplicação. Leia a documentação sobre como mudar de perfil para obter mais informações e exemplos de código.

Indicador direcional e seguir solucionadores formados em experimentais

Dois novos solucionadores estão prontos para serem utilizados com o MRTK mainline.

Solucionador de IndicadorEs Direcionais

Hand Coach formou-se em experimental

A funcionalidade Hand Coach está agora pronta para ser utilizada com o MRTK de linha principal.

Exemplo do Hand Coach

Controlos de caixa de diálogo formados a partir de experimentais

Os controlos de caixa de diálogo estão agora prontos para serem utilizados com o MRTK da linha principal.

Controlos de Caixa de Diálogo

O tom de pulso formou-se em experimental

Os scripts de sombreado pulse formaram-se em experimentais. Para obter mais informações, veja: Documentação do Pulse Shader

MRTK_SpatialMesh_Pulse

Melhorias do Serviço de Gravação de Entrada

InputRecordingService e InputPlaybackService agora pode gravar e reproduzir entradas de olhar para trás. A gravação foi otimizada para garantir uma taxa de fotogramas consistente ao longo do período de gravação, enquanto o tamanho do ficheiro de gravação e o tempo de poupança também são reduzidos em cerca de 50%. Guardar e carregar ficheiros de gravação pode agora ser efetuado de forma assíncrona. Tenha em atenção que o formato de ficheiro da gravação foi alterado nesta versão do MRTK. Consulte aqui para obter mais informações sobre as especificações da nova versão 1.1.

Modo de leitura

Foi adicionado suporte para o modo de leitura no HoloLens 2. O modo de leitura reduz o campo de vista do sistema, mas elimina um dimensionamento da saída do Unity. Um pixel composto pelo Unity corresponderá a um píxel projetado no HoloLens 2. Os autores da aplicação devem fazer testes com vários indivíduos para se certificarem de que esta é uma desvantagem que pretendem na sua aplicação.

Windows Mixed Reality modo de leitura

Suporte para iniciadores de aplicações 3D no UWP

Adiciona a capacidade de definir um iniciador de aplicações 3D para UWP. Esta definição está exposta na Janela de Compilação do MRTK e nas Definições do Projeto MRTK, em Definições de Compilação. É automaticamente escrito no projeto durante a compilação no Unity.

Definições de compilação

Alterações interruptivas

Determinados campos de objetos GLTF importados estão agora em maiúsculas

Devido a problemas relacionados com a desserialização, alguns campos de objetos GLTF importados começam agora com letras maiúsculas. Os campos afetados são (nos respetivos novos nomes): ComponentType, , InterpolationPath, Target, Type, MagFilterMode, MinFilter, , WrapS, . WrapT

O ficheiro binário de animação de entrada tem um formato atualizado da versão 1.1

O ficheiro binário de animação de entrada, utilizado por InputRecordingService e InputPlaybackService, tem agora um formato de ficheiro atualizado para ativar as otimizações efetuadas nesses dois serviços. Consulte aqui para obter mais informações sobre as novas especificações da versão 1.1.

Suporte do MSBuild para Unity

O suporte para o MSBuild para o Unity foi removido a partir da versão 2.5.2, para se alinhar com a nova documentação de orientação do pacote do Unity.

Problemas conhecidos

OpenXR

Atualmente, existe um problema conhecido com a Comunicação Remota Holográfica e o OpenXR, em que as juntas de mão não estão consistentemente disponíveis. Além disso, as cenas de exemplo de controlo ocular não são atualmente compatíveis, embora o controlo ocular funcione .

Algumas funcionalidades do Toolkit Standard Shader do Mixed Reality necessitam do pacote Foundation

Quando importados através do Unity Package Manager, os scripts de utilitários DoMTK Standard Shader (por exemplo, HoverLight.cs) não estão colocalizados com o sombreado no pacote Recursos Standard. Para aceder a esta funcionalidade, as aplicações exigirão que o pacote Foundation seja importado.

O CameraCache pode criar uma nova câmara no encerramento

Em algumas situações (por exemplo, ao utilizar o fornecedor LeapMotion no Editor do Unity), é possível que a CameraCache recrie o MainCamera no encerramento. Veja este problema para obter mais informações.

FileNotFoundException quando os exemplos são importados através do Unity Package Manager

Consoante a duração do caminho do projeto, a importação de exemplos através do Unity Package Manager pode gerar mensagens FileNotFoundException na Consola do Unity. A causa deste problema é o caminho para que o ficheiro "em falta" seja superior a MAX_PATH (256 carateres). Para resolver, reduza o comprimento do caminho do projeto.

Não foi especificado nenhum espacializador. A aplicação não suportará o Som Espacial

Será apresentado um aviso "Não foi especificado nenhum espacializador" se um espacializador de áudio não estiver configurado. Isto pode ocorrer se não estiver instalado nenhum pacote XR, uma vez que o Unity inclui espacializadores nestes pacotes.

Para resolver, certifique-se de que:

  • Janela>O Gestor de Pacotes tem um ou mais pacotes XR instalados

  • Mixed Reality Toolkit>Utilities> Configure Unity Project and make a selection for Audio Spatializer (Configurar o Projeto do Unity e efetuar uma seleção para o Audio Spatializer)

    Selecionar Espacializador de Áudio

NullReferenceException: Referência de objeto não definida para uma instância de um objeto (SceneTransitionService.Initialize)

Em algumas situações, abrir EyeTrackingDemo-00-RootScene pode causar uma NullReferenceException no método Initialize da classe SceneTransitionService. Este erro deve-se ao facto de o perfil de configuração do Serviço de Transição de Cenas estar desmarcado. Para resolver o problema, utilize os seguintes passos:

  • Navegue para o MixedRealityToolkit objeto na Hierarquia
  • Na janela Inspetor, selecione Extensions
  • Se não estiver expandido, expanda Scene Transition Service
  • Defina o valor de Configuration Profile como MRTKExamplesHubSceneTransitionServiceProfile

Corrigir Perfil de Transição de Cenário

Oculus Quest

Atualmente, existe um problema conhecido na utilização do plug-in Oculus XR ao filtrar plataformas autónomas. Verifique se existem atualizações no localizador de erros/fóruns/notas de versão da Oculus.

O erro é assinado com este conjunto de 3 erros:

Erro de Plug-in Oculus XR

UnityUI e TextMeshPro

Existe um problema conhecido para versões mais recentes do TextMeshPro (1.5.0+ ou 2.1.1+), em que o tamanho do tipo de letra predefinido para listas pendentes e espaçamento de carateres de tipo de letra a negrito foi alterado.

Imagem TMP

Isto pode ser resolvido ao mudar para uma versão anterior do TextMeshPro. Veja o problema n.º 8556 para obter mais detalhes.