Legacy Documentation: Version 5.6 (Go to current version)
LanguageEnglish
  • C#
  • JS

Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

HostTopology

class in UnityEngine.Networking

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Description

Class defines network topology for host (socket opened by NetworkTransport.AddHost function). This topology defines: (1) how many connection with default config will be supported and (2) what will be special connections (connections with config different from default).

Example: p2p game with 10 people in the room and connection to chat server, in this case it will be 10 default connections and one special.

The NetworkServer and NetworkClient classed can be configured with a HostTopology instance.

Variables

DefaultConfigDefines config for default connections in the topology.
MaxDefaultConnectionsDefines how many connection with default config be permitted.
ReceivedMessagePoolSizeDefines the maximum number of messages that each host can hold in its pool of received messages. The default size is 128.
SentMessagePoolSizeDefines the maximum number of messages that each host can hold in its pool of messages waiting to be sent. The default size is 128.
SpecialConnectionConfigsList of special connection configs.
SpecialConnectionConfigsCountReturns count of special connection added to topology.

Constructors

HostTopologyCreate topology.

Public Functions

AddSpecialConnectionConfigAdd special connection to topology (for example if you need to keep connection to standalone chat server you will need to use this function). Returned id should be use as one of parameters (with ip and port) to establish connection to this server.
GetSpecialConnectionConfigReturn reference to special connection config. Parameters of this config can be changed.