Problemas conhecidos em versões e pacotes do Unity
Algumas versões ou plug-ins do Unity têm incompatibilidades conhecidas que impedem que os aplicativos funcionem conforme o esperado em dispositivos HoloLens 2 ou Windows Mixed Reality. Embora geralmente haja suporte a todas as versões LTS do Unity e os respectivos plug-ins verificados, recomendamos evitar esses builds específicos do Unity e de plug-ins do Unity para garantir que seus aplicativos funcionem conforme o esperado.
Recomendamos que você use a versão de patch mais recente do 2021.3 LTS e a versão recomendada dos plug-ins do Unity, juntamente com a versão mais recente Realidade Misturada plug-in OpenXR.
Ao usar uma versão de patch anterior do Unity, confira a tabela de problemas de bloqueio conhecidos para evitar compilações com outros problemas de bloqueio.
Problemas de bloqueio ativos
| Problemas de bloqueio | Status & Última Atualização | Versões com problema | Atenuação |
|---|---|---|---|
| O aplicativo HL2 usando URP tem pior desempenho de renderização no Unity 2022 em comparação com o Unity 2021 ao usar o material padrão do URP Lit. | Investigando: 04/01/2023 |
Unity 2022.*.* com URP 13.*.* |
Evite o URP no Unity 2022, evite usar os materiais de URP padrão ou use URP no Unity 2021.3.14+ |
| Não é possível criar pacotes de aplicativos UWP (APPX ou MSIX) no Unity 2021 e 2022 | Em andamento: 2023/09/29 |
Reproduzível com: 2021.3.30f1, 2022.3.8f1 | Use o Unity 2021.3.27 ou anterior. Ou adicione manualmente o Manifesto appx ao projeto VS do aplicativo. Consulte o fórum do Unity e o Rastreador de Problemas do Unity para obter mais detalhes. |
| Um aplicativo HL2 que importa o MRTK3 e as Âncoras Espaciais do Azure pode apresentar erros "Guid para conflitos de ativos com" quando a versão do pacote ARFoundation não corresponde à versão importada do ARSubsystems. | Ao usar o ARFoundation 5.x+, adicione manualmente com.unity.xr.arsubsystems versão 5.0.2 ao Gerenciador de Pacotes do projeto. Você receberá um aviso de que o ARSubsystems foi preterido, mas ele pode ser ignorado. |
Problemas de bloqueio resolvidos
| Problemas de bloqueio | Status & Última Atualização | Versões com problema | Versões com correções |
|---|---|---|---|
| O aplicativo HL2 falha quando mãos são detectadas. | Consertado: 24/03/2023 |
Unity 2022, Unity 2021, Unity 2020 com com.unity.inputsystem 1.5.0 |
Usar com.unity.inputsystem 1.5.1 ou posterior |
| O aplicativo HL2 usando URP tem um desempenho de renderização inferior no Unity 2021 em comparação com o Unity 2020. | Consertado: 13/01/2023 |
Unity versão < 2021.3.14f1 com URP 12.*.* |
Usar o Unity 2021.3.14f1 e posterior |
| A compilação do aplicativo por meio de IL2CPP no Unity falha devido a erros de compilação. Para obter mais informações sobre a causa raiz, consulte a discussão aqui. | Consertado: 10/11/2022 |
Visual Studio 2022 versão 17.4+ com Unity versões< 2020.3.42f1, 2021.3.14f1, 2022.1.23f1, 2022.2.0b16 e 2023.1.0a19 |
Use o Visual Studio 2019 ou a versão do Unity > = 2020.3.42f1, 2021.3.14f1, 2022.1.23f1, 2022.2.0b16 ou 2023.1.0a19 |
| O aplicativo remoto Holographic App Remoting que usa o plug-in OpenXR do Unity 1.5.1 falha ao se conectar com o player remoto se o PC host não tem outros headsets de VR anexados. | Consertado: 04/10/2022 |
Unity 2020 ou Unity 2021 com o plug-in OpenXR do Unity = 1.5.0, 1.5.1 e 1.5.2 |
Se estiver usando o Holographic App Remoting, use o plug-in OpenXR do Unity <= 1.4.3 ou >= 1.5.3 |
| Os aplicativos ARM32 UWP Unity criados no modo de versão usando o Visual Studio 2022 apresentarão um erro interno do compilador no Visual Studio. | Consertado: 09/08/2022 |
Visual Studio 2022 versão 17.1.1+ |
Use o Visual Studio 2019 ou o Visual Studio 2022 versão >= 17.3.* |
| O aplicativo HL2 usando URP, o plug-in WindowsXR e renderização de espaço de cor gama tem um desempenho de renderização inferior no Unity 2020 ou posterior. | Consertado: 15/06/2022 |
Unity 2020.*.* com URP 10.*.* e Plug-in Windows XR <=4.6.3 |
Use o Plug-in Windows XR versão >= 4.6.4 |
| O aplicativo HL2 usando o pacote Burst do Unity (por exemplo, comumente usado ao usar URP) atingirá o erro de compilação ILCPP no VisualStudio. | Consertado: 06/06/2022 |
Pacote do Unity Burst 1.6.5, 1.7.0 ou 1.7.1 |
Use o pacote do Unity Burst 1.6.6 ou 1.7.2 ou versões posteriores. |
| O aplicativo com tela inicial padrão mostrará quatro pontos de rotação ao iniciar no HL2 ou depois que o aplicativo for suspenso e retomado. | Consertado: 20/05/2022 |
Unity 2020.3.32-34f1 , Unity 2021.2.17~19f1 e Unity 2021.3.0~3f1 | Use o Unity 2020.3.35f1 ou Unity 2021.3.4f1 ou posterior |
| O aplicativo HL2 exibe uma imagem muito tremida. | Consertado: 02/12/2021 |
Unity 2020.3.21f1 para Unity 2020.3.23f1 |
Usar o Unity 2020.3.24f1 e posterior |
| O back-end do OpenXR com URP pode ficar em deadlock no HL2. | Consertado: 13/05/2021 |
Unity 2020.3.0f1 para Unity 2020.3.7f1 |
Usar o Unity 2020.3.8f1 e posterior |