Migrer une application 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 a été significativement modifiée. Par conséquent, la migration des versions 4.2 ou inférieures vers la version 4.3 ou supérieure nécessite des étapes supplémentaires.
Étapes de migration
Lors de la mise à niveau depuis la version 4.2 ou une version antérieure, il est nécessaire de :
- Supprimer tous les fichiers de l'ancien plugin, qui peuvent se trouver dans les dossiers
Assets/EasyAR,Assets/Plugins,Assets/SamplesetAssets/StreamingAssets. - Importer ensuite la nouvelle version via Package Manager window d'Unity.
- Mettre à jour les scènes et le code en suivant les guides de migration spécifiques à chaque version ci-dessous.
Migrer vers la version 4000 et ultérieure
La migration vers la version 4000 et ultérieure nécessite les modifications suivantes.
Reportez-vous à Création et configuration d'une session AR pour recréer la structure de scène.
Modifications associées :
- Les prefabs ont été supprimés.
VIOCameraDeviceUniona été supprimé.
L'utilisation d'AR Foundation nécessite de se référer à Activer AR Foundation dans un projet EasyAR.
Modifications associées :
- La prise en charge d'AR Foundation a été réimplémentée.
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.
- La prise en charge de XREAL est intégrée à EasyAR Sense et prend en charge XREAL Air2 Ultra.
Reportez-vous à Migration vers 4000 pour poursuivre les travaux de migration.
La version 4000 présente d'autres changements par rapport aux versions 4.x.
Migrer vers la version 4.6
Avertissement
La version 4.6 n'est plus maintenue. Il est recommandé de migrer directement vers 4000 ou une version ultérieure. La documentation complète de développement Unity sur le site web d'EasyAR est conçue pour les versions 4000 et supérieures.
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 :
- Les prefabs ont été supprimés.
VIOCameraDeviceUniona été supprimé.- La prise en charge d'AR Foundation a été déplacée dans un package indépendant.
Si vous n'avez pas besoin d'utiliser AR Foundation, vous pouvez supprimer le nœud AR Foundation sous AR Session dans la scène, ainsi que toute utilisation de ARFoundationFrameSource dans le code.
Modifications associées :
- La prise en charge d'AR Foundation a été déplacée dans un package indépendant.
Si vous n'avez pas besoin d'utiliser Nreal, vous pouvez supprimer le nœud Nreal sous AR Session dans la scène, ainsi que toute utilisation de NrealFrameSource dans le code. L'utilisation de Nreal ne nécessite plus la création d'un package virtuel.
Modifications associées :
- La prise en charge de Nreal a été déplacée dans un package indépendant.
Il est recommandé de consulter la documentation des interfaces dans les scripts et les exemples de la version 4.6 pour comprendre les changements et les modes d'utilisation des interfaces, et d'effectuer les ajustements appropriés.
Modifications associées :
- D'autres interfaces de script ont également changé.
- Certaines méthodes publiques sont marquées comme internes dans les commentaires XML, il convient d'éviter d'utiliser ces interfaces. 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 migrer directement vers 4000 ou une version ultérieure. La documentation complète de développement Unity sur le site web d'EasyAR est conçue pour les versions 4000 et supérieures.
La migration vers la version 4.4 nécessite de prêter attention aux modifications suivantes.
Il est nécessaire de supprimer autant que possible les références aux prefabs dans le package du plugin. Si vous continuez à utiliser ces prefabs, des journaux d'avertissement s'afficheront, contenant de brèves instructions sur leur remplacement 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 :
- Les prefabs sont marqués comme obsolètes et supprimés dans la version 4.6.
Supprimez l'utilisation de VIOCameraDeviceUnion. Si vous continuez à utiliser ce composant, des journaux d'avertissement s'afficheront, contenant de brèves instructions sur son remplacement 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 :
VIOCameraDeviceUnionest marqué comme obsolète et supprimé dans la version 4.6.
Il est recommandé de consulter la documentation des interfaces dans les scripts et les exemples de la version 4.4 pour comprendre les changements et les modes d'utilisation des interfaces, et d'effectuer les ajustements appropriés.
Modifications associées :
- D'autres interfaces de script ont également changé.
- Certaines méthodes publiques sont marquées comme internes dans les commentaires XML, il convient d'éviter d'utiliser ces interfaces. Elles ont été supprimées dans la version 4000.