CoherenceTagQuery

In addition to filtering object by distance using a LiveQuery, coherence also supports filtering objects by tag with CoherenceLiveQuery. This is useful when you have some special objects that should always be visible regardless of their position.

The tag used by the CoherenceTagQuery component is not based on Unity's tag system.

Having at least one query in the scene is necessary to receive any network update!

Using TagQueries

To create a TagQuery, right click a GameObject in the scene and select coherence > TagQuery from the context menu.

CoherenceTagQuery component

All networked GameObjects with matching tags will now be visible to the Client. The coherence tag can be any string and can be configured in the Advanced Settings section of the CoherenceSync component.

Tags and TagQueries can be updated at any time while the application is running, either from the Unity inspector or setting CoherenceSync.coherenceTag and CoherenceTagQuery.coherenceTag in code.

Multiple tags can be combined in a single TagQuery or tag on the CoherenceSync object as multiple strings comma-delimted or delimited by "|". Eg.: "red|blue". This example will match either "red" or "blue" or both.

All tags are compared case insensitive and white space is trimmed.

In the future, we plan to integrate TagQueries with LiveQueries allowing combined query restrictions, e.g., only show objects with tag "red" within an extent of 50.

Limits

The Replication Server imposes limits on number of queries a Client can create. Read more about it in the Replication Server section.