Table of Contents

Compatibilidade com Unity

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

Versões do Unity

O EasyAR Sense Unity Plugin é compatível com Unity 2021.3 ou superior.

O pacote de suporte EasyAR Mega necessário para desenvolver recursos Mega é compatível com Unity 2021.3.30 ou superior.

Dica

Em geral, o EasyAR não depende de muitas APIs do Unity que mudam com frequência, então se o Unity lançar uma nova versão, o EasyAR Sense Unity Plugin normalmente ainda funcionará sem problemas.

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

Plataformas de desenvolvimento

Sistema operacional Versão do SO Arquitetura de CPU Observação
Windows 7 ou superior (7/8.1/10/11) x86, x86_64 As versões Windows N/KN precisam instalar o Media Feature Pack
macOS 11.0 ou superior x86_64, arm64

Além disso, você precisa atender aos requisitos do sistema de desenvolvimento do Unity para a versão correspondente.

Plataformas de lançamento

Sistema operacional Versão do SO Arquitetura de CPU Observação
Windows 7 ou superior (7/8.1/10/11) x86, x86_64 As versões Windows N/KN precisam instalar o Media Feature Pack.
O recurso de gravação de tela do EasyAR não é suportado.
macOS 11.0 ou superior x86_64, arm64 O recurso de gravação de tela do EasyAR não é suportado.
Android 5.0 ou superior armv7a, arm64-v8a O suporte a arm64-v8a requer IL2CPP.
O recurso de gravação de tela do EasyAR só é suportado quando o Graphics API é OpenGLES2 ou OpenGLES3.
HarmonyOS (celular) 1.0 – 4.x suporte nativo
5 ou superior via camada de compatibilidade de apps Android1		 arm64-v8a
iOS 15.0 ou superior arm64 A Architecture deve ser configurada como ARM64; Universal não é suportado.
O recurso de gravação de tela do EasyAR não é suportado.
visionOS 2.0 ou superior arm64 O recurso de gravação de tela do EasyAR não é suportado.

Além disso, você precisa atender aos requisitos de plataforma de lançamento do Unity para a versão correspondente:

Observações adicionais para macOS

Apple silicon

O EasyAR Sense Unity Plugin suporta execução nativa em dispositivos Apple silicon a partir da versão 4.6.0 e também pode ser usado normalmente no Unity Editor.

Nota

Devido a um bug no suporte a plugins nativos do Unity, em algumas versões do Unity, aplicativos construídos para "Apple silicon" ou "Intel 64-bit + Apple silicon" podem não funcionar corretamente. Se o aplicativo não funcionar no Mac e exibir erros como "Fail to load EasyAR library" ou "DllNotFoundException: EasyAR assembly", recomenda-se usar uma versão mais nova do Unity ou pedir ajuda ao Unity e à comunidade do Unity.

Observações adicionais para Android

Suporte a páginas de memória de 16 KB no Android

O EasyAR Sense Unity Plugin suporta dispositivos com páginas de memória de 16 KB a partir da versão 4000.

Dica

Esse recurso foi introduzido no Android 15. Para mais informações, consulte a documentação do Android sobre suporte a páginas de 16 KB.

Aviso do Google Play sobre libhuawei_arengine_jni.so que pode fazer o app travar em dispositivos de 16 KB

Com a configuração padrão, o EasyAR Sense Unity Plugin usa AR Engine SDK 3.7.0.3 (inclui libhuawei_arengine_jni.so) no Android para dar suporte ao Huawei AR Engine. Como essa biblioteca foi compilada pela Huawei com um Android NDK antigo, o Google Play pode exibir um aviso, mas isso não causa problema real.

alt text

Your app could crash on 16 KB devices

base/lib/arm64-v8a/libhuawei_arengine_jni.so

Sobre o AR Engine SDK:

  • A versão 3.7.0.3 foi compilada pela Huawei com um Android NDK antigo, e é por isso que o Google Play exibe o aviso. Veja a documentação do Google sobre compilar com Android NDK r27 e anteriores.
  • A versão 3.7.0.3 suporta carregamento em dispositivos Android com páginas de memória de 16 KB, e é por isso que o Google Play não proíbe a publicação do app.
  • A versão 4.0.0.5 não suporta carregamento em dispositivos Android com páginas de memória de 16 KB. Como é a última versão disponível publicamente no ecossistema Android, o EasyAR Sense Unity Plugin continua usando a versão 3.7.0.3.

Usar o AR Engine SDK 3.7.0.3 com o EasyAR Sense Unity Plugin não impede a publicação no Google Play e não causa travamento real:

  • Dispositivos Huawei não fazem parte dos dispositivos Android de 16 KB.
  • O EasyAR Sense usa uma lista branca para evitar executar o AR Engine SDK em dispositivos que não são Huawei.

Como lidar com esse aviso:

  • Se você precisar usar o recurso AR Engine em dispositivos Huawei, recomenda-se ignorar esse aviso.

  • Se você não precisar dar suporte a dispositivos Huawei ou puder dispensar o AR Engine, pode desativar o AR Engine SDK em Configuração EasyAR.

    Nota

    Em dispositivos Huawei, mesmo com o AR Engine desativado, os outros recursos do EasyAR continuam funcionando normalmente, mas o resultado do rastreamento de movimento será diferente do AR Engine, e outros recursos que usam rastreamento de movimento também serão afetados.

Observações adicionais para HarmonyOS

Sistema Harmony compatível com Android

O EasyAR Sense Unity Plugin dá suporte completo ao HarmonyOS 1.0 – 4.x.

HarmonyOS nativo / HarmonyOS puro / HarmonyOS NEXT

O EasyAR Sense Unity Plugin em breve suportará HarmonyOS nativo 5.0+; a versão atual ainda não suporta e só pode ser usada pela camada de compatibilidade de apps Android.

Dica

A versão internacional do Unity não suporta HarmonyOS nativo; você precisa usar Tuanjie Engine.

WebGL

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

Dica

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

Graphics API

O EasyAR Sense Unity Plugin usa diretamente o pipeline de renderização do Unity, então todas as Graphics APIs disponíveis no Unity são suportadas.

Scriptable Render Pipeline

O EasyAR Sense Unity Plugin suporta Universal Render Pipeline (URP) 7.0.0 ou superior.

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

Nota

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

O EasyAR suporta o render graph do Unity 6 URP 17+, mas o próprio Unity ainda tem alguns problemas não resolvidos. Quando ocorrer algo anormal, tente o modo de compatibilidade URP fornecido pelo Unity.

Alguns problemas já foram corrigidos nas versões mais recentes do Unity, então é recomendado usar 6.2 ou superior.

Os problemas conhecidos no modo não compatível incluem:

  1. [Não resolvido] Ao obter a textura da câmera a partir do EasyAR (como no exemplo ImageTracking_Coloring3D e no exemplo ARSession workflow (CameraDevice)), em dispositivos iOS/Mac podem ser observados falhas visuais e artefatos. Já reproduzimos o problema em um package puro do Unity e o reportamos à Unity: Glitches on iOS with AR Camera Image Rendering (URP 17 render graph). Você pode acompanhar o progresso no Unity Issue UUM-87787 e nos futuros changelogs do Unity.

    Para todas as versões do Unity 6, você pode usar medidas parciais de mitigação, ativadas por padrão.

    Para Unity 6.2 e versões posteriores, você pode definir o Render Scale no Universal Render Pipeline Asset para um valor diferente de 0.96-1.05 para evitar o problema.

  2. [Corrigido no Unity 6.2] No Windows DX11, a imagem da câmera pode tornar o resultado de renderização dos objetos da cena imprevisível. No Unity 6.0 - 6.1, o EasyAR oferece uma opção de mitigação ativada por padrão.

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