Forward and Backward Compatibility
The Snapdragon Spaces SDK consists of two pieces.
- The runtime called Snapdragon Spaces Services which provides data for perception features to apps built with Snapdragon Spaces.
- 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.
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.
Snapdragon Spaces does not support Forward Compatibility where the Snapdragon Spaces Services version is lower Snapdragon Spaces Plugin version.
Examples
| VRX Firmware Image Version | Snapdragon Spaces Services Installed on Device | Snapdragon Spaces Plugin Used for an App | Compatibility |
|---|---|---|---|
| 933 | 0.19.3 | 0.21.0 | ✗ |
| 929 | 0.19.3 | 0.19.1.1 | ✓ |
| 929 | 0.19.3 | 0.17.0 | ✓ |
| 829 | 0.18.0 | 0.19.1.1 | ✗ |