Table of Contents

Compatibilidad con Unity

Este artículo presenta las versiones de Unity y los requisitos de configuración compatibles con EasyAR Sense Unity Plugin.

Versiones de Unity

EasyAR Sense Unity Plugin es compatible con Unity 2021.3 o superior.

El paquete de soporte de EasyAR Mega necesario para desarrollar funciones Mega es compatible con Unity 2021.3.30 o superior.

Consejo

En general, EasyAR no depende de muchas APIs cambiantes de Unity, así que si Unity publica una versión nueva, EasyAR Sense Unity Plugin normalmente seguirá funcionando sin problemas.

EasyAR Sense Unity Plugin admite URP 17+ Render Graph de Unity 6 a partir de la versión 4.6.4.

Plataformas de desarrollo

Sistema operativo Versión del sistema Arquitectura de CPU Nota
Windows 7 o superior (7/8.1/10/11) x86, x86_64 Las versiones Windows N/KN requieren instalar Media Feature Pack
macOS 11.0 o superior x86_64, arm64

Además, debes cumplir los requisitos del sistema de desarrollo de Unity de la versión correspondiente.

Plataformas de publicación

Sistema operativo Versión del sistema Arquitectura de CPU Nota
Windows 7 o superior (7/8.1/10/11) x86, x86_64 Las versiones Windows N/KN requieren instalar Media Feature Pack.
No admite la función de grabación de pantalla de EasyAR.
macOS 11.0 o superior x86_64, arm64 No admite la función de grabación de pantalla de EasyAR.
Android 5.0 o superior armv7a, arm64-v8a El soporte arm64-v8a requiere IL2CPP.
La función de grabación de pantalla de EasyAR solo se admite cuando Graphics API es OpenGLES2 u OpenGLES3.
HarmonyOS (móvil) 1.0 – 4.x soporte nativo
5 o superior mediante la capa de compatibilidad de apps Android1		 arm64-v8a
iOS 15.0 o superior arm64 Architecture debe configurarse como ARM64; no se admite Universal.
No admite la función de grabación de pantalla de EasyAR.
visionOS 2.0 o superior arm64 No admite la función de grabación de pantalla de EasyAR.

Además, debes cumplir los requisitos de plataforma de publicación de Unity para la versión correspondiente:

Notas adicionales para macOS

Apple silicon

EasyAR Sense Unity Plugin admite ejecución nativa en dispositivos Apple silicon desde la versión 4.6.0 y también puede usarse normalmente en el editor de Unity.

Nota

Debido a un error en el soporte de plugins nativos de Unity, en algunas versiones de Unity las aplicaciones construidas para "Apple silicon" o "Intel 64-bit + Apple silicon" pueden no funcionar correctamente. Si la aplicación no funciona en Mac y muestra errores como "Fail to load EasyAR library" o "DllNotFoundException: EasyAR assembly", se recomienda usar una versión más nueva de Unity o pedir ayuda a Unity y a la comunidad de Unity.

Notas adicionales para Android

Soporte de tamaño de página de memoria de 16 KB en Android

EasyAR Sense Unity Plugin admite dispositivos con tamaño de página de memoria de 16 KB desde la versión 4000.

Consejo

Esta función se introdujo en Android 15. Para más información, consulta la documentación de Android sobre soporte de páginas de 16 KB.

Advertencia de Google Play sobre libhuawei_arengine_jni.so que podría hacer que la app se bloquee en dispositivos de 16 KB

Con la configuración predeterminada, EasyAR Sense Unity Plugin usa AR Engine SDK 3.7.0.3 (incluye libhuawei_arengine_jni.so) en Android para dar soporte a Huawei AR Engine. Como esta biblioteca fue compilada por Huawei con una versión antigua del Android NDK, Google Play puede mostrar una advertencia, pero en realidad no causa ningún problema.

alt text

Your app could crash on 16 KB devices

base/lib/arm64-v8a/libhuawei_arengine_jni.so

