Documentation

Multiplayer Services SDK

Multiplayer Services SDK

Session event delivery

Subscribe to real-time events to receive updates when lobby or player state changes occur.
Read time 1 minuteLast updated a day ago

Sessions use the Lobby service to store session and player data, so every session has an underlying lobby. When you create or join a session, the Multiplayer Services SDK subscribes to that lobby’s events, applies each change to the
ISession
object, and then raises the corresponding session events and session player events.
Events are sent every time member-observable player/lobby state is changed. For example, when a player joins or leaves, a player updates public/member data, or the host updates public/member lobby data. Events aren't sent if a player or the host updates a private property of the lobby.
The Multiplayer Services SDK handles all events automatically. When you create or join a session, the SDK maintains the event connection and automatically updates the internal state of the ISession object before any events are fired.
Using events is more efficient than repeatedly checking the lobby state through
gets
because you only receive updates when something changes. Events are useful if you would otherwise make many
get
requests per second. Event payloads are smaller as they only include the changes. However, events aren't always reliable and might arrive out of order.
Use the ISession interface to retrieve information on a lobby.
Refer to the Multiplayer Services package documentation for more information.

Additional resources