Table of Contents

EasyAR Sense Unity Plugin notes de version

Nous sommes heureux d'annoncer la sortie d'EasyAR Sense Unity Plugin 4000. Cette version marque une étape importante avec une API complète et un support de périphériques à jour pour EasyAR, et les nouvelles versions seront publiées plus fréquemment que par le passé.

Téléchargez EasyAR Sense Unity Plugin 4000 pour profiter de ces nouvelles fonctionnalités et améliorations.

Versions précédentes

Version 4002.0.0

Date de publication : 2026-05-18

  • 🐛 Correction du problème d'échec de build Android pour Unity 6.4.4.
  • 🔧 Ajustement de certains exemples de code.
  • ⬆️ Mise à jour d'EasyAR Sense vers 4.9.0

Version 4001.0.0

Date de publication : 2026-03-10

  • 🐛 Correction des problèmes numériques dans la conversion de pose du natif vers Unity. Ce problème provoquait des sauts de pose de courte durée lors de l'utilisation de Mega sur certains appareils, entraînant un clignotement ou un tremblement rapide du contenu. La correction de ce problème pourrait également résoudre d'autres problèmes potentiels similaires.
  • 🔧 Ajustement de certaines interfaces de MegaTrackerFrameFilter pour s'adapter aux changements d'interface d'EasyAR Sense
  • ⬆️ Mise à jour d'EasyAR Sense vers 4.8.0

Version 4000.0.1

Date de publication : 2025-11-14

  • 🐛 Correction : résolution de l'exception d'exécution AndroidJavaException pouvant être déclenchée dans les builds Android avec minify activé en raison de méthodes statiques manquantes (loadLibraries, setupActivity), cette erreur empêchait EasyAR de fonctionner.

Version 4000.0.0

Date de publication : 2025-10-20

À partir de cette version, EasyAR Sense Unity Plugin suivra le contrôle de version des packages (utilisant Semantic Versioning) requis par Unity, par conséquent, le numéro de version sera différent de celui d'EasyAR Sense et la fréquence de publication pourrait également être différente. Cette version du plugin contient la version officielle d'EasyAR Sense 4.7.0.

EasyAR Sense Unity Plugin 4000.0.0 apporte des changements majeurs, se concentrant principalement sur les aspects suivants :

  1. Changements de compatibilité avec Unity et AR Foundation

    À partir de cette version, EasyAR Sense Unity Plugin ne supportera que Unity 2021.3 et versions ultérieures, le support d'Unity 6 est également complet. De plus, le support d'AR Foundation a été fusionné dans le package du plugin, cette version ne supportera qu'AR Foundation 5 et versions ultérieures, son utilisation a été grandement simplifiée. Si des composants AR Foundation sont ajoutés à la scène, qu'AR Foundation soit finalement utilisé ou non après l'exécution, la configuration de la scène et le code du script peuvent rester inchangés.

  2. Support de casques à jour, ajout du support pour plusieurs casques OST/VST

    Après des années de travail avec plusieurs entreprises de l'industrie, le support des casques par EasyAR a été standardisé. Vous pouvez maintenant implémenter le support pour des casques tiers via des extensions EasyAR Sense Unity Plugin (ce qui peut nécessiter que le fabricant du casque fournisse certaines interfaces de données). Cette version intègre le support pour Apple Vision Pro et XREAL Air2 Ultra, et supporte Pico 4 Ultra Enterprise et Rokid AR Studio via le package d'extension EasyAR Sense Unity Plugin. Vous pouvez également obtenir des packages d'extension pour d'autres appareils auprès de certains partenaires d'EasyAR (comme Xrany 元霓).

  3. Amélioration des interfaces des composants Unity, optimisation majeure du du flux de travail ARSession

    Cette version est la première à encapsuler complètement les fonctionnalités d'EasyAR Sense via des composants Unity. ARSession a fait l'objet d'une optimisation et d'une réécriture majeures, vous pouvez maintenant facilement déterminer la prise en charge des appareils ou des fonctionnalités, et ainsi démarrer ou arrêter ARSession pour permettre la commutation d'ARSession ou de différentes fonctionnalités AR à l'exécution. De plus, vous pouvez utiliser ARSessionFactory pour créer ARSession et ses composants associés à l'exécution. Cette version ajoute également des fonctions de navigation inertielle et de caméra 3DoF, conçues principalement pour EasyAR Mega, mais utilisables séparément.

  4. Ajout de plusieurs outils de développement et de diagnostic

    Cette version ajoute de toutes nouvelles fonctionnalités d'enregistrement et de lecture EIF, bien que l'enregistrement et la lecture EIF soient disponibles dans les versions précédentes, leur utilisation n'a jamais été aussi simple. Vous pouvez maintenant utiliser l'outil de diagnostic Session Validaion Tool dans l'éditeur Unity pour lire directement des fichiers eif et piloter votre scène, qu'il s'agisse de suivi d'images, de cartes spatiales ou d'EasyAR Mega, vous pouvez reproduire les effets de l'appareil sur votre ordinateur. Vous pouvez maintenant utiliser le panneau de diagnostic d'exécution EasyAR Diagnostics Panel dans l'application pour activer facilement l'enregistrement eif, ou pour afficher/masquer les informations d'état clés d'ARSession et de ses composants à tout moment. De plus, les exemples de cette version ont été entièrement réécrits, en exécutant un exemple, vous pouvez voir directement l'état d'ARSession ainsi que le bouton d'enregistrement eif pour faciliter l'utilisation.

  5. Publication complète des outils EasyAR Mega

    Cette version intègre et publie Mega Studio 2.12. Les futures mises à jour du plugin seront plus fréquentes, les outils Mega côté Unity seront progressivement fusionnés dans le plugin et publiés avec les mises à jour régulières du plugin. Outre les mises à jour des versions préliminaires précédentes, cette version active le support de la navigation inertielle par défaut, étendant ainsi considérablement le support des appareils pour EasyAR Mega. Cette version contient également le support pour la dernière version du service EasyAR Mega Landmark. Vous pouvez faire une demande pour utiliser EasyAR Mega via la page du site web EasyAR.

