Table of Contents

Migrar aplicaciones Unity desde EasyAR Sense Unity Plugin 4.2 y versiones anteriores

A partir de la versión 4.3, el plugin Unity se distribuye y administra mediante Unity Package Manager, y la estructura del paquete del plugin se ha ajustado considerablemente. Por lo tanto, al actualizar desde 4.2 o una versión anterior a 4.3 o una versión posterior, se requieren algunos pasos adicionales.

Pasos de migración

Al actualizar desde la versión 4.2 o anterior, debe:

  1. Eliminar todos los archivos del plugin antiguo. Estos archivos pueden existir en las carpetas Assets/EasyAR, Assets/Plugins, Assets/Samples y Assets/StreamingAssets.
  2. Luego importar la nueva versión mediante la Package Manager window de Unity.
  3. Actualizar escenas y código según las guías de migración de cada versión que aparecen a continuación.

Migrar a 4000 y versiones posteriores

Migrar a 4000 y versiones posteriores requiere los siguientes cambios.

Consulte Crear y configurar AR session para volver a crear la estructura de la escena.

Cambios relacionados:

  • prefab se ha eliminado.
  • VIOCameraDeviceUnion se ha eliminado.

Para usar AR Foundation, consulte Habilitar AR Foundation en un proyecto EasyAR.

Cambios relacionados:

  • El soporte de AR Foundation se ha reimplementado.

No puede usar EasyAR en dispositivos XREAL X y XREAL Light. Se recomienda cambiar a XREAL Air2 Ultra.

Cambios relacionados:

  • Nreal/XREAL X y Nreal/XREAL Light ya no son compatibles.
  • El soporte de XREAL está integrado en EasyAR Sense y es compatible con XREAL Air2 Ultra.

Consulte Migrar a 4000 para continuar con la migración.

La versión 4000 tiene más cambios en comparación con 4.x.

Migrar a la versión 4.6

Advertencia

La versión 4.6 ya no se mantiene. Se recomienda actualizar directamente a 4000 o una versión posterior. La documentación detallada de desarrollo Unity en el sitio web de EasyAR está preparada para la versión 4000 y posteriores.

Migrar a la versión 4.6 requiere los siguientes cambios.

Se recomienda consultar los ejemplos de la versión 4.6 para comprender la nueva estructura de la escena y volver a crear los componentes relacionados.

Cambios relacionados:

  • prefab se ha eliminado.
  • VIOCameraDeviceUnion se ha eliminado.
  • El soporte de AR Foundation se ha separado en un package independiente.

Si no necesita usar AR Foundation, puede eliminar el nodo AR Foundation bajo AR Session en la escena y el uso de ARFoundationFrameSource en el código.

Cambios relacionados:

  • El soporte de AR Foundation se ha separado en un package independiente.

Si no necesita usar Nreal, puede eliminar el nodo Nreal bajo AR Session en la escena y el uso de NrealFrameSource en el código. Al usar Nreal, ya no es necesario crear un package virtual.

Cambios relacionados:

  • El soporte de Nreal se ha separado en un package independiente.

Se recomienda consultar la documentación de API en los scripts y los ejemplos de la versión 4.6 para comprender los cambios de API y su uso, y realizar los ajustes correspondientes.

Cambios relacionados:

  • También han cambiado algunas otras API de scripts.
  • Algunos métodos públicos están marcados como internal en los comentarios XML. Debe evitar usar estas API. Se han eliminado en la versión 4000.

Migrar a la versión 4.4

Advertencia

La versión 4.4 ya no se mantiene. Se recomienda actualizar directamente a 4000 o una versión posterior. La documentación detallada de desarrollo Unity en el sitio web de EasyAR está preparada para la versión 4000 y posteriores.

Al migrar a la versión 4.4, preste atención a los siguientes cambios.

Debe eliminar en lo posible las referencias a prefabs dentro del paquete del plugin. Si continúa usando estos prefabs, se mostrarán registros de advertencia, y esos registros contienen una breve guía sobre cómo reemplazarlos en el nuevo plugin. Se recomienda consultar los ejemplos de la versión 4.4 para comprender la nueva estructura de la escena.

Cambios relacionados:

  • prefab se ha marcado como obsoleto y se eliminó en la versión 4.6.

Elimine el uso de VIOCameraDeviceUnion. Si continúa usando este componente, se mostrarán registros de advertencia, y esos registros contienen una breve guía sobre cómo reemplazarlo en el nuevo plugin. Se recomienda consultar los ejemplos de la versión 4.4 para comprender la nueva estructura de la escena.

Cambios relacionados:

  • VIOCameraDeviceUnion se ha marcado como obsoleto y se eliminó en la versión 4.6.

Se recomienda consultar la documentación de API en los scripts y los ejemplos de la versión 4.4 para comprender los cambios de API y su uso, y realizar los ajustes correspondientes.

Cambios relacionados:

  • También han cambiado algunas otras API de scripts.
  • Algunos métodos públicos están marcados como internal en los comentarios XML. Debe evitar usar estas API. Se han eliminado en la versión 4000.