Skip to main content
Version: 3.2

Neural Network Model Preloading

Lightship's awareness features, such as Depth and Semantic Segmentation, rely on neural network models to know how to draw each pixel in an AR environment. Because these models are not included with ARDK, the application must download and install them before the features can provide output, resulting in long load times that can negatively impact the user experience. To prevent this, Lightship provides the Model Preloading feature, allowing applications to download the model beforehand and avoid startup latency when using awareness features.

Applications can either register an existing model file or request that ARDK download one. Either way, once preloaded, the model file will remain stored in the application's cache until cleared by uninstallation and will load at runtime.

Known Limitations

  • Model Preloading saves model files to the application cache. Model decryption still occurs when the subsystem starts, so some latency is still expected when starting awareness features.
  • Custom model file registrations from previous sessions are not retained. Lightship defaults to the model file definitions in the ARDK config file and RegisterModel overrides the corresponding feature mode for the current session. To bypass this limitation, developers can either re-register the model file each time or add the full path to their ARDK config file.

More Information

See How to Use Neural Network Model Preloading for details on using this feature in your Lightship project.