Migration Tool

This Unity-based tool provides a structured pipeline for migrating AR experiences originally authored on the LAYAR platform into Unity scenes that are fully compatible with the Hoverlay Digital Sequence Plugin.

Leveraging exported JSON data from LAYAR’s MySQL schema, the application reconstructs geospatial object layouts, interprets transformation and animation logic, and anchors them in a local coordinate system derived from averaged POI positions. The result is a modular, location-aware AR scene that can be previewed in Unity and exported as an asset bundle for seamless deployment to the Hoverlay AR platform.

The AR artwork “Dose” by Will Pappenheimer (2011 – 2014) on LAYAR (left) and on Unity, after the use of the Migration tool (right)

Workflow Overview
  1. Data Export (MySQL → JSON) Original LAYAR-based AR scenes are stored in MySQL tables, including: POI, geospatial anchors (latitude/longitude); Object, 3D model and asset references; Transform, local position, rotation, and scale; Animation, movement logic, orientation changes, and timed transformations. These are exported as structured JSON files for import into Unity.
  2. Coordinate Anchoring in Unity The application calculates the average of all POI coordinates to establish a single origin point for the scene. All POIs are converted into relative local coordinates from this internal anchor. Unity simulates the original real-world spatial arrangement using local coordinates, rather than using live GPS frameworks like AR Foundation or ARLocation.
  3. Scene Reconstruction Each AR object is instantiated and positioned based on: local transform values from the Transform table; additional animated translation from the Animation table (e.g., moving 1000 meters north); time-based behaviors are rebuilt using Unity’s Timeline or Animation system, preserving the narrative flow of the original experience.
  4. Hoverlay Digital Sequence Integration To make the reconstructed AR artworks viewable through the Hoverlay AR platform, the application integrates the Hoverlay Unity Exporter plugin—a tool that allows Unity assets to be bundled and published as interactive digital objects in Hoverlay Spaces. This plugin bridges the Unity environment and the Hoverlay app, ensuring that scenes created in Unity can be delivered as lightweight, optimized sequences for mobile and AR glasses.

The fully reconstructed scene is wrapped into a Hoverlay Digital Sequence, which includes: 3D object hierarchy and animation logic; Spatial metadata and initial placement; Descriptive data (title, description, tags). Sequences are prepared using the Hoverlay menu and formatted for upload to the Hoverlay backend. This integration ensures that AR scenes designed in Unity can be made publicly accessible and viewed via Hoverlay’s mobile AR interface.e

Unity Export with the Hoverlay Exporter
  • Supported 3D Models, Animations, Particle Effects, Audio, Lights, URP-compatible Shaders.
  • Not supported Custom MonoBehaviour scripts, Cameras.
Export process and deployment
  1. Install Unity 2022.3.19f1 with both iOS and Android Build Support modules.
  2. Create a new URP Unity project and import the Hoverlay Exporter package.
  3. Select the root GameObjects to be exported.
  4. Use the Hoverlay menu to export the project as platform-specific asset bundles.
  5. Upload the resulting ZIP files to Hoverlay Spaces as “Unity Asset Bundle” objects.
  6. Use the dashboard’s QR code to preview the objects live in the Hoverlay AR app.
  7. Once published, AR artworks can be experienced: through the Hoverlay Mobile App, on AR glasses or tablets, and at their original or newly defined GPS locations
Key Features
  • Migrates LAYAR-authored AR content using structured JSON exports.
  • Anchors scenes in Unity using averaged POI coordinates, not live GPS.
  • Accurately rebuilds visual, spatial, and temporal components of each AR scene.
  • Exports to the Hoverlay platform for public, location-based viewing.
Credits

Thi Anh Ngoc Nguyen ORCID, Arthur Clay LinkedIn (HSLU), Warren Armstrong.