6.713 NetworkServer - 《Unity 从入门到精通》

NetworkServer
- 静态属性
- 静态方法

NetworkServer

NetworkServer是一个管理来自多个客户端的连接的高级API类。

NetworkServer使用NetworkServerSimple实现基本的网络功能，并添加更多类似游戏的功能。

NetworkServer通过NetworkServerSimple实例处理来自远程客户端的远程连接，并且还具有本地客户端的本地连接。

NetworkServer是一个单例。它具有静态便利功能，如NetworkServer.SendToAll()和NetworkServer.Spawn()，它们自动使用单例实例。

NetworkManager使用NetworkServer，但可以在没有NetworkManager的情况下使用。

网络服务器管理已生成的一组网络对象。对象由NetworkServer.Spawn()生成，它将它们添加到此集合中，并使它们在客户端上创建。生成的对象在被销毁时会自动删除，或者通过调用NetworkServer.UnSpawn()从生成的集合中删除它们 - 这不会销毁该对象。

NetworkServer使用了许多内部消息，当NetworkServer.Listen()被调用时会设置这些消息。

静态属性

属性	功能
active	检查服务器是否已启动。
connections	来自客户端的所有当前连接的列表。
dontListen	如果启用此功能，则服务器将不侦听常规网络端口上的传入连接。
handlers	向服务器注册的消息处理程序字典。
hostTopology	服务器正在使用的主机拓扑。
listenPort	服务器正在侦听的端口。
localClientActive	如果本地客户端当前处于活动状态，则为真。
localConnections	服务器上的本地连接列表。
maxDelay	在连接上发送数据包之前的最大延迟。
networkConnectionClass	创建新网络连接时使用的类。
numChannels	网络配置的通道数量。
objects	这是一个已经在服务器上产生的网络对象的字典。
serverHostId	此服务器使用的传输层`hostId`。
useWebSockets	这使服务器侦听`WebSockets`连接而不是普通的传输层连接。

静态方法

方法	说明
AddExternalConnection	它接受来自另一个外部源的网络连接并将其添加到服务器。
AddPlayerForConnection	当`AddPlayer`消息处理程序收到来自玩家的请求时，服务器会调用此方法将玩家对象与连接相关联。
BecomeHost	这允许已经从服务器断开连接的客户端成为新版游戏的主机。
ClearHandlers	清除所有注册的回调处理程序。
ClearLocalObjects	这将清除服务器知道的所有网络对象。如果场景更改以正常方式删除所有对象而不以正常方式销毁它们，则可能需要这样做。
ClearSpawners	清除该服务器的所有已注册的`spawn`预制和生成处理函数。
Configure	这为服务器配置传输层设置。
Destroy	销毁此对象和所有客户端上的相应对象。
DestroyPlayersForConnection	这将销毁与服务器上的`NetworkConnections`关联的所有玩家对象。
DisconnectAll	断开所有当前连接的客户端。
FindLocalObject	这将找到具有指定网络ID的本地`NetworkIdentity`对象。
GetConnectionStats	获取所有连接的聚合数据包统计信息。
GetStatsIn	获取服务器的入站网络统计信息。
GetStatsOut	获取客户端的出站网络统计信息。
Listen	在给定的端口号上启动服务器。请注意，如果已创建匹配项，则将使用中继服务器而不是本地套接字来侦听。
ListenRelay	使用中继服务器启动服务器。这是使用中继服务器的手动方式，因为如果存在匹配项，常规`NetworkServer.Connect()`将自动使用中继服务器。
RegisterHandler	为特定的消息类型注册一个处理程序。
RemoveExternalConnection	这会删除添加了`AddExternalConnection()`的外部连接。
ReplacePlayerForConnection	这将替换玩家对象与不同玩家对象的连接。旧玩家对象不会被销毁。
Reset	重置`NetworkServer`单例。
ResetConnectionStats	重置所有连接上的数据包统计信息。
SendByChannelToAll	在指定的传输层QoS通道上向所有连接的客户端发送网络消息。
SendByChannelToReady	将网络消息发送到指定传输层QoS通道上的“就绪”所有连接的客户端。
SendBytesToPlayer	这将向特定玩家发送一个字节数组。
SendBytesToReady	这会向所有准备好的玩家发送一个字节数组。
SendToAll	将具有给定类型编号的消息结构发送给所有连接的客户端。
SendToClient	发送消息给拥有给定连接ID的客户端。
SendToClientOfPlayer	向拥有给定玩家对象实例的客户端发送消息。
SendToReady	将具有给定类型编号的消息结构发送给只有准备好的客户端。
SendUnreliableToAll	将给定的消息结构作为不可靠的消息发送给所有连接的客户端。
SendUnreliableToReady	发送给定的消息结构仅作为不可靠的消息给已准备好的客户端。
SendWriterToReady	将`NetworkWriter`对象的内容发送给准备好的玩家。
SetAllClientsNotReady	将所有连接的客户端标记为不再准备好。
SetClientNotReady	将连接的客户端设置为未准备好。
SetClientReady	设置客户端准备就绪。
SetNetworkConnectionClass	这设置创建新网络连接时使用的类。
Shutdown	这会关闭服务器并断开所有客户端的连接。
Spawn	在准备好的所有客户端上产生给定的游戏对象。
SpawnObjects	这会导致场景中的`NetworkIdentity`对象在服务器上生成。
SpawnWithClientAuthority	这会产生一个像`NetworkServer.Spawn()`这样的对象，但也会将`Client Authority`分配给指定的客户端。
UnregisterHandler	取消注册特定消息类型的处理程序。
UnSpawn	这需要一个已经衍生出来的对象并且不会产生它。