Get SpatialOS



Reactive components

This document relates to the ECS workflow.

To represent state changes or messages from SpatialOS, the SpatialOS GDK for Unity (GDK) uses something we’re calling “reactive components”: ECS components that it adds to the relevant ECS entity for the duration of a tick.

When the GDK receives an update or message from SpatialOS, it places a “reactive component” on the associated ECS entity until the end of the tick. This reactive component contains a list of all the updates or messages received, so they can be processed by any system that you want to react to the change or message.

At the end of the tick, the GDK removes the reactive component.

Reactive component types

These are the types of reactive component available:

  1. ReceivedUpdates: All local and received SpatialOS component updates for the current SpatialOS entity.
  2. AuthorityChanges: Updates to the authority the current worker instance has over a SpatialOS component. See Authority for information on how this works.
  3. ReceivedEvents: All received events for the current entity. See Events for information on how this works.
  4. CommandRequests: All received command requests. See Commands for information on how this works.
  5. CommandResponses: All received command responses. See Commands for information on how this works.

Component Lifecycle tags

There are tags for handling the addition and removal of components:

  1. ComponentAdded: SpatialOS component has been added to the local view of a SpatialOS entity due to checkout of an entity or a change in interest.
  2. ComponentRemoved: SpatialOS component has been removed from the local view of a SpatialOS entity due to a change in interest.

Example of a system using a reactive component

public class ReactiveSystem : ComponentSystem
    public struct Data
        public readonly int Length;
        public ComponentDataArray<Position.ReceivedUpdates> PositionUpdates;

    [Inject] Data data;

    protected override void OnUpdate()
        for(var i = 0; i < data.Length; i++)
            var updates = data.PositionUpdates[i].Updates;
            foreach (var update in updates)
                if (update.Coords.HasValue)
                    // Do something

Removal of reactive components

The GDK automatically removes reactive components from the ECS entity as soon as CleanReactiveComponentsSystem is run. This means that you must run any logic processing that reactive component before CleanReactiveComponentsSystem. (This system is run at the end of each frame.)

Search results

Was this page helpful?

Thanks for letting us know!

Thanks for your feedback

Need more help? Ask on the forums