Le contenu détaillé de la mise à jour est le suivant :

Changements de compatibilité Unity et AR Foundation :

  • 🔧 Unity : Prend en charge Unity 2021.3 et versions ultérieures (y compris Unity 2022.x/Unity 6.x)
    • 🔥 Suppression de la prise en charge d'Unity 2019/Unity 2020
    • 🔥 Suppression de la détection de version gradle pour Unity 2019
    • 🔥 Suppression de l'option DisableARCoreAREngine pour Unity 2019
  • ✨ Unity 6 : Prise en charge complète d'Unity 6
    • ✨ Prend en charge URP 17+ et Render Graph
    • 🐛 Corrigé : Échec d'ARCore dû aux changements de comportement du ClassLoader sur Unity 6
    • 🐛 Corrigé : Échec du rendu de la caméra lorsque Render Scale n'est pas 1
    • 🐛 BUG Unity 6 lui-même : Des défauts visuels et des artefacts sont observables sur les appareils iOS/Mac. Ce problème ne se produit que lorsque l'acquisition de la texture de la caméra est nécessaire. Nous avons ajouté des mesures d'atténuation partielles mais ne pouvons pas l'éliminer complètement. Signalé à Unity, voir Unity Issue UUM-87787. À partir d'Unity 6.2, ce problème peut être contourné en définissant Render Scale dans Universal Render Pipeline Asset sur une valeur autre que 0.96-1.05.
    • 🐛 BUG Unity 6 lui-même : Rendu incorrect sur Windows DX11. Nous avons ajouté des mesures d'atténuation dans Unity 6.0-6.1. Testé, Unity 6.2 a résolu ce problème.
  • ✨ AR Foundation : Prend en charge AR Foundation 5 et versions ultérieures, utilisation grandement simplifiée
    • ✨ La prise en charge d'AR Foundation est désormais intégrée au package du plugin, plus besoin d'importer un package séparément (peut être désactivé via une option de configuration si nécessaire)
    • ✨ Prend en charge la réutilisation de Unity.XR.CoreUtils.XROrigin comme origine de l'ARSession, prend en charge la réutilisation de la caméra du XROrigin
    • ✨ Ajout de l'option de configuration Unity XR Auto Switch, gère par défaut le basculement des objets Unity XR (incluant AR Foundation)
    • ✨ L'ARSession créé via le menu EasyAR inclut automatiquement et active par défaut la prise en charge d'AR Foundation
    • ✨ La grande majorité des exemples ont ajouté la prise en charge d'AR Foundation (AR Foundation lui-même doit être importé manuellement et configuré correctement)
    • 🔧 ARCore et ARKit peuvent être contrôlés séparément, et l'ordre de priorité entre ARCore/ARKit intégré d'EasyAR et ARCore/ARKit d'AR Foundation peut être contrôlé
    • 🔥 Suppression de la prise en charge d'AR Foundation 4
    • 🔥 Suppression de la prise en charge d'ARSessionOrigin, seule XROrigin est prise en charge
    • 🔥 Suppression de l'exécution déléguée du flux d'installation ARCore d'AR Foundation
  • ✨ Compatibilité totale avec input system package

