Skip to main content

Forward and Backward Compatibility

The Snapdragon Spaces SDK consists of two pieces.

  1. The runtime called Snapdragon Spaces Services which provides data for perception features to apps built with Snapdragon Spaces.
  2. The Snapdragon Spaces Plugin which is implemented into the actual application. The plugin can be considered as a simplified integration into an engine such as Unity or Unreal.

These two pieces communicate with each other via OpenXR. The plugin and runtime may have a different version.
In order for the two to communicate well with each other, backward and forward compatibility must be considered when creating and deploying an app on a Snapdragon Spaces enabled device.

Backward Compatibility

Backward Compatibility describes a scenario where an app built with a previous version of the Snapdragon Spaces Plugin can still run on a newer version of the Snapdragon Spaces Services.

tip

Snapdragon Spaces supports Backward Compatibility where the Snapdragon Spaces Services version is higher than Snapdragon Spaces Plugin version.

Forward Compatibility

Forward Compatibility describes a scenario where an app built with a later version of the Snapdragon Spaces Plugin can still run on an older version of the Snapdragon Spaces Services.

In a scenario with Forward Compatibility the result may be unexpected behavior, perception features not working correctly, or crashes.

danger

Snapdragon Spaces does not support Forward Compatibility where the Snapdragon Spaces Services version is lower Snapdragon Spaces Plugin version.

Examples

VRX Firmware Image VersionSnapdragon Spaces Services Installed on DeviceSnapdragon Spaces Plugin Used for an AppCompatibility
9330.19.30.21.0
9290.19.30.19.1.1
9290.19.30.17.0
8290.18.00.19.1.1