Table of Contents

Compatibilité Unity

Cet article présente les versions de Unity et les exigences de configuration compatibles avec EasyAR Sense Unity Plugin.

Versions de Unity

EasyAR Sense Unity Plugin prend en charge Unity 2021.3 ou plus récent.

Le package de support EasyAR Mega nécessaire au développement des fonctions Mega prend en charge Unity 2021.3.30 ou plus récent.

Astuce

En général, EasyAR ne dépend pas de nombreuses API Unity qui changent souvent ; si Unity publie une nouvelle version, EasyAR Sense Unity Plugin peut généralement continuer à fonctionner normalement.

EasyAR Sense Unity Plugin prend en charge le Render Graph URP 17+ de Unity 6 à partir de la version 4.6.4.

Plateformes de développement

Système d’exploitation Version du système Architecture CPU Remarque
Windows 7 et versions ultérieures (7/8.1/10/11) x86, x86_64 Les versions Windows N/KN nécessitent d’installer Media Feature Pack
macOS 11.0 et versions ultérieures x86_64, arm64

Par ailleurs, vous devez satisfaire aux exigences système de développement Unity de la version concernée.

Plateformes de publication

Système d’exploitation Version du système Architecture CPU Remarque
Windows 7 et versions ultérieures (7/8.1/10/11) x86, x86_64 Les versions Windows N/KN nécessitent d’installer Media Feature Pack.
La fonction d’enregistrement d’écran EasyAR n’est pas prise en charge.
macOS 11.0 et versions ultérieures x86_64, arm64 La fonction d’enregistrement d’écran EasyAR n’est pas prise en charge.
Android 5.0 et versions ultérieures armv7a, arm64-v8a Le support arm64-v8a nécessite IL2CPP.
La fonction d’enregistrement d’écran EasyAR n’est disponible que lorsque Graphics API est OpenGLES2 ou OpenGLES3.
HarmonyOS (mobile) 1.0 – 4.x support natif
5 et plus via la couche de compatibilité des applications Android1		 arm64-v8a
iOS 15.0 et versions ultérieures arm64 Architecture doit être configurée en ARM64 ; Universal n’est pas pris en charge.
La fonction d’enregistrement d’écran EasyAR n’est pas prise en charge.
visionOS 2.0 et versions ultérieures arm64 La fonction d’enregistrement d’écran EasyAR n’est pas prise en charge.

Par ailleurs, vous devez satisfaire aux exigences de publication Unity pour la version concernée :

Remarques supplémentaires pour macOS

Apple silicon

EasyAR Sense Unity Plugin prend en charge l’exécution native sur les appareils Apple silicon à partir de la version 4.6.0, et peut aussi être utilisé normalement dans l’éditeur Unity.

Note

En raison d’un bug de support des plugins natifs dans Unity, certaines versions de Unity peuvent produire des applications construites pour "Apple silicon" ou "Intel 64-bit + Apple silicon" qui ne fonctionnent pas correctement. Si l’application ne fonctionne pas sur Mac et affiche des erreurs comme "Fail to load EasyAR library" ou "DllNotFoundException: EasyAR assembly", il est recommandé d’utiliser une version plus récente de Unity ou de demander de l’aide à Unity et à la communauté Unity.

Remarques supplémentaires pour Android

Prise en charge de pages mémoire de 16 KB sur Android

EasyAR Sense Unity Plugin prend en charge les appareils avec des pages mémoire de 16 KB à partir de la version 4000.

Astuce

Cette fonctionnalité a été introduite dans Android 15. Pour plus d’informations, consultez la documentation Android sur la prise en charge des pages de 16 KB.

Avertissement Google Play sur libhuawei_arengine_jni.so susceptible de faire crasher l’application sur les appareils 16 KB

Avec la configuration par défaut, EasyAR Sense Unity Plugin utilise AR Engine SDK 3.7.0.3 (qui inclut libhuawei_arengine_jni.so) sur Android pour prendre en charge Huawei AR Engine. Comme cette bibliothèque a été compilée par Huawei avec un ancien Android NDK, Google Play peut afficher un avertissement, mais cela n’a aucun effet réel.

alt text

Your app could crash on 16 KB devices

base/lib/arm64-v8a/libhuawei_arengine_jni.so

