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 de Unity se distribuye y gestiona mediante Unity Package Manager, y la estructura del paquete ha sufrido cambios significativos. Por lo tanto, al actualizar desde la versión 4.2 o inferior a la 4.3 o superior, se requieren pasos adicionales.

Pasos de migración

Al actualizar desde la versión 4.2 o inferior, es necesario:

  1. Eliminar todos los archivos del plugin antiguo, que pueden existir en las carpetas Assets/EasyAR, Assets/Plugins, Assets/Samples y Assets/StreamingAssets.
  2. Luego, importar la nueva versión a través de la ventana Package Manager de Unity.
  3. Actualizar escenas y código siguiendo las guías de migración específicas de cada versión a continuación.

Migrar a la versión 4000 y posteriores

Migrar a la versión 4000 y posteriores requiere los siguientes cambios.

Consulte Creación y configuración de una sesión AR para recrear la estructura de la escena.

Cambios relevantes:

  • Se han eliminado los prefabs.
  • Se ha eliminado VIOCameraDeviceUnion.

Para usar AR Foundation, consulte Habilitar AR Foundation en proyectos EasyAR.

Cambios relevantes:

  • La compatibilidad con AR Foundation se ha reimplementado.

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

Cambios relevantes:

  • Ya no se admite Nreal/XREAL X ni Nreal/XREAL Light.
  • La compatibilidad con XREAL está integrada en EasyAR Sense y admite XREAL Air2 Ultra.

Consulte Migración a 4000 para continuar con el trabajo de 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 recibe mantenimiento; se recomienda actualizar directamente a 4000 o versiones posteriores. La documentación completa de desarrollo Unity en el sitio web de EasyAR está preparada para la versión 4000 y superiores.

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 escena; se sugiere recrear los componentes relevantes.

Cambios relevantes:

  • Se han eliminado los prefabs.
  • Se ha eliminado VIOCameraDeviceUnion.
  • La compatibilidad con AR Foundation se ha dividido en un paquete 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 relevantes:

  • La compatibilidad con AR Foundation se ha dividido en un paquete 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 paquete virtual.

Cambios relevantes:

  • La compatibilidad con Nreal se ha dividido en un paquete independiente.

Se recomienda consultar la documentación de la interfaz en los scripts y los ejemplos de la versión 4.6 para comprender los cambios y el uso de las interfaces, y realizar los ajustes necesarios.

Cambios relevantes:

  • Algunas otras interfaces de script también han cambiado.
  • Algunos métodos públicos están marcados como internal en los comentarios XML; se debe evitar usar estas interfaces, ya que se eliminaron en la versión 4000.

Migrar a la versión 4.4

Advertencia

La versión 4.4 ya no recibe mantenimiento; se recomienda actualizar directamente a 4000 o versiones posteriores. La documentación completa de desarrollo Unity en el sitio web de EasyAR está preparada para la versión 4000 y superiores.

Migrar a la versión 4.4 requiere atención a los siguientes cambios.

Es necesario eliminar, en la medida de lo posible, las referencias a los prefabs dentro del paquete del plugin. Si continúa usando estos prefabs, verá registros de advertencia que incluyen 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 escena.

Cambios relevantes:

  • Los prefabs están marcados como obsoletos y se eliminaron en la versión 4.6.

Elimine el uso de VIOCameraDeviceUnion. Si continúa usando este componente, verá registros de advertencia que incluyen 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 escena.

Cambios relevantes:

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

Se recomienda consultar la documentación de la interfaz en los scripts y los ejemplos de la versión 4.4 para comprender los cambios y el uso de las interfaces, y realizar los ajustes necesarios.

Cambios relevantes:

  • Algunas otras interfaces de script también han cambiado.
  • Algunos métodos públicos están marcados como internal en los comentarios XML; se debe evitar usar estas interfaces, ya que se eliminaron en la versión 4000.