Table of Contents

Compatibilité Unity

Cet article présente les versions de Unity compatibles avec le plug - in Unity EasyAR Sense et les exigences de configuration.

Version de Unity

Le plug - in Unity EasyAR Sense prend en charge Unity 2021.3 ou une version ultérieure.

Le pack de prise en charge EasyAR Mega requis pour développer les fonctionnalités Mega prend en charge Unity 2021.3.30 ou une version ultérieure.

Astuce

En général, EasyAR ne dépend pas de nombreuses API Unity changeantes. Donc, si une nouvelle version de Unity est publiée, le plug - in Unity EasyAR Sense peut généralement être utilisé normalement.

Le plug - in Unity EasyAR Sense prend en charge le Render Graph URP 17+ de Unity 6 depuis la version 4.6.4.

Plateforme de développement

Système d'exploitation Version du système d'exploitation Architecture CPU Remarques supplémentaires
Windows Version 7 et supérieure (7/8.1/10/11) x86, x86_64 Les versions Windows N/KN doivent installer le Media Feature Pack pour être utilisées.
macOS Version 11.0 et supérieure x86_64, arm64

De plus, les exigences du système de développement Unity de la version correspondante doivent être satisfaites.

Plateforme de publication

Système d'exploitation Version du système d'exploitation Architecture CPU Remarques supplémentaires
Windows Version 7 et supérieure (7/8.1/10/11) x86, x86_64 Les versions Windows N/KN doivent installer le Media Feature Pack pour être utilisées.
La fonction d'enregistrement d'écran EasyAR n'est pas prise en charge.
macOS Version 11.0 et supérieure x86_64, arm64 La fonction d'enregistrement d'écran EasyAR n'est pas prise en charge.
Android Version 5.0 et supérieure armv7a, arm64 - v8a La prise en charge de l'arm64 - v8a nécessite l'activation d'IL2CPP.
La fonction d'enregistrement d'écran EasyAR ne peut être utilisée que lorsque l'API graphique est OpenGLES2 ou OpenGLES3.
HarmonyOS (appareil mobile) Prise en charge native de 1.0 – 4.x
Prise en charge via la couche de compatibilité d'applications Android pour les versions 5 et supérieures1		 arm64 - v8a
iOS Version 15.0 et supérieure arm64 L'architecture doit être configurée en ARM64. La configuration en Universal n'est pas prise en charge.
La fonction d'enregistrement d'écran EasyAR n'est pas prise en charge.
visionOS Version 2.0 et supérieure arm64 La fonction d'enregistrement d'écran EasyAR n'est pas prise en charge.

De plus, les exigences de la plateforme de publication de la version correspondante de Unity doivent être satisfaites :

Remarques supplémentaires pour la plateforme macOS

Apple silicon

Le plug - in Unity EasyAR Sense prend en charge l'exécution native sur les appareils Apple silicon depuis la version 4.6.0 et peut être utilisé normalement dans l'éditeur Unity.

Note

En raison des bogues de prise en charge des plug - ins natifs par Unity, dans certaines versions de Unity, les applications créées pour "Apple silicon" ou "Intel 64 - bit + Apple silicon" peuvent ne pas fonctionner correctement. Si vous constatez que l'application ne fonctionne pas sur Mac et affiche des erreurs telles que "Fail to load EasyAR library" ou "DllNotFoundException: EasyAR assembly", il est recommandé d'utiliser une nouvelle version de Unity ou de demander de l'aide à Unity et à la communauté Unity.

Remarques supplémentaires pour la plateforme Android

Prise en charge de la taille de page mémoire de 16 KB sur Android

Le plug - in Unity EasyAR Sense prend en charge les appareils ayant une taille de page mémoire de 16 KB depuis la version 4000.

Astuce

Il s'agit d'une fonction introduite dans Android 15. Pour plus d'informations sur cette fonction, veuillez consulter la section sur la prise en charge de la taille de page de 16 KB dans la documentation Android.

Avertissement Google Play concernant libhuawei_arengine_jni.so qui pourrait entraîner le plantage de l'application sur les appareils de 16 KB

Dans la configuration par défaut, le plug - in Unity EasyAR Sense utilise le AR Engine SDK 3.7.0.3 (contenant libhuawei_arengine_jni.so) sur la plateforme Android pour prendre en charge le Huawei AR Engine. Comme cette bibliothèque a été compilée par Huawei avec un ancien NDK Android, Google Play peut émettre un avertissement, mais cela n'a pas d'impact réel.

alt text

Your app could crash on 16 KB devices

base/lib/arm64 - v8a/libhuawei_arengine_jni.so

À propos de l'AR Engine SDK :

  • La version 3.7.0.3 a été compilée par Huawei avec un ancien NDK Android, d'où l'avertissement de Google Play. Voir la documentation Google sur la compilation d'applications avec Android NDK r27 et les versions inférieures.
  • La version 3.7.0.3 prend en charge le chargement sur les appareils Android avec une taille de page mémoire de 16 KB, d'où le fait que Google Play n'interdit pas la publication de l'application.
  • La version 4.0.0.5 ne prend pas en charge le chargement sur les appareils Android avec une taille de page mémoire de 16 KB. C'est la version la plus récente disponible publiquement de l'AR Engine SDK dans l'écosystème Android. C'est pourquoi le plug - in Unity EasyAR Sense utilise toujours la version 3.7.0.3.

L'utilisation de l'AR Engine SDK 3.7.0.3 par le plug - in Unity EasyAR Sense n'affecte pas la mise en ligne de l'application sur Google Play et ne cause pas de plantage réel :

  • Les appareils Huawei n'appartiennent pas aux appareils Android de 16 KB.
  • EasyAR Sense utilise un mécanisme de liste blanche pour éviter d'exécuter l'AR Engine SDK sur les appareils non - Huawei.

Comment traiter cet avertissement :

  • Si vous avez besoin d'utiliser les fonctionnalités de l'AR Engine sur les appareils Huawei, il est recommandé d'ignorer cet avertissement.
  • Si vous n'avez pas besoin de prendre en charge les appareils Huawei ou que vous pouvez ne pas utiliser les fonctionnalités de l'AR Engine, vous pouvez désactiver l'AR Engine SDK dans la configuration EasyAR.
Note

Sur les appareils Huawei, même si l'AR Engine est désactivé, les autres fonctionnalités d'EasyAR peuvent fonctionner normalement, mais l'effet de suivi du mouvement diffèrera de celui de l'AR Engine. Les autres fonctionnalités utilisant le suivi du mouvement seront également affectées.

Remarques supplémentaires pour la plateforme HarmonyOS

Système HarmonyOS compatible avec Android

Le plug - in Unity EasyAR Sense prend pleinement en charge HarmonyOS 1.0 – 4.x.

HarmonyOS natif/pur/HarmonyOS NEXT

Le plug - in Unity EasyAR Sense prendra en charge HarmonyOS natif 5.0+ bientôt. La version actuelle ne prend pas en charge HarmonyOS natif/pur et ne peut être utilisée que via la couche de compatibilité d'applications Android.

Astuce

L'édition internationale de Unity ne prend pas en charge HarmonyOS natif. Vous devez utiliser Tuanjie Engine.

WebGL

Le plug - in Unity EasyAR Sense ne prend pas en charge le WebGL de Unity.

Astuce

Les fonctionnalités développées en utilisant directement les interfaces de service cloud EasyAR (par exemple, l'interface de service CRS) peuvent être publiées sur la plateforme Web.

API graphique

Le plug - in Unity EasyAR Sense utilise directement le pipeline de rendu de Unity. Toutes les API graphiques utilisables dans Unity sont prises en charge.

Scriptable Render Pipeline

Le plug - in Unity EasyAR Sense prend en charge la Universal Render Pipeline (URP) 7.0.0 ou une version ultérieure.

Le plug - in Unity EasyAR Sense ne prend pas en charge la High Definition Render Pipeline (HDRP).

Note

Déclaration concernant la prise en charge du render graph URP 17+ de Unity 6

EasyAR prend en charge le render graph URP 17+ de Unity 6, mais il reste encore quelques problèmes non résolus dans Unity lui - même. En cas de situation anormale, vous pouvez essayer d'utiliser le mode de compatibilité URP proposé par Unity.

Certains problèmes ont été résolus dans la version la plus récente de Unity. Il est recommandé d'utiliser la version 6.2 et supérieure.

Les problèmes connus en dehors du mode de compatibilité incluent :

  1. [Non résolu] Lorsque vous obtenez la texture de la caméra depuis EasyAR (comme dans l'exemple ImageTracking_Coloring3D et l'exemple Workflow ARSession (CameraDevice)), des défauts visuels et des artefacts peuvent être observés sur les appareils iOS/Mac. Nous avons reproduit ce problème dans un package Unity pur et l'avons signalé à Unity : Glitches on iOS with AR Camera Image Rendering (URP 17 render graph). Vous pouvez suivre l'évolution du problème en consultant les mises à jour de Unity Issue UUM - 87787 et les journaux de publication des futures versions de Unity.

    Pour toutes les versions de Unity 6, vous pouvez utiliser les mesures d'atténuation partielles, activées par défaut.

    Pour Unity 6.2 et les versions ultérieures, vous pouvez définir l'échelle de rendu dans l'actif Universal Render Pipeline sur une valeur en dehors de 0,96 - 1,05 pour éviter ce problème.

  2. [Résolu dans Unity 6.2] Sur Windows DX11, l'image de la caméra peut rendre l'effet de rendu des objets dans la scène imprévisible. Dans les versions Unity 6.0 - 6.1, EasyAR propose une option de contournement activée par défaut.

  1. La version actuelle ne prend pas en charge HarmonyOS natif/pur 5.0.↩