À propos d’AR Engine SDK :

  • La version 3.7.0.3 a été compilée par Huawei avec un ancien Android NDK, ce qui explique l’avertissement Google Play. Voir la documentation Google sur la compilation avec Android NDK r27 et versions inférieures.
  • La version 3.7.0.3 prend bien en charge le chargement sur les appareils Android avec pages mémoire de 16 KB, ce qui explique pourquoi 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 pages mémoire de 16 KB. Comme il s’agit de la dernière version disponible publiquement dans l’écosystème Android, EasyAR Sense Unity Plugin continue d’utiliser la version 3.7.0.3.

L’utilisation d’AR Engine SDK 3.7.0.3 avec EasyAR Sense Unity Plugin n’empêche pas la publication sur Google Play et ne provoque pas de plantage réel :

  • Les appareils Huawei ne font pas partie des appareils Android 16 KB.
  • EasyAR Sense utilise une liste blanche pour éviter d’exécuter AR Engine SDK sur des appareils non Huawei.

Comment traiter cet avertissement :

  • Si vous avez besoin d’utiliser la fonction AR Engine sur des appareils Huawei, il est recommandé d’ignorer cet avertissement.

  • Si vous n’avez pas besoin de prendre en charge les appareils Huawei ou si vous pouvez vous passer de la fonction AR Engine, vous pouvez désactiver AR Engine SDK dans Configuration EasyAR.

    Note

    Sur les appareils Huawei, même si vous désactivez AR Engine, les autres fonctions EasyAR continuent de fonctionner normalement, mais le résultat du suivi de mouvement sera différent de celui d’AR Engine, et les autres fonctions utilisant le suivi de mouvement seront également affectées.

Remarques supplémentaires pour HarmonyOS

Systèmes Harmony compatibles Android

EasyAR Sense Unity Plugin prend entièrement en charge HarmonyOS 1.0 – 4.x.

HarmonyOS natif / HarmonyOS pur / HarmonyOS NEXT

EasyAR Sense Unity Plugin prendra prochainement en charge HarmonyOS natif 5.0+ ; la version actuelle ne le prend pas encore en charge et ne peut être utilisée que via la couche de compatibilité des applications Android.

Astuce

La version internationale de Unity ne prend pas en charge HarmonyOS natif ; il faut utiliser Tuanjie Engine.

WebGL

EasyAR Sense Unity Plugin ne prend pas en charge WebGL de Unity.

Astuce

Les fonctionnalités développées directement à l’aide des interfaces de service cloud EasyAR (par exemple l’interface de service CRS) peuvent être publiées sur la plateforme Web.

Graphics API

EasyAR Sense Unity Plugin utilise directement la pipeline de rendu de Unity, donc toutes les APIs graphiques utilisables dans Unity sont prises en charge.

Scriptable Render Pipeline

EasyAR Sense Unity Plugin prend en charge Universal Render Pipeline (URP) 7.0.0 ou plus récent.

EasyAR Sense Unity Plugin ne prend pas en charge High Definition Render Pipeline (HDRP).

Note

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

EasyAR prend en charge le render graph Unity 6 URP 17+, mais Unity a encore des problèmes non résolus. En cas de situation anormale, essayez le mode de compatibilité URP fourni par Unity.

Certains problèmes ont déjà été corrigés dans les versions récentes de Unity, il est donc recommandé d’utiliser la version 6.2 ou supérieure.

Les problèmes connus en mode non compatible incluent :

  1. [Non résolu] Lors de l’obtention de la texture de caméra depuis EasyAR (comme dans l’exemple ImageTracking_Coloring3D et dans l’exemple ARSession workflow (CameraDevice)), des défauts visuels et artefacts peuvent apparaître sur les appareils iOS/Mac. Nous avons reproduit le problème dans un package Unity pur et l’avons signalé à Unity : Glitches on iOS with AR Camera Image Rendering (URP 17 render graph). Suivez l’avancement via Unity Issue UUM-87787 et les futurs journaux de versions de Unity.

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

    Pour Unity 6.2 et versions ultérieures, vous pouvez définir Render Scale dans Universal Render Pipeline Asset sur une valeur différente de 0.96-1.05 afin d’éviter ce problème.

  2. [Corrigé dans Unity 6.2] Sous Windows DX11, l’image caméra peut rendre le rendu des objets de la scène imprévisible. Dans Unity 6.0 - 6.1, EasyAR fournit une option de contournement activée par défaut.

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