Class SessionOptionsExtensions
Provides extension methods to configure session networking options.
Inherited Members
Namespace: Unity.Services.Multiplayer
Assembly: Unity.Services.Multiplayer.dll
Syntax
public static class SessionOptionsExtensionsMethods
WithDirectNetwork<T>(T, string, string, int)
Configures a session to use direct networking and accept connections at the specified address.
Declaration
public static T WithDirectNetwork<T>(this T options, string listenIp = "127.0.0.1", string publishIp = "127.0.0.1", int port = 0) where T : SessionOptionsParameters
| Type | Name | Description |
|---|---|---|
| T | options | The SessionOptions this extension method applies to. |
| string | listenIp | Listen for incoming connection at this address ("0.0.0.0" for all interfaces). |
| string | publishIp | Address that clients should use when connecting |
| int | port | Port to listen for incoming connections and also the one to use by clients |
Returns
| Type | Description |
|---|---|
| T | The session options |
Type Parameters
| Name | Description |
|---|---|
| T | The options' type. |
Remarks
Using direct networking in client-hosted games reveals the IP address of players to the host. For client-hosted games, using Relay or Distributed Authority is recommended to handle NAT, firewalls and protect player privacy.
The default values allow local connections only and use 127.0.0.1 as the listenIp
and publishIp. To listen on all interfaces, use 0.0.0.0 as the listenIp and specify the
external/public IP address that clients should use as the publishIp.
The port number defaults to 0 which selects a randomly available port on the machine and uses the chosen value as the publish port. If a non-zero value is used, the port number applies to both listen and publish addresses.
WithNetworkHandler<T>(T, INetworkHandler)
Configures a session to use a custom network handler.
Declaration
public static T WithNetworkHandler<T>(this T options, INetworkHandler networkHandler) where T : BaseSessionOptionsParameters
| Type | Name | Description |
|---|---|---|
| T | options | The SessionOptions this extension method applies to. |
| INetworkHandler | networkHandler | The INetworkHandler to use |
Returns
| Type | Description |
|---|---|
| T | The session options |
Type Parameters
| Name | Description |
|---|---|
| T | The options' type. |
Remarks
When a network handler is provided, it disables the default integration with Netcode for Game Objects and Netcode for Entities.
Combine this option with another networking option (WithDirectNetwork<T>(T, string, string, int), WithRelayNetwork<T>(T, string), WithDistributedAuthorityNetwork<T>) to obtain the appropriate data to implement a custom management of the netcode library and/or transport library.
This option applies to all session flows and is normally set for all roles (host, server, client).
WithRelayNetwork<T>(T, string)
Configures a session to use Relay networking.
Declaration
public static T WithRelayNetwork<T>(this T options, string region = null) where T : SessionOptionsParameters
| Type | Name | Description |
|---|---|---|
| T | options | The SessionOptions this extension method applies to. |
| string | region | Force a specific Relay region to be used and skip auto-selection from QoS. |
Returns
| Type | Description |
|---|---|
| T | The session options |
Type Parameters
| Name | Description |
|---|---|
| T | The options' type. |
Remarks
The region is optional; the default behavior is to perform quality of service (QoS) measurements and pick the lowest latency region. The list of regions can be obtained from the Relay Allocations Service via ListRegionsAsync().