Mise à jour de la prise en charge des casques

  • 🚀 L'interface des dispositifs d'affichage tête haute est désormais stable et prend en charge les connexions tierces
    • ✨ Prise en charge des appareils tiers (nécessite une interface de données spécifique du fabricant)
    • ✨ Prise en charge de XROrigin et XR Interaction Toolkit
    • ✨ Simplification et unification de tous les exemples de casques, zéro code et prise en charge du basculement de fonctionnalités
    • ✨ Prise en charge de l'entrée caméra fisheye
    • ✨ Prise en charge des données 3DOF d'entrée caméra personnalisée
    • ✨ Ajout de la fonction de menu : Extensions, regroupant tous les éléments de menu d'extension
    • 🐛 Correction d'anomalies de rendu lors de l'exécution de DenseSpatialMap sur certains casques
    • 🔥 Suppression des anciens exemples de lunettes comme ActionOne et BT350
  • ✨ Prise en charge native d'Apple Vision Pro
    • ✨ Prise en charge de Metal, RealityKit et du mode Hybride
    • ✨ Prise en charge de visionOS >= 2.0, prise en charge de visionOS 26
  • ✨ Prise en charge native de XREAL Air2 Ultra (nécessite XREAL SDK >= 3.1)
    • ✨ Plus besoin d'importer un package de support séparé
    • ⚡ Optimisation des performances d'exécution sur XREAL
    • 🔥 Suppression du support pour XREAL Light
  • ✨ Distribution du support pour d'autres appareils comme Pico et Rokid via l'extension EasyAR Sense Unity Plugin
    • ✨ Fourniture d'un modèle de référence pour l'intégration d'appareils tiers : com.easyar.sense.ext.hmdtemplate
    • ✨ Prise en charge de Pico 4 Ultra Enterprise (nécessite PICO Unity Integration SDK >= 3.1)
    • ✨ Prise en charge de Rokid AR Studio (nécessite Rokid Unity OpenXR Plugin >= 3.0.3)
    • ✨ Ces extensions prendront en charge les futures versions d'EasyAR Sense Unity Plugin
  • ✨ Prise en charge de la licence EasyAR XR
    • 🔧 L'utilisation d'EasyAR sur casque nécessite une licence EasyAR XR et une connexion internet initiale (nécessite une connexion à chaque utilisation pour l'essai)

Amélioration des interfaces des composants Unity, optimisation significative du flux de travail ARSession :

  • 🚀 Amélioration de l'encapsulation de la couche des composants Unity
    • ✨ Amélioration des composants de scène, fournissant toutes les fonctionnalités d'EasyAR Sense
    • 🔥 Suppression de toutes les interfaces de la couche EasyAR Sense encapsulées via des composants
    • 🔥 Suppression de toutes les interfaces internes
  • ✨ ARSession : Réécriture et optimisation significative du flux de travail
    • ✨ Prise en charge du démarrage et de l'arrêt de la session à tout moment
    • ✨ Prise en charge du contrôle du démarrage automatique de la session
    • ✨ Prise en charge du changement de fonctionnalité de session et de source d'entrée sans écran noir
    • ✨ Simplification de la vérification de la prise en charge des appareils, fournie via une interface cohérente
    • ✨ Mise à jour de la liste des appareils pris en charge par MotionTracker, ARCore et AR Engine au démarrage
    • ✨ Prise en charge du redémarrage automatique de la session après la mise à jour de la liste des appareils
    • ✨ Prise en charge de l'obtention d'informations détaillées sur la corruption de la session
    • ✨ Ajout d'une auto-vérification de l'état interne de la session
    • 🔥 Suppression d'ARComponentPicker, ses fonctionnalités étant reprises par le reste du flux de session
    • 🔥 Interdiction de l'exécution simultanée de plusieurs ARSession
  • ✨ ARSessionFactory : Fournit la capacité de créer des ARSession et des composants associés à l'exécution
    • ✨ Prise en charge de la création à l'exécution, via ARSessionFactory, d'une session identique à celle du menu de l'éditeur
    • ✨ Ajout de la fonction de tri des Frame Source (incluant un élément de menu)
  • ✨ FrameSource : Ajout de la prise en charge de la navigation inertielle et 3DoF
    • ✨ Ajout d'InertialCameraDeviceFrameSource pour la prise en charge de la navigation inertielle
    • ✨ Ajout de ThreeDofCameraDeviceFrameSource pour la prise en charge des caméras 3DoF
    • ✨ Ajout de la fonction de menu : Frame Source par Type de Transformation, fournissant une liste de toutes les FrameSource intégrées
    • ⚡ Optimisation des options de l'Inspecteur
  • ✨ Autres ajustements d'interface et mises à jour fonctionnelles
    • ✨ Ajout de la fonctionnalité de création d'ImageTarget à partir d'une Texture2D
    • ✨ Ajout d'ImageMaterial pour le rendu des données de type Image (image de caméra, image de cible, etc.)
    • ✨ Ajout d'ActiveController pour contrôler l'état 'active' d'un GameObject, unifiant la logique de contrôle associée
    • ✨ Ajout de la fonction de simulation de la rotation de l'écran sur bureau
    • ✨ Ajout de XROriginChildController, contrôlant le comportement des objets sous l'origine de la Session
    • 🔥 Suppression de WorldRootController
    • 🔧 Séparation de l'interface de carte spatiale éparse en deux composants fonctionnels distincts : Builder et Tracker
    • 🔧 Ajustement d'EasyARController, fournissant des fonctionnalités statiques au niveau application/système
    • 🔧 Unification des interfaces des composants Target
    • 🔧 Unification de l'interface d'accès aux données des services

Ajout de plusieurs outils de développement et de diagnostic :

  • 🚀 Ajout d'un outil de diagnostic en édition : Session Validation Tool
    • ✨ Simplification de la lecture d'eif dans n'importe quel scénario
    • ✨ Prise en charge du contrôle du flux de lecture eif
    • ✨ Prise en charge du contrôle du flux de session
  • 🚀 Ajout d'un panneau de diagnostic en temps d'exécution : EasyAR Diagnostics Panel
    • ✨ Ajout d'un interrupteur Developer Mode, par défaut cliquer 8 fois sur l'écran pour activer/désactiver le panneau de diagnostic, simplifiant l'enregistrement eif dans les applications en ligne et le retour d'informations sur les problèmes
    • ✨ Prise en charge d'un interrupteur Developer Mode personnalisé, utilisant une interaction personnalisée pour activer/désactiver le panneau de diagnostic
    • ✨ Prise en charge du contrôle de l'enregistrement eif
    • ✨ Prise en charge du contrôle de l'affichage des informations de session
    • ✨ Prise en charge du contrôle de l'enregistrement eed
  • ✨ Ajout de nouvelles fonctionnalités d'enregistrement et de lecture EIF
    • ✨ FrameRecorder sera automatiquement assemblé dans ARSession, plus besoin de sélection manuelle
    • ✨ FrameRecorder générera automatiquement un nom de fichier par défaut pour prendre en charge une utilisation sans script
    • ✨ FramePlayer avec les données enregistrées dans le nouveau format prend en charge le saut de lecture et le réglage de la vitesse, avec une réduction de la taille du fichier
    • 🔧 Prise en charge de l'utilisation d'eif sur ordinateur pour piloter des scènes et des fonctionnalités AR (pas une nouvelle fonctionnalité)
  • ✨ Ajout de DiagnosticsController, unifiant et optimisant les fonctionnalités de diagnostic
    • ✨ Ajout d'un affichage hiérarchique et d'un contrôle des informations, par défaut toutes les erreurs et avertissements seront affichés via l'UI
    • ✨ Ajout de la fonctionnalité d'affichage des informations d'état clés d'ARSession et de ses composants, par défaut affichées via l'UI et mises à jour à chaque frame
    • 🔧 Utilisation des fonctionnalités de diagnostic pour simplifier l'obtention d'informations de retour sur les problèmes
    • 🔥 Suppression de GUIPopup
  • 🔧 Optimisation du comportement en état d'exception et de l'affichage des messages d'erreur
    • 🔧 Optimisation des messages d'erreur lorsqu'aucune source de frame n'est disponible
    • 🔧 Dans un environnement URP utilisant EasyAR plutôt qu'AR Foundation ou un casque de rendu d'image de caméra, une configuration incorrecte de RendererFeature générera une erreur et interrompra l'exécution d'ARSession
    • 🔧 Modification de la stratégie de contrôle Active par défaut d'Origin, le contenu reste collé à l'écran plutôt que de disparaître lors d'une perte de suivi
    • 🔧 Lors de l'utilisation d'un produit d'essai sur une caméra personnalisée ou un casque, le contenu sera masqué à l'expiration de la limite pour éviter une mauvaise évaluation de l'effet
  • 🔧 Optimisation du contenu et des options de la page de configuration
    • ✨ Prise en charge de la sélection de variantes de la bibliothèque EasyAR Sense
    • 🔒 Dans la section des autorisations d'application, à l'exception de l'autorisation de la caméra, les autres autorisations ne sont plus modifiables et sont déterminées par la variante de la bibliothèque EasyAR Sense et si Mega est activé
    • 🔧 Les configurations de fonctionnalités et de serveurs sont regroupées par fonctionnalité EasyAR
    • 🔧 Gestion centralisée des configurations des SDK AR tiers
    • 🔧 Gestion centralisée des configurations de contournement pour Unity

EasyAR Mega Outils Completement Publics :

  • 🚀 Completement publics, mises à jour synchronisées
    • ✨ Intégration et publication de Mega Studio 2.12
    • 🔧 Les outils Mega côté Unity seront progressivement intégrés dans le plugin. À l'avenir, seul le package intégré de la dernière version sera fourni, mais il sera publié conjointement avec les mises à jour régulières du EasyAR Sense Unity Plugin
    • 🔧 EasyAR Mega nécessite toujours une demande via la page web EasyAR et une approbation avant utilisation
  • ✨ Nouvelle prise en charge de EasyAR Mega Landmark
  • ✨ Nouvelle prise en charge de l'inertie 5DOF activée par défaut, étendant considérablement la compatibilité des appareils avec EasyAR Mega
  • ✨ Nouvelle prise en charge de l'accès aux services Mega via API Token
  • 🔧 Optimisation des effets Mega et de l'expérience de développement (inclus dans les versions 4.7.x précédemment mises à jour)
    • ✨ Prise en charge du mode rotation pure 3DOF et du mode 0DOF (non activés par défaut)
    • ✨ Ajout de EditorCameraDeviceFrameSource pour le diagnostic dans l'éditeur, évitant une exécution erronée sur mobile due à une copie incomplète d'un exemple
    • ✨ Lors de l'utilisation de Mega pour enregistrer des données eif d'anciennes versions, FrameRecorder générera automatiquement un fichier .eif.json
    • 🔧 Remplacement de l'option de dégradation pour le débogage distant par LocationInputMode
    • 🔧 Séparation du mode sans suivi en un composant indépendant, généralement plus nécessaire d'utilisation ou d'attention
    • 🔧 Ajout de l'option BlockRootSource, une erreur sera signalée par défaut si BlockRoot n'est pas configuré
    • 🔧 Ajustement du comportement par défaut lors de la localisation vers plusieurs blocs, garantissant que les blocs multiples ne soient pas utilisés par défaut
    • 🔧 Ajustement des noms de certaines interfaces
    • 🔧 Lancement d'exceptions plus claires lorsque la Session inclut Mega mais ne peut pas être utilisée
    • 🔧 Ajustement du niveau de qualité minimum MotionTracker pris en charge par Mega à Limited
    • 🐛 Correction de l'erreur d'exécution causée par un échappement incorrect de l'état CloudLocalizerStatus.WakingUp
    • 🔧 Certaines optimisations et modifications sont détaillées dans les notes de mise à jour d'EasyAR Sense

Échantillons de réécriture et d'optimisation :

  • ✨ Refonte de tous les échantillons
    • ✨ Compatibilité avec différentes configurations du système d'entrée
    • ✨ Compatibilité avec URP17+
    • ✨ Compatibilité avec l'utilisation d'AR Foundation
    • 🔧 Compatibilité sans utilisation d'AR Foundation
    • 🔧 Conservation d'un petit nombre d'échantillons sans prise en charge d'AR Foundation
    • ⚡ Optimisation des scripts et des appels d'interface
    • 🚚 Certains échantillons ont été renommés
    • 🔧 Remplacement des ressources (modèles, vidéos, etc.) dans les échantillons
    • ⚡ Réduction de l'utilisation des Streaming Assets, importés et utilisés uniquement dans des échantillons démontrant des fonctionnalités spécifiques
    • ✨ Utilisation de Texture2D pour créer des ImageTarget
  • ✨ Ajout de démonstrations de nouvelles fonctionnalités et interfaces
    • ✨ Ajout de l'échantillon Workflow_ARSession pour apprendre les flux de base de session et la prise en charge des périphériques
    • ✨ Ajout de l'échantillon Workflow_FrameSource_ExternalImageStream, utilisant une vidéo comme caméra personnalisée (ne convient pas pour les casques)
    • ✨ Ajout de l'échantillon Combination_BasedOn_MotionTracking pour apprendre à utiliser, basculer entre différentes fonctionnalités et avec AR Foundation lorsque le suivi de mouvement est disponible
    • ✨ Ajout de l'échantillon Combination_BasedOn_AppleVisionPro pour démontrer l'utilisation et la bascule des fonctionnalités sur Apple Vision Pro
    • ✨ Ajout de l'échantillon Combination_BasedOn_Xreal pour démontrer l'utilisation et la bascule des fonctionnalités sur les périphériques XREAL
    • ✨ Ajout de plusieurs Mega samples (inclus dans les versions 4.7.x précédemment mises à jour)
    • ✨ Ajout de la fonctionnalité de bascule de la taille de la caméra et du mode torche dans Workflow_FrameSource_CameraDevice
    • 🔥 Suppression des échantillons AR Foundation distincts, leurs fonctionnalités étant désormais incluses dans d'autres échantillons
    • 🔥 Suppression de l'échantillon FrameRecording, sa fonctionnalité étant désormais incluse dans d'autres échantillons
    • 🔥 Suppression de l'échantillon MotionTracking_Fusion, sa fonctionnalité étant désormais incluse dans Combination_BasedOn_MotionTracking
    • 🔥 Suppression de l'échantillon SurfaceTracking_ImageTarget, la combinaison de fonctionnalités permettant toujours de l'implémenter facilement
    • 🔥 Suppression de l'échantillon Camera_CustomCamera, pouvant toujours être implémenté si nécessaire
    • 🔥 Suppression des anciens échantillons pour lunettes comme ActionOne et BT350
  • ✨ Simplification de l'utilisation de l'enregistrement et de la lecture eif
    • ✨ Ajout d'un bouton d'enregistrement eif à tous les échantillons, les fichiers eif enregistrés pouvant être utilisés dans l'éditeur
  • ✨ Réécriture du lanceur, ajout de descriptions pour les échantillons
    • 🐛 Correction d'un problème d'éclairage trop faible lors du chargement d'une scène d'échantillon via le lanceur

Intégration des fonctionnalités AR EasyAR et tierces :

  • ⬆️ Mise à jour d'EasyAR Sense vers la version 4.7.0 finale
  • ⬆️ Mise à jour d'EasyAR AR Engine Interop
  • ⬆️ Mise à jour d'ARCore SDK vers la version 1.46.0
  • 🔧 Désactivation d'AR Engine sur certains téléphones où il ne peut pas fonctionner correctement
  • 🐛 Correction d'un problème empêchant ARCore de fonctionner sous Unity 6 dû à un changement de comportement du ClassLoader

Sujets connexes