Table of Contents

Migrer des applications Unity depuis EasyAR Sense Unity Plugin 4.2 et versions antérieures

À partir de la version 4.3, le plugin Unity est distribué et géré via Unity Package Manager, et la structure du package du plugin a été fortement ajustée. Par conséquent, lors d'une mise à niveau depuis 4.2 ou une version antérieure vers 4.3 ou une version ultérieure, quelques étapes supplémentaires sont nécessaires.

Étapes de migration

Lors d'une mise à niveau depuis la version 4.2 ou antérieure, vous devez :

  1. Supprimer tous les fichiers de l'ancien plugin. Ces fichiers peuvent se trouver dans les dossiers Assets/EasyAR, Assets/Plugins, Assets/Samples et Assets/StreamingAssets.
  2. Importer ensuite la nouvelle version via la Package Manager window de Unity.
  3. Mettre à jour les scènes et le code selon les guides de migration de chaque version ci-dessous.

Migrer vers 4000 et versions ultérieures

La migration vers 4000 et versions ultérieures nécessite les modifications suivantes.

Consultez Créer et configurer AR session pour recréer la structure de la scène.

Modifications associées :

  • prefab a été supprimé.
  • VIOCameraDeviceUnion a été supprimé.

Pour utiliser AR Foundation, consultez Activer AR Foundation dans un projet EasyAR.

Modifications associées :

  • Le support AR Foundation a été réimplémenté.

Vous ne pouvez pas utiliser EasyAR sur les appareils XREAL X et XREAL Light. Il est recommandé de passer à XREAL Air2 Ultra.

Modifications associées :

  • Nreal/XREAL X et Nreal/XREAL Light ne sont plus pris en charge.
  • Le support XREAL est intégré à EasyAR Sense et prend en charge XREAL Air2 Ultra.

Consultez Migrer vers 4000 pour la suite de la migration.

La version 4000 comporte davantage de changements par rapport à 4.x.

Migrer vers la version 4.6

Avertissement

La version 4.6 n'est plus maintenue. Il est recommandé de mettre à niveau directement vers 4000 ou une version ultérieure. La documentation détaillée de développement Unity sur le site EasyAR est préparée pour la version 4000 et ultérieure.

La migration vers la version 4.6 nécessite les modifications suivantes.

Il est recommandé de consulter les exemples de la version 4.6 pour comprendre la nouvelle structure de scène, et de recréer les composants associés.

Modifications associées :

  • prefab a été supprimé.
  • VIOCameraDeviceUnion a été supprimé.
  • Le support AR Foundation a été séparé dans un package indépendant.

Si AR Foundation n'est pas nécessaire, vous pouvez supprimer le noeud AR Foundation sous AR Session dans la scène ainsi que l'utilisation de ARFoundationFrameSource dans le code.

Modifications associées :

  • Le support AR Foundation a été séparé dans un package indépendant.

Si Nreal n'est pas nécessaire, vous pouvez supprimer le noeud Nreal sous AR Session dans la scène ainsi que l'utilisation de NrealFrameSource dans le code. Lors de l'utilisation de Nreal, il n'est plus nécessaire de créer un package virtuel.

Modifications associées :

  • Le support Nreal a été séparé dans un package indépendant.

Il est recommandé de consulter la documentation API dans les scripts ainsi que les exemples de la version 4.6 pour comprendre les changements d'API et leur utilisation, puis d'effectuer les ajustements appropriés.

Modifications associées :

  • Certaines autres API de scripts ont également changé.
  • Certains méthodes publiques sont marquées internal dans les commentaires XML. Il faut éviter d'utiliser ces API. Elles ont été supprimées dans la version 4000.

Migrer vers la version 4.4

Avertissement

La version 4.4 n'est plus maintenue. Il est recommandé de mettre à niveau directement vers 4000 ou une version ultérieure. La documentation détaillée de développement Unity sur le site EasyAR est préparée pour la version 4000 et ultérieure.

Lors de la migration vers la version 4.4, prêtez attention aux modifications suivantes.

Supprimez autant que possible les références aux prefabs dans le package du plugin. Si vous continuez à utiliser ces prefabs, des journaux d'avertissement seront affichés, et ils contiennent de brèves indications sur la façon de les remplacer dans le nouveau plugin. Il est recommandé de consulter les exemples de la version 4.4 pour comprendre la nouvelle structure de scène.

Modifications associées :

  • prefab a été marqué comme obsolète et supprimé dans la version 4.6.

Supprimez l'utilisation de VIOCameraDeviceUnion. Si vous continuez à utiliser ce composant, des journaux d'avertissement seront affichés, et ils contiennent de brèves indications sur la façon de le remplacer dans le nouveau plugin. Il est recommandé de consulter les exemples de la version 4.4 pour comprendre la nouvelle structure de scène.

Modifications associées :

  • VIOCameraDeviceUnion a été marqué comme obsolète et supprimé dans la version 4.6.

Il est recommandé de consulter la documentation API dans les scripts ainsi que les exemples de la version 4.4 pour comprendre les changements d'API et leur utilisation, puis d'effectuer les ajustements appropriés.

Modifications associées :

  • Certaines autres API de scripts ont également changé.
  • Certains méthodes publiques sont marquées internal dans les commentaires XML. Il faut éviter d'utiliser ces API. Elles ont été supprimées dans la version 4000.