Problemas conhecidos em versões e pacotes do Unity
Algumas versões dos plugins Unity ou Unity contêm incompatibilidades conhecidas que impedem que os aplicativos funcionem conforme o esperado em dispositivos HoloLens 2 ou Windows Mixed Reality. Embora geralmente suportemos todas as versões LTS (Long Term Support) do Unity e seus plug-ins verificados, recomendamos evitar essas compilações específicas de plug-ins Unity e Unity para garantir que seus aplicativos funcionem conforme o esperado.
Recomendamos que você use a versão mais recente do patch do 2022.3 LTS e sua versão recomendada dos plug-ins Unity, juntamente com o mais recente plugin OpenXR de realidade mista.
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 | Mitigação |
|---|---|---|---|
| Os aplicativos HL2 que usam DirectX 12 no Unity apresentam pior desempenho de renderização do que os aplicativos que usam DirectX 11. O padrão do Unity 6 é o DirectX 12, causando uma degradação inesperada do desempenho. | Investigando: 2024/05/23 |
Unity 2021.3.0f1 para Unity 6000.*.* com DirectX 12 |
Evite usar o DirectX 12. No Unity, vá para Configurações do > Projeto Player > Outras Configurações > Desmarque a API > de Gráficos Automáticos Adicionar Direct3D11 > Remover Direct3D12 |
| Um aplicativo HL2 importando MRTK3 e Â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ê pode ver uma mensagem de aviso informando que o ARSubsystems foi preterido, mas essa mensagem pode ser ignorada. |
Problemas de bloqueio resolvidos
| Problemas de bloqueio | Status & Última Atualização | Versões com problema | Versões com correções |
|---|---|---|---|
| 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. | Em Pré-visualização: 2024/05/01 |
Unidade 2022.*.* com URP 13.*.* |
Evite URP no Unity 2022, evite usar os materiais URP padrão ou use URP no Unity 2021.3.14+. O problema foi resolvido no Unity 6 Preview. |
| Não é possível criar pacotes de aplicativos UWP (APPX ou MSIX) no Unity 2021 e 2022 | Consertado: 2023/10/03 |
Reprodutível com: 2021.3.30f1, 2022.3.8f1 | Use o Unity 2021.3.31f1+, o Unity 2022.3.13f1+ ou adicione manualmente um manifesto APPX ao projeto do Visual Studio do aplicativo. Para obter mais informações, consulte o fórum do Unity e o Issue Tracker do Unity. |
| 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 |
Usar o Visual Studio 2019 ou a versão >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 |
Unidade 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 que usa 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 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 |