Sobre AR Engine SDK:

  • La versión 3.7.0.3 fue compilada por Huawei con un Android NDK antiguo, y por eso Google Play muestra la advertencia. Consulta la documentación de Google sobre compilar con Android NDK r27 y versiones anteriores.
  • La versión 3.7.0.3 sí admite carga en dispositivos Android con tamaño de página de memoria de 16 KB, por eso Google Play no prohíbe publicar la app.
  • La versión 4.0.0.5 no admite carga en dispositivos Android con tamaño de página de memoria de 16 KB. Como es la última versión disponible públicamente en el ecosistema Android, EasyAR Sense Unity Plugin sigue usando la versión 3.7.0.3.

Usar AR Engine SDK 3.7.0.3 con EasyAR Sense Unity Plugin no impide publicar la app en Google Play y no causará un bloqueo real:

  • Los dispositivos Huawei no pertenecen a los dispositivos Android de 16 KB.
  • EasyAR Sense usa una lista blanca para evitar ejecutar AR Engine SDK en dispositivos que no son Huawei.

Cómo tratar esta advertencia:

  • Si necesitas usar la función AR Engine en dispositivos Huawei, se recomienda ignorar esta advertencia.

  • Si no necesitas compatibilidad con dispositivos Huawei o puedes prescindir de AR Engine, puedes desactivar AR Engine SDK en Configuración de EasyAR.

    Nota

    En dispositivos Huawei, aunque desactives AR Engine, el resto de funciones de EasyAR seguirá funcionando normalmente, pero el rendimiento del seguimiento de movimiento será diferente al de AR Engine, y también se verán afectadas otras funciones que usan seguimiento de movimiento.

Notas adicionales para HarmonyOS

Sistema Harmony compatible con Android

EasyAR Sense Unity Plugin es totalmente compatible con HarmonyOS 1.0 – 4.x.

HarmonyOS nativo/HarmonyOS puro/HarmonyOS NEXT

EasyAR Sense Unity Plugin admitirá próximamente HarmonyOS nativo 5.0+; la versión actual aún no lo admite y solo puede usarse mediante la capa de compatibilidad de apps Android.

Consejo

La versión internacional de Unity no admite HarmonyOS nativo; debes usar Tuanjie Engine.

WebGL

EasyAR Sense Unity Plugin no admite WebGL de Unity.

Consejo

Las funciones desarrolladas directamente usando interfaces de servicio cloud de EasyAR (por ejemplo, interfaz de servicio CRS) pueden publicarse en la plataforma Web.

Graphics API

EasyAR Sense Unity Plugin usa directamente la render pipeline de Unity, por lo que todas las APIs gráficas disponibles en Unity son compatibles.

Scriptable Render Pipeline

EasyAR Sense Unity Plugin es compatible con Universal Render Pipeline (URP) 7.0.0 o superior.

EasyAR Sense Unity Plugin no es compatible con High Definition Render Pipeline (HDRP).

Nota

Declaración sobre el soporte de render graph de Unity 6 URP 17+

EasyAR admite render graph de Unity 6 URP 17+, pero Unity aún tiene algunos problemas sin resolver. Cuando ocurra algo anómalo, prueba el modo de compatibilidad de URP que ofrece Unity.

Algunos problemas ya se han solucionado en las versiones más recientes de Unity, así que se recomienda usar 6.2 o superior.

Los problemas conocidos en modo no compatible incluyen:

  1. [Sin resolver] Al obtener la textura de la cámara desde EasyAR (como en el ejemplo ImageTracking_Coloring3D y en el ejemplo ARSession workflow (CameraDevice)), en dispositivos iOS/Mac pueden observarse fallos visuales y artefactos. Hemos reproducido el problema en un paquete puro de Unity y se lo hemos reportado a Unity: Glitches on iOS with AR Camera Image Rendering (URP 17 render graph). Puedes seguir el progreso en Unity Issue UUM-87787 y en los registros de versiones futuras de Unity.

    Para todas las versiones de Unity 6, puedes usar medidas parciales de mitigación, activadas por defecto.

    Para Unity 6.2 y versiones posteriores, puedes configurar Render Scale en el Universal Render Pipeline Asset con un valor distinto de 0.96-1.05 para evitar este problema.

  2. [Corregido en Unity 6.2] En Windows DX11, la imagen de la cámara puede hacer que el render de los objetos en la escena sea impredecible. En Unity 6.0 - 6.1, EasyAR ofrece una opción de mitigación y está activada por defecto.

  1. La versión actual aún no admite HarmonyOS nativo/HarmonyOS puro 5.0.↩