Adapters

Abstraction layer for pluggable multiplayer service backends in the Network system. Defines the IServiceAdapter interface that all service implementations must satisfy, enabling the network system to support multiple providers (Unity Gaming Services, Steam, Epic) behind a single API.

Architecture

Data Flow

Key Concepts

Concept	Description
IServiceAdapter	Interface defining the contract for all multiplayer service backends — initialize, authenticate, and manage sessions
NetworkServiceType	Enum identifying the active service provider (UNITY, STEAM, EPIC)
UnityServiceAdapter	Concrete adapter implementing IServiceAdapter using Unity Gaming Services (Authentication + Multiplayer)
UnityNetworkSession	Concrete NetworkSession wrapping Unity's ISession with leave, kick, and refresh capabilities
UnityThreadUtils	Internal utility that captures Unity's main thread context via reflection, required before UnityServices.InitializeAsync()

Extension Pattern

To add a new service backend (e.g., Steam):

1. Create a class implementing IServiceAdapter

2. Set ServiceType to the corresponding NetworkServiceType enum value

3. Implement all async methods using the platform's SDK

4. Create a concrete NetworkSession subclass for the platform's session type

5. Register the adapter in NetworkService for the new NetworkServiceType

internal class SteamServiceAdapter : IServiceAdapter
{
    public NetworkServiceType ServiceType => NetworkServiceType.STEAM;

    public async Task Initialize() { /* Steamworks init */ }
    public async Task<NetworkUser> SignIn() { /* Steam auth */ }
    public async Task SignOut() { /* Steam sign out */ }
    public async Task<List<NetworkSessionInfo>> QuerySessions(QuerySessionsOptions options = null) { /* Steam lobby query */ }
    public async Task<NetworkSession> CreateSession(string name, int maxConnections = 4) { /* Create Steam lobby */ }
    public async Task<NetworkSession> JoinSession(string sessionID) { /* Join Steam lobby */ }
}

Classes

Class	Description
IServiceAdapter	Interface defining the multiplayer service backend contract
UnityServiceAdapter	Unity Gaming Services implementation of IServiceAdapter
UnityNetworkSession	NetworkSession implementation wrapping Unity's ISession
UnityThreadUtils	Reflection-based utility for capturing Unity's main thread context

See Also

• Network — system overview

• NetworkManager — singleton entry point that delegates to NetworkService

• Unity Adapters — Unity Gaming Services adapter details