Compatibilidad de Unity
Este artículo presenta las versiones de Unity compatibles con el complemento EasyAR Sense Unity Plugin y los requisitos de configuración.
Versión de Unity
El complemento EasyAR Sense Unity Plugin es compatible con Unity 2021.3 o versiones posteriores.
El paquete de soporte EasyAR Mega necesario para desarrollar la función Mega es compatible con Unity 2021.3.30 o versiones posteriores.
Consejo
En general, EasyAR no depende de muchas API de Unity cambiantes, por lo que si Unity lanza una nueva versión, generalmente el complemento EasyAR Sense Unity Plugin se puede utilizar normalmente.
El complemento EasyAR Sense Unity Plugin admite la Render Graph URP 17+ de Unity 6 a partir de la versión 4.6.4.
Plataforma de desarrollo
| Sistema operativo | Versión del sistema operativo | Arquitectura de CPU | Notas adicionales |
|---|---|---|---|
| Windows | Versión 7 o superior (7/8.1/10/11) | x86, x86_64 | Las versiones Windows N/KN necesitan instalar el paquete de características multimedia para poder utilizarse. |
| macOS | Versión 11.0 o superior | x86_64, arm64 |
Además, se deben cumplir los requisitos del sistema de desarrollo de Unity de la versión correspondiente.
Plataforma de publicación
| Sistema operativo | Versión del sistema operativo | Arquitectura de CPU | Notas adicionales |
|---|---|---|---|
| Windows | Versión 7 o superior (7/8.1/10/11) | x86, x86_64 | Las versiones Windows N/KN necesitan instalar el paquete de características multimedia para poder utilizarse. No se admite la función de grabación de pantalla de EasyAR. |
| macOS | Versión 11.0 o superior | x86_64, arm64 | No se admite la función de grabación de pantalla de EasyAR. |
| Android | Versión 5.0 o superior | armv7a, arm64-v8a | El soporte para arm64-v8a requiere habilitar IL2CPP. La función de grabación de pantalla de EasyAR solo se admite cuando la API gráfica es OpenGLES2 o OpenGLES3. |
| HarmonyOS (teléfono móvil) | Soporte nativo de 1.0 a 4.x A partir de la versión 5, se admite a través de la capa de compatibilidad de aplicaciones Android1 |
arm64-v8a | |
| iOS | Versión 15.0 o superior | arm64 | La arquitectura debe configurarse como ARM64 y no se admite la configuración como Universal. No se admite la función de grabación de pantalla de EasyAR. |
| visionOS | Versión 2.0 o superior | arm64 | No se admite la función de grabación de pantalla de EasyAR. |
Además, se deben cumplir los requisitos de la plataforma de publicación de Unity de la versión correspondiente:
Notas adicionales de la plataforma macOS
Apple silicon
El complemento EasyAR Sense Unity Plugin admite la ejecución nativa en dispositivos Apple silicon a partir de la versión 4.6.0 y se puede utilizar normalmente en el editor de Unity.
Nota
Debido a un error en el soporte de complementos nativos de Unity, en algunas versiones de Unity, las aplicaciones compiladas para "Apple silicon" o "Intel 64-bit + Apple silicon" pueden no funcionar correctamente. Si se descubre que la aplicación no se puede utilizar en un Mac y se muestra un error similar a "Fail to load EasyAR library" o "DllNotFoundException: EasyAR assembly", se recomienda utilizar una versión más reciente de Unity o solicitar ayuda a Unity y a la comunidad de Unity.
Notas adicionales de la plataforma Android
Soporte para el tamaño de página de memoria de 16 KB en Android
El complemento EasyAR Sense Unity Plugin admite dispositivos con un tamaño de página de memoria de 16 KB a partir de la versión 4000.
Consejo
Esta es una función introducida en Android 15. Para obtener más información sobre esta función, consulte la sección sobre soporte para el tamaño de página de 16 KB en la documentación de Android.
Advertencia de Google Play: libhuawei_arengine_jni.so puede causar que la aplicación se bloquee en dispositivos de 16 KB
En la configuración predeterminada, el complemento EasyAR Sense Unity Plugin utilizará el AR Engine SDK 3.7.0.3 (que incluye libhuawei_arengine_jni.so) en la plataforma Android para admitir el motor AR de Huawei. Dado que esta biblioteca se compiló con una versión temprana del NDK de Android por Huawei, Google Play puede emitir una advertencia, pero esto no tendrá un impacto real.
Su aplicación podría bloquearse en dispositivos de 16 KB
base/lib/arm64-v8a/libhuawei_arengine_jni.so
Acerca del AR Engine SDK:
- La versión 3.7.0.3 se compiló con una versión temprana del NDK de Android por Huawei, lo que es la razón por la cual Google Play emite una advertencia. Consulte la documentación de Google sobre compilar aplicaciones con la versión r27 o anterior del NDK de Android para obtener más detalles.
- La versión 3.7.0.3 admite la carga en dispositivos de Android con un tamaño de página de memoria de 16 KB, lo que es la razón por la cual Google Play no prohíbe la publicación de la aplicación.
- La versión 4.0.0.5 no admite la carga en dispositivos de Android con un tamaño de página de memoria de 16 KB. Esta es la última versión disponible públicamente del AR Engine SDK en el ecosistema de Android, por lo que el complemento EasyAR Sense Unity Plugin sigue utilizando la versión 3.7.0.3.
El uso del AR Engine SDK 3.7.0.3 en el complemento EasyAR Sense Unity Plugin no afecta la publicación de la aplicación en Google Play ni causa bloqueos reales:
- Los dispositivos Huawei no son dispositivos de Android de 16 KB.
- EasyAR Sense utiliza un mecanismo de lista blanca para evitar ejecutar el AR Engine SDK en dispositivos que no son de Huawei.
Cómo manejar esta advertencia:
- Si necesita utilizar la función del motor AR en dispositivos Huawei, se recomienda ignorar esta advertencia.
- Si no necesita admitir dispositivos Huawei o no necesita utilizar la función del motor AR, puede desactivar el AR Engine SDK en la configuración de EasyAR.
Nota
En dispositivos Huawei, incluso si se desactiva el motor AR, otras funciones de EasyAR pueden funcionar normalmente, pero el efecto del seguimiento de movimiento será diferente al del motor AR, y otras funciones que utilizan el seguimiento de movimiento también se verán afectadas.
Notas adicionales de la plataforma HarmonyOS
Sistema HarmonyOS compatible con Android
El complemento EasyAR Sense Unity Plugin admite completamente HarmonyOS 1.0 - 4.x.
HarmonyOS nativo/puro/HarmonyOS NEXT
El complemento EasyAR Sense Unity Plugin admitirá HarmonyOS nativo 5.0+ en un futuro cercano. La versión actual aún no admite HarmonyOS nativo/puro y solo se puede utilizar a través de la capa de compatibilidad de aplicaciones Android.
Consejo
La versión internacional de Unity no admite HarmonyOS nativo. Debe utilizar Tuanjie Engine.
WebGL
El complemento EasyAR Sense Unity Plugin no es compatible con WebGL de Unity.
Consejo
Las funciones desarrolladas directamente utilizando las interfaces de servicios en la nube de EasyAR (por ejemplo, la interfaz de servicio CRS) se pueden publicar en la plataforma web.
API gráfica
El complemento EasyAR Sense Unity Plugin utiliza directamente la tubería de renderizado de Unity, por lo que todas las API gráficas disponibles en Unity son compatibles.
Tubo de renderizado scriptable
El complemento EasyAR Sense Unity Plugin es compatible con la versión 7.0.0 o superior de la Tubo de renderizado universal (URP).
El complemento EasyAR Sense Unity Plugin no es compatible con la Tubo de renderizado de alta definición (HDRP).
Nota
Declaración sobre el soporte de la render graph URP 17+ de Unity 6
EasyAR admite la render graph URP 17+ de Unity 6, pero Unity todavía tiene algunos problemas sin resolver. En caso de encontrar situaciones anómalas, puede probar a utilizar el modo de compatibilidad de URP proporcionado por Unity.
Algunos problemas se han resuelto en la última versión de Unity. Se recomienda utilizar la versión 6.2 o superior.
Los problemas conocidos fuera del modo de compatibilidad incluyen:
[Sin resolver] Cuando se obtiene la textura de la cámara de EasyAR (similar al uso en el ejemplo ImageTracking_Coloring3D y el ejemplo Flujo de trabajo de ARSession (CameraDevice)), se pueden observar fallas visuales y artefactos en dispositivos iOS/Mac. Hemos reproducido este problema en un paquete puro de Unity y lo hemos reportado a Unity: Glitches on iOS with AR Camera Image Rendering (URP 17 render graph). Puede seguir el progreso del problema en la incidencia de Unity UUM-87787 y en los registros de lanzamiento de las futuras versiones de Unity.
Para todas las versiones de Unity 6, se puede utilizar la medida de mitigación parcial, que está habilitada por defecto.
Para la versión 6.2 o superior de Unity, se puede evitar este problema configurando la escala de renderizado en el recurso de la Tubo de renderizado universal en un valor fuera del rango de 0.96 a 1.05.
[Resuelto en Unity 6.2] En Windows DX11, la imagen de la cámara puede hacer que el efecto de renderizado de los objetos en la escena sea impredecible. En las versiones 6.0 - 6.1 de Unity, EasyAR proporciona la opción de bypass y está habilitada por defecto.
-
La versión actual aún no admite la versión nativa de HarmonyOS 5.0.↩