Table of Contents

Compatibilidade com unity

Este artigo descreve a compatibilidade do EasyAR Sense Unity Plugin com versões e requisitos de configuração do Unity.

Versões do unity

O EasyAR Sense Unity Plugin suporta Unity 2021.3 ou superior.

O EasyAR Mega Studio, necessário para desenvolver funcionalidades Mega, suporta Unity 2021.3.30 ou superior.

Dica

Geralmente, o EasyAR não depende de muitas APIs do Unity que mudam frequentemente. Portanto, se o Unity lançar uma nova versão, o EasyAR Sense Unity Plugin geralmente funcionará normalmente.

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

Plataformas de desenvolvimento

Sistema operacional Versão do SO Arquitetura da CPU Notas adicionais
Windows 7 ou superior (7/8.1/10/11) x86, x86_64 Versões Windows N/KN requerem Media Feature Pack instalado para funcionar
macOS 10.15 ou superior x86_64, arm64

Além disso, devem ser atendidos os requisitos do sistema de desenvolvimento do Unity correspondentes à versão utilizada.

Plataformas de publicação

Sistema operacional Versão do SO Arquitetura da CPU Notas adicionais
Windows 7 ou superior (7/8.1/10/11) x86, x86_64 Versões Windows N/KN requerem Media Feature Pack instalado para funcionar
macOS 10.15 ou superior x86_64, arm64
Android 5.0 ou superior armv7a, arm64-v8a Suporte a arm64-v8a requer IL2CPP ativado
HarmonyOS (dispositivos móveis) Suporte nativo para 1.0 – 4.x
Suporte via camada de compatibilidade Android para 5 ou superior
arm64-v8a
iOS 12.0 ou superior arm64 A arquitetura deve ser configurada como ARM64; não suporta Universal
visionOS 2.0 ou superior arm64

Além disso, devem ser atendidos os requisitos da plataforma de publicação do Unity correspondentes à versão:

Notas especiais:

  • Sobre Mac Apple silicon:

    O EasyAR Sense Unity Plugin suporta execução nativa em dispositivos Apple silicon e funciona normalmente no Editor do Unity.

    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 recente do Unity ou buscar ajuda na comunidade do Unity.

  • Sobre suporte a tamanho de página de memória de 16 KB no Android:

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

    Este é um recurso introduzido no Android 15. Para mais informações, consulte a documentação do Android sobre suporte a tamanho de página de 16 KB.

  • Sobre WebGL:

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

    Funcionalidades desenvolvidas usando diretamente as interfaces de serviço em nuvem do EasyAR (como a interface de serviço CRS) podem ser publicadas na plataforma Web.

  • Sobre a funcionalidade de gravação de tela:

    A funcionalidade de gravação de tela é suportada apenas na plataforma Android e requer a configuração da Graphics API como OpenGLES2 ou OpenGLES3.

Graphics api

O EasyAR Sense Unity Plugin utiliza diretamente o pipeline de renderização do Unity. Todas as APIs gráficas suportadas pelo Unity são compatíveis.

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 URP 17+ do Unity 6

O EasyAR suporta o render graph URP 17+ do Unity 6, mas o próprio Unity ainda tem alguns problemas não resolvidos. Em situações anômalas, pode-se tentar usar o modo de compatibilidade URP fornecido pelo Unity.

Alguns problemas já foram resolvidos nas versões mais recentes do Unity; recomenda-se o uso da versão 6.2 ou superior.

Problemas conhecidos no modo não compatível incluem:

  1. [Não resolvido] Ao obter texturas de câmera do EasyAR (como no exemplo ImageTracking_Coloring3D e no exemplo de fluxo de trabalho do ARSession (CameraDevice)), em dispositivos iOS/Mac podem ser observadas falhas visuais e artefatos. Reproduzimos o problema em um pacote Unity puro e reportamos ao Unity: Glitches on iOS with AR Camera Image Rendering (URP 17 render graph). O progresso pode ser acompanhado na atualização do Unity Issue UUM-87787 e nos logs de lançamento de versões futuras do Unity.

    Para todas as versões do Unity 6, pode-se usar uma mitigação parcial, habilitada por padrão.

    Para o Unity 6.2 ou superior, pode-se evitar o problema configurando o Render Scale no Universal Render Pipeline Asset para um valor fora do intervalo 0.96-1.05.

  2. [Corrigido no Unity 6.2] No Windows DX11, o feed da câmera causava efeitos de renderização imprevisíveis nos objetos da cena. Nas versões Unity 6.0 - 6.1, o EasyAR fornecia uma opção de mitigação, habilitada por padrão.