Spatial Awareness System
The Mixed Reality Toolkit's Spatial Awareness System enables applications to interact with surfaces in the user's world. From placing items on real-world surfaces to opening magic windows in walls, spatial awareness helps immerse users in your application.
To use spatial awareness, the following requirements must be met.
- The application is running on hardware that provides environmental data (ex: Microsoft HoloLens).
- One or more spatial awareness observers are registered in the Additional Service Providers profile.
The Spatial Awareness system uses registered observers to provide components (ex: meshes) that represent the real-world environment. Each observer is responsible for creating and managing the components provided.
Spatial Awareness Settings
For platforms supporting environmental awareness, enabling the Sptial Awarness System will start the specified system type and begin communicating with registered observers.
The Mixed Reality Toolkit provides application developers the ability to select the default Spatial Awareness System implementation (Microsoft.MixedReality.Toolkit.Services.SpatialAwarenessSystem.MixedRealitySpatialAwarenessSystem), a version from an installed extension or a custom implementation written by the developer.
Spatial Awareness System Type Selection
Spatial observers are generally platform specific and are generally provided as part of a Mixed Reality Toolkit platform or extension package. Spatial observers are registered in the Additional Service Providers profile.
Windows Mixed Reality Spatial Mesh Observer registration
All spatial observer profiles are to inherit from the IMixedRealitySpatialAwarenessObserver interface. This interface specified the general settings to be implemented by all observers.
When registering a spatial observer, it is important to specify the appropriate type of profile, in this example, a Spatial Awareness Mesh Observer Profile. Failing to do so may limit the functionality of the observer and your application.
- Mixed Reality Toolkit Profile
- Additional Service Providers Profile
- Spatial Awareness Mesh Observer Profile
- Implementing a Custom Spatial Awareness System
- Implementing a Spatial Awareness Observer
- Spatial Awareness Example
- Spatial Mapping (docs.microsoft.com)