Version: 2017.1

Network

class in UnityEngine

切换到手册

描述

Network 类处于网络实现的核心地位,提供了核心函数。

该类配置网络接口和所有网络参数。可用于设置或连接到服务器, 并通过一系列 Helper 函数帮助您完成相关任务。 有关 Editor 中公开的相关功能的更多信息,请参阅 Network Manger component reference

静态变量

connections所有连接的玩家。
connectionTesterIPNetwork.TestConnection 中使用的连接测试器的 IP 地址。
connectionTesterPortNetwork.TestConnection 中使用的连接测试器的端口。
incomingPassword为服务器设置密码(用于传入连接)。
isClient如果对等方是客户端,则返回 true。
isMessageQueueRunning启用或禁用网络消息的处理。
isServer如果对等方是服务器,则返回 true。
logLevel为网络消息设置日志级别(默认为 Off)
maxConnections设置连接/玩家的最大允许数量。
minimumAllocatableViewIDs获取或设置服务器为客户端指定的 ViewID 池中的 ViewID 号的最低数量。
natFacilitatorIPNAT 穿透协调程序的 IP 地址。
natFacilitatorPortNAT 穿透协调程序的端口。
peerType对等方类型的状态,即是否断开连接、是否正在连接,是服务器还是客户端。
player获取 NetworkPlayer 的本地实例。
proxyIP代理服务器的 IP 地址。
proxyPassword设置代理服务器的密码。
proxyPort代理服务器的端口。
sendRate所有网络视图的网络更新的默认发送频率。
time获取当前网络时间(秒)。
useProxy指示是否需要代理支持,在这种情况下,流量将通过代理服务器中继。

静态函数

AllocateViewID查询下一个可用的网络视图 ID 号并进行分配(保留)
CloseConnection关闭与另一个系统的连接。
Connect连接到指定的主机(IP 或域名)和服务器端口。
Destroy通过网络销毁与此 viewID 关联的对象。
DestroyPlayerObjects基于属于此玩家的 viewID 销毁所有对象。
Disconnect关闭所有打开的连接并关闭网络接口。
GetAveragePing给定/玩家/的最近平均 ping 时间(毫秒)
GetLastPing给定 player 的最近一次 ping 时间(毫秒)
HavePublicAddress检查该计算机是否具有公共 IP 地址。
InitializeSecurity初始化安全性层。
InitializeServer初始化服务器。
Instantiate网络实例化预制件。
RemoveRPCs删除所有属于该玩家 ID 的 RPC 函数。
RemoveRPCsInGroup删除所有属于给定组编号的 RPC 函数。
SetLevelPrefix设置附加到网络 ViewID 号的级别前缀。
SetReceivingEnabled对特定组编号启用或禁用接收来自某个特定玩家的消息。
SetSendingEnabled对特定网络组编号启用或禁用消息传输和 RPC 调用。
TestConnection测试此机器的网络连接。
TestConnectionNAT特别针对 NAT 穿透连接性进行测试。

消息

OnConnectedToServer成功连接到服务器后在客户端上调用。
OnDisconnectedFromServer从服务器断开连接期间在客户端上调用,当连接已经断开后也会在服务器上调用。
OnFailedToConnect出于某种原因连接尝试失败时,在客户端上调用。
OnNetworkInstantiate在已通过 Network.Instantiate 进行网络实例化的对象上调用。
OnPlayerConnected每当有新玩家成功连接,就在服务器上调用。
OnPlayerDisconnected每当有玩家与服务器断开连接,就在服务器上调用。
OnSerializeNetworkView用于在网络视图监视的脚本中自定义变量同步。
OnServerInitialized每当调用 Network.InitializeServer 并且完成时,对该服务器调用该函数。