Unity Script Reference

Network

The network class is at the heart of the network implementation and provides the core functions.

This class configures the network interface and all the network parameters. You use it to set up a server or connect to one and have a row of helper functions to help you with those tasks. For more information on what is exposed in the editor see the Network Manger component reference.

Messages Sent

OnPlayerConnected	Called on the server whenever a new player has successfully connected.
OnServerInitialized	Called on the server whenever a Network.InitializeServer was invoked and has completed.
OnConnectedToServer	Called on the client when you have successfully connected to a server
OnPlayerDisconnected	Called on the server whenever a player is disconnected from the server
OnDisconnectedFromServer	Called on client during disconnection from server, but also on the server when the connection has disconnected.
OnFailedToConnect	Called on the client when a connection attempt fails for some reason.
OnFailedToConnectToMasterServer	Called on clients or servers when there is a problem connecting to the master server.
OnNetworkInstantiate	Called on objects which have been network instantiated with Network.Instantiate
OnSerializeNetworkView	Used to customize synchronization of variables in a script watched by a network view.

Class Variables

incomingPassword	Set the password for the server (for incoming connections).
logLevel	Set the log level for network messages (default is Off).
connections	All connected players.
player	Get the local NetworkPlayer instance
isClient	Returns true if your peer type is client.
isServer	Returns true if your peer type is server.
peerType	The status of the peer type, i.e. if it is disconnected, connecting, server or client.
sendRate	The default send rate of network updates for all Network Views.
isMessageQueueRunning	Enable or disable the processing of network messages.
time	Get the current network time (seconds).
minimumAllocatableViewIDs	Get or set the minimum number of ViewID numbers in the ViewID pool given to clients by the server.
natFacilitatorIP	The IP address of the NAT punchthrough facilitator.
natFacilitatorPort	The port of the NAT punchthrough facilitator.
connectionTesterIP	The IP address of the connection tester used in Network.TestConnection.
connectionTesterPort	The port of the connection tester used in Network.TestConnection.
maxConnections	Set the maximum amount of connections/players allowed.
proxyIP	The IP address of the proxy server.
proxyPort	The port of the proxy server.
useProxy	Indicate if proxy support is needed, in which case traffic is relayed through the proxy server.
proxyPassword	Set the proxy server password.

Class Functions

InitializeServer	Initialize the server.
InitializeSecurity	Initializes security layer.
Connect	Connect to the specified host (ip or domain name) and server port.
Disconnect	Close all open connections and shuts down the network interface.
CloseConnection	Close the connection to another system.
AllocateViewID	Query for the next available network view ID number and allocate it (reserve).
Instantiate	Network instantiate a prefab.
Destroy	Destroy the object associated with this view ID across the network.
DestroyPlayerObjects	Destroy all the objects based on view IDs belonging to this player.
RemoveRPCs	Remove all RPC functions which belong to this player ID.
RemoveRPCsInGroup	Remove all RPC functions which belong to given group number.
RemoveRPCs	Remove the RPC function calls accociated with this view ID number.
SetLevelPrefix	Set the level prefix which will then be prefixed to all network ViewID numbers.
GetLastPing	The last ping time to the given player in milliseconds.
GetAveragePing	The last average ping time to the given player in milliseconds.
SetReceivingEnabled	Enable or disables the reception of messages in a specific group number from a specific player.
SetSendingEnabled	Enables or disables transmission of messages and RPC calls on a specific network group number.
TestConnection	Test this machines network connection.
TestConnectionNAT	Test the connecction specifically for NAT punchthrough connectivity.
HavePublicAddress	Check if this machine has a public IP address.