Class NetworkConnectionManager
The NGO connection manager handles:
- Client Connections
- Client Approval
- Processing NetworkEvents.
- Client Disconnection
Inherited Members
Namespace: Unity.Netcode
Assembly: Unity.Netcode.Runtime.dll
Syntax
public sealed class NetworkConnectionManager
Properties
DisconnectReason
When disconnected from the server, the server may send a reason. If a reason was sent, this property will provide disconnect information that will be followed by the server's disconnect reason.
Declaration
public string DisconnectReason { get; }
Property Value
| Type | Description |
|---|---|
| string |
Remarks
On a server or host, this value could no longer exist after all subscribed callbacks are invoked for the client that disconnected. It is recommended to copy the message to some other property or field when OnClientDisconnectCallback is invoked.
IsListening
Is true when a server or host is listening for connections. Is true when a client is connecting or connected to a network session. Is false when not listening, connecting, or connected.
Declaration
public bool IsListening { get; }
Property Value
| Type | Description |
|---|---|
| bool |
Events
OnClientConnectedCallback
The callback to invoke once a client connects. This callback is only ran on the server and on the local client that connects.
Declaration
public event Action<ulong> OnClientConnectedCallback
Event Type
| Type | Description |
|---|---|
| Action<ulong> |
OnClientDisconnectCallback
The callback to invoke when a client disconnects. This callback is only ran on the server and on the local client that disconnects.
Declaration
public event Action<ulong> OnClientDisconnectCallback
Event Type
| Type | Description |
|---|---|
| Action<ulong> |
OnConnectionEvent
The callback to invoke once a peer connects. This callback is only ran on the server and on the local client that connects.
Declaration
public event Action<NetworkManager, ConnectionEventData> OnConnectionEvent
Event Type
| Type | Description |
|---|---|
| Action<NetworkManager, ConnectionEventData> |
OnTransportFailure
The callback to invoke if the NetworkTransport fails.
Declaration
public event Action OnTransportFailure
Event Type
| Type | Description |
|---|---|
| Action |
Remarks
A failure of the transport is always followed by the NetworkManager shutting down. Recovering from a transport failure would normally entail reconfiguring the transport (e.g. re-authenticating, or recreating a new service allocation depending on the transport) and restarting the client/server/host.