Table of Contents

Compatibilidade do Unity

Este artigo apresenta as versões do Unity compatíveis com o EasyAR Sense Unity Plugin e os requisitos de configuração.

Versão do Unity

O EasyAR Sense Unity Plugin suporta Unity 2021.3 ou versões posteriores.

O pacote de suporte EasyAR Mega necessário para desenvolver recursos do Mega suporta Unity 2021.3.30 ou versões posteriores.

Dica

Normalmente, o EasyAR não depende de muitas APIs do Unity que mudam, então se o Unity lançar uma nova versão, o EasyAR Sense Unity Plugin geralmente pode ser usado normalmente.

O EasyAR Sense Unity Plugin começa a suportar o URP 17+ Render Graph do Unity 6 a partir da versão 4.6.4.

Plataforma de desenvolvimento

Sistema operacional Versão do sistema operacional Arquitetura da CPU Observações adicionais
Windows Versões 7 ou posteriores (7/8.1/10/11) x86, x86_64 As versões Windows N/KN precisam instalar o Pacote de recursos de mídia para serem usadas.
macOS Versões 11.0 ou posteriores x86_64, arm64

Além disso, é necessário atender aos requisitos do sistema de desenvolvimento do Unity da versão correspondente.

Plataforma de publicação

Sistema operacional Versão do sistema operacional Arquitetura da CPU Observações adicionais
Windows Versões 7 ou posteriores (7/8.1/10/11) x86, x86_64 As versões Windows N/KN precisam instalar o Pacote de recursos de mídia para serem usadas.
Não suporta a função de gravação de tela do EasyAR.
macOS Versões 11.0 ou posteriores x86_64, arm64 Não suporta a função de gravação de tela do EasyAR.
Android Versões 5.0 ou posteriores armv7a, arm64-v8a O suporte para arm64-v8a requer a ativação do IL2CPP.
A função de gravação de tela do EasyAR só pode ser usada quando a API gráfica for OpenGLES2 ou OpenGLES3.
HarmonyOS (dispositivos móveis) Suporte nativo da 1.0 – 4.x
A partir da versão 5, é suportado através da camada de compatibilidade de aplicativos Android1		 arm64-v8a
iOS Versões 15.0 ou posteriores arm64 A arquitetura deve ser configurada como ARM64. Não é suportado configurá-la como Universal.
Não suporta a função de gravação de tela do EasyAR.
visionOS Versões 2.0 ou posteriores arm64 Não suporta a função de gravação de tela do EasyAR.

Além disso, é necessário atender aos requisitos da plataforma de publicação do Unity da versão correspondente:

Observações adicionais para a plataforma macOS

Apple silicon

O EasyAR Sense Unity Plugin começa a suportar a execução nativa em dispositivos Apple silicon a partir da versão 4.6.0 e pode ser usado normalmente no editor do Unity.

Nota

Devido a um bug no suporte a plug-ins nativos do Unity, em algumas versões do Unity, aplicativos compilados para "Apple silicon" ou "Intel 64-bit + Apple silicon" podem não funcionar corretamente. Se você descobrir que o aplicativo não funciona no Mac e exibe erros semelhantes a "Fail to load EasyAR library" ou "DllNotFoundException: EasyAR assembly", é recomendável usar uma versão mais recente do Unity ou buscar ajuda na comunidade do Unity.

Observações adicionais para a plataforma Android

Suporte ao tamanho da página de memória de 16 KB do Android

O EasyAR Sense Unity Plugin começa a suportar dispositivos com tamanho de página de memória de 16 KB a partir da versão 4000.

Dica

Esta é uma função introduzida no Android 15. Para obter mais informações sobre esta função, consulte o conteúdo sobre suporte ao tamanho da página de 16 KB na documentação do Android.

Aviso do Google Play: libhuawei_arengine_jni.so pode causar o travamento do aplicativo em dispositivos de 16 KB

Na configuração padrão, o EasyAR Sense Unity Plugin usará o AR Engine SDK 3.7.0.3 (que contém libhuawei_arengine_jni.so) na plataforma Android para suportar o Huawei AR Engine. Como esta biblioteca foi compilada pela Huawei usando um Android NDK antigo, o Google Play pode emitir um aviso, mas isso não terá efeito real.

alt text

Seu aplicativo pode travar em dispositivos de 16 KB

base/lib/arm64-v8a/libhuawei_arengine_jni.so

Sobre o AR Engine SDK:

  • A versão 3.7.0.3 foi compilada pela Huawei usando um Android NDK antigo, o que é a razão para o aviso do Google Play. Consulte a explicação sobre compilar aplicativos com o Android NDK r27 ou versões anteriores na documentação do Google para obter mais detalhes.
  • A versão 3.7.0.3 suporta a carga em dispositivos Android com tamanho de página de memória de 16 KB, o que também é a razão pela qual o Google Play não proíbe a publicação do aplicativo.
  • A versão 4.0.0.5 não suporta a carga em dispositivos Android com tamanho de página de memória de 16 KB. Esta é a versão mais recente do AR Engine SDK disponível publicamente no ecossistema Android, portanto, o EasyAR Sense Unity Plugin ainda usa a versão 3.7.0.3.

O uso do AR Engine SDK 3.7.0.3 pelo EasyAR Sense Unity Plugin não afeta a publicação do aplicativo no Google Play e não causará travamentos reais:

  • Todos os dispositivos Huawei não são dispositivos Android de 16 KB.
  • O EasyAR Sense usa um mecanismo de lista branca para evitar a execução do AR Engine SDK em dispositivos não Huawei.

Como lidar com esse aviso:

  • Se você precisar usar os recursos do AR Engine em dispositivos Huawei, é recomendável ignorar o aviso.

  • Se você não precisar suportar dispositivos Huawei ou não precisar usar os recursos do AR Engine, pode desativar o AR Engine SDK nas Configurações do EasyAR.

    Nota

    Em dispositivos Huawei, mesmo se o AR Engine for desativado, outros recursos do EasyAR ainda podem funcionar normalmente, mas o efeito do rastreamento de movimento será diferente do do AR Engine, e outros recursos que usam o rastreamento de movimento também serão afetados.

Observações adicionais para a plataforma HarmonyOS

Sistema HarmonyOS compatível com o Android

O EasyAR Sense Unity Plugin suporta completamente o HarmonyOS 1.0 – 4.x.

HarmonyOS nativo/puro/HarmonyOS NEXT

O EasyAR Sense Unity Plugin suportará o HarmonyOS nativo 5.0+ em breve. A versão atual ainda não suporta o HarmonyOS nativo/puro e só pode ser usada através da camada de compatibilidade de aplicativos Android.

Dica

A versão internacional do Unity não suporta o HarmonyOS nativo. É necessário usar o Unity Tuanjie.

WebGL

O EasyAR Sense Unity Plugin não suporta o WebGL do Unity.

Dica

Recursos desenvolvidos diretamente usando as interfaces do serviço em nuvem do EasyAR (por exemplo, Interface do serviço CRS) podem ser publicados na plataforma Web.

API Gráfica

O EasyAR Sense Unity Plugin usa diretamente o pipeline de renderização do Unity, portanto, todas as APIs gráficas que podem ser usadas no Unity são suportadas.

Scriptable Render Pipeline

O EasyAR Sense Unity Plugin suporta a Universal Render Pipeline (URP) 7.0.0 ou versões posteriores.

O EasyAR Sense Unity Plugin não suporta a High Definition Render Pipeline (HDRP).

Nota

Declaração sobre o suporte ao render graph do URP 17+ do Unity 6

O EasyAR suporta o render graph do URP 17+ do Unity 6, mas ainda existem alguns problemas não resolvidos no próprio Unity. Em casos de exceção, você pode tentar usar o modo de compatibilidade do URP fornecido pelo Unity.

Alguns problemas foram resolvidos na versão mais recente do Unity. É recomendável usar a versão 6.2 ou posterior.

Problemas conhecidos fora do modo de compatibilidade incluem:

  1. [Não resolvido] Quando se obtém a textura da câmera do EasyAR (semelhante ao uso no exemplo ImageTracking_Coloring3D e no exemplo Fluxo de trabalho da ARSession (CameraDevice)), podem ser observados defeitos visuais e artefatos em dispositivos iOS/Mac. Já reproduzimos esse problema em um pacote puro do Unity e relatamos ao Unity: Glitches on iOS with AR Camera Image Rendering (URP 17 render graph). Você pode acompanhar o progresso do problema nas atualizações do Problema do Unity UUM-87787 e nas notas de versão futuras do Unity.

    Para todas as versões do Unity 6, pode-se usar a medida de alívio parcial, que está ativada por padrão.

    Para a versão 6.2 ou posterior do Unity, pode-se definir a escala de renderização no ativo da Universal Render Pipeline para um valor fora do intervalo de 0.96 - 1.05 para evitar esse problema.

  2. [Corrigido no Unity 6.2] A imagem da câmera no Windows DX11 pode fazer com que o efeito de renderização dos objetos na cena seja imprevisível. Nas versões 6.0 - 6.1 do Unity, o EasyAR oferece a opção de contorno, que está ativada por padrão.

  1. A versão atual ainda não suporta o HarmonyOS nativo/puro 5.0.↩