Resolução de problemas do World Locking Tools
Os problemas inoportunos serão anotados aqui. Além disso, veja uma estratégia recomendada para limitar os problemas de fixação de mundo.
Problemas de bloqueio de mundo
Taxa de quadros baixa
O World Locking Tools não deve ter um impacto perceptível na taxa de quadros. (Uma exceção é que as visualizações eventualmente arrastarão para baixo a taxa de quadros após a criação de muitas âncoras, mas os visualizadores são apenas para diagnóstico, não para envio com o aplicativo.)
Se você observar uma queda na taxa de quadros depois de adicionar o World Locking Tools ao aplicativo, verifique os logs do Unity. Isso geralmente significa que uma exceção está sendo gerada repetidamente.
Erros "Missing DLL"
Esses erros geralmente são da DLL do Frozen World Engine. Para resolvê-los, siga as instruções na documentação de configuração para atualizar o mecanismo FrozenWorld para uma versão posterior. Seguir essas instruções sem alterar o número de versão repara a instalação.
Como alternativa, faça a instalação com a ferramenta do recurso de MR. A ferramenta lida com a instalação de dependências para você.
Namespace 'FrozenWorld' ausente
Erros como os seguintes (geralmente muitos):
Assets\WorldLocking.Engine\Plugin.cs(10,37): erro CS0234: o tipo ou nome do namespace 'FrozenWorld' não existe no namespace 'Microsoft.MixedReality' (você perdeu uma referência de assembly?)
A DLL FrozenWorld.Engine está ausente. Confira Configuração do NuGet.
Como alternativa, instale usando a Ferramenta de Recursos de MR e faça com que a instalação de dependências seja resolvida para você.
Não está funcionando
Verifique os logs do Unity quanto a erros e exceções.
Verifique se a câmera da cena está conectada a pelo menos um objeto. Veja a configuração em WorldLocking.Examples.WorldLockingPhysicsSample como exemplo. Se você estiver manipulando a câmera dinamicamente, poderá precisar manter o WorldLockingManager informado sobre a câmera atual. Confira WorldLockingManager.AdjustmentFrame e WorldLockingManager.CameraParent.
Problemas mais gerais do Unity/da RA
"DirectoryNotFoundException: não foi possível encontrar uma parte do caminho"
O caminho ficou muito longo. Confira uma explicação mais completa aqui.
Você vê a caixa de mensagem "Uma operação remota está demorando mais do que o esperado" e há uma falha na implantação
Verifique a conexão USB. Um cabo ruim, uma porta ruim ou um IPOverUSB ausente podem causar esse problema. Mas provavelmente está em algum lugar no caminho de comunicação do computador com o dispositivo.
Componentes de SDK do Windows ausentes
Incompatibilidade entre a versão do Visual Studio indicada no Unity e a versão do Visual Studio que você está usando para tentar compilar. Verificação:
Unity > File > Build Settings > Visual Studio Version
É especialmente perigoso se estiver definido como Latest Installed e você tiver várias versões do Visual Studio instaladas.
No HoloLens, o aplicativo é iniciado como um slate, em vez de uma experiência de RA
Se estiver direcionando o suporte à VR interna do Unity, também conhecido como XR Herdado, verifique:
Unity > Project Settings > Player > XR Settings
Você deve ter selecionado o Suporte à realidade virtual e o Windows Mixed Reality em SDKs de realidade virtual.
Se você estiver usando os subsistemas de RA do Unity/SDK de RX, verifique se você seguiu todas as etapas em nosso artigo Plataforma cruzada usando o sistema do plug-in de SDK de RX do Unity. Veja as seguintes causas prováveis:
- Um dos pacotes necessários está ausente.
- O perfil apropriado não foi definido no objeto MixedRealityToolkit (quando o MRTK está sendo usado).
Quando o aplicativo é criado para o ARM no HoloLens2, ele para na inicialização e o ARM64 funciona normalmente
A correção é desabilitar os Trabalhos de Gráfico em
Project Settings > Player > Other Settings > Graphics Jobs
ou apenas complicar para ARM64.
Esse problema foi corrigido no Unity 2019.4 e no Unity 2020.3.