This class provides a ready-to-use encapsulation that leverages the OVRColocationSession APIs to host and discover local / nearby Colocation sessions and join them via Bluetooth and WiFi.

Comparing to networking framework based matchmaking: this workflow ensures users are all locally nearby, and there's no need for using Oculus user ids when colocating within the group (this requires working together with the Colocation block with the "Use Colocation Session" option enabled).

All players wish to participate in the same session need to have Bluetooth enabled and join the same WiFi network.

As the local session provided by OVRColocationSession is just a mechanism to find nearby players and send limited metadata for matchmaking, it doesn't really allow synchronizing networked objects and support multiplayer game logic. Hence, for the benefit of bootstrapping a local multiplayer session easily, this implementation also depends on the CustomMatchmaking block to create and join networked rooms provided by 3p networking frameworks (such as Photon Fusion2, Unity Netcode for GameObjects).

This class provides an automatic mechanism to host/join local sessions on Start() depending on whether an existing colocation sessions available.

For more information about the OVRColocationSession API, checkout the official documentation

If wish to explicitly host / join the session with own game UI, developers could also use several async functions provided to trigger manually.

Public Statics

static readonly UnityEvent< Guid > OnSessionCreateSucceeded[Get]

Event to notify when a colocation session has been created and advertised successfully by the host.

Guid: group uuid that can be used to share anchors via OVRSpatialAnchor.ShareAsync

static readonly UnityEvent< string > OnSessionCreateFailed[Get]

Event to notify when failed to create and advertise the colocation session.

string: failure reason, could be potentially used to display instruction to users

static readonly UnityEvent< Guid > OnSessionDiscoverSucceeded[Get]

Event to notify when a colocation session has been discovered successfully by the guest.

Guid: group uuid that can be used to retrieve anchors via OVRSpatialAnchor.LoadUnboundSharedAnchorsAsync

static readonly UnityEvent< string > OnSessionDiscoverFailed[Get]

Event to notify when failed to discover the colocation session.

string: failure reason, could be potentially used to display instruction to users

Member Functions

async Task StartAsHost ( )

Manually start as host, this will create a networked room under the hood by CustomMatchmaking, and in turn this class listens for the networked room creation event then broadcast the room information via the OVRColocationSession API.

async Task StartAsGuest

( bool stopAfterTimeout )

Manually start as guest, this will discover colocation sessions via the OVRColocationSession API, then stop after timeDiscoveringInSec if setting stopAfterTimeout is set to true.

Parameters

stopAfterTimeout

Boolean to determine whether to automatically stop the discovery after timeDiscoveringInSec