summaryrefslogtreecommitdiff
path: root/doc/classes/NetworkedMultiplayerPeer.xml
blob: a7350b3863bdcdd9521c549a774f6bee31c65484 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
<?xml version="1.0" encoding="UTF-8" ?>
<class name="NetworkedMultiplayerPeer" inherits="PacketPeer" category="Core" version="3.0-beta">
	<brief_description>
		A high-level network interface to simplify multiplayer interactions.
	</brief_description>
	<description>
		Manages the connection to network peers. Assigns unique IDs to each client connected to the server.
	</description>
	<tutorials>
	</tutorials>
	<demos>
	</demos>
	<methods>
		<method name="get_connection_status" qualifiers="const">
			<return type="int" enum="NetworkedMultiplayerPeer.ConnectionStatus">
			</return>
			<description>
				Returns the current state of the connection. See [enum ConnectionStatus].
			</description>
		</method>
		<method name="get_packet_peer" qualifiers="const">
			<return type="int">
			</return>
			<description>
				Returns the ID of the [code]NetworkedMultiplayerPeer[/code] who sent the most recent packet.
			</description>
		</method>
		<method name="get_unique_id" qualifiers="const">
			<return type="int">
			</return>
			<description>
				Returns the ID of this [code]NetworkedMultiplayerPeer[/code].
			</description>
		</method>
		<method name="is_refusing_new_connections" qualifiers="const">
			<return type="bool">
			</return>
			<description>
				Returns [code]true[/code] if this [code]NetworkedMultiplayerPeer[/code] refuses new connections. Default value: [code]false[/code].
			</description>
		</method>
		<method name="poll">
			<return type="void">
			</return>
			<description>
				Waits up to 1 second to receive a new network event.
			</description>
		</method>
		<method name="set_refuse_new_connections">
			<return type="void">
			</return>
			<argument index="0" name="enable" type="bool">
			</argument>
			<description>
				If [code]true[/code] this [code]NetworkedMultiplayerPeer[/code] refuses new connections. Default value: [code]false[/code].
			</description>
		</method>
		<method name="set_target_peer">
			<return type="void">
			</return>
			<argument index="0" name="id" type="int">
			</argument>
			<description>
				The peer to which packets will be sent. Default value: [code]0[/code].
			</description>
		</method>
		<method name="set_transfer_mode">
			<return type="void">
			</return>
			<argument index="0" name="mode" type="int" enum="NetworkedMultiplayerPeer.TransferMode">
			</argument>
			<description>
				The manner in which to send packets to the [code]target_peer[/code]. See [enum TransferMode].
			</description>
		</method>
	</methods>
	<signals>
		<signal name="connection_failed">
			<description>
				Emitted when a connection attempt fails.
			</description>
		</signal>
		<signal name="connection_succeeded">
			<description>
				Emitted when a connection attempt succeeds.
			</description>
		</signal>
		<signal name="peer_connected">
			<argument index="0" name="id" type="int">
			</argument>
			<description>
				Emitted by the server when a client connects.
			</description>
		</signal>
		<signal name="peer_disconnected">
			<argument index="0" name="id" type="int">
			</argument>
			<description>
				Emitted by the server when a client disconnects.
			</description>
		</signal>
		<signal name="server_disconnected">
			<description>
				Emitted by clients when the server disconnects.
			</description>
		</signal>
	</signals>
	<constants>
		<constant name="TRANSFER_MODE_UNRELIABLE" value="0" enum="TransferMode">
			Packets are sent via unordered UDP packets.
		</constant>
		<constant name="TRANSFER_MODE_UNRELIABLE_ORDERED" value="1" enum="TransferMode">
			Packets are sent via ordered UDP packets.
		</constant>
		<constant name="TRANSFER_MODE_RELIABLE" value="2" enum="TransferMode">
			Packets are sent via TCP packets.
		</constant>
		<constant name="CONNECTION_DISCONNECTED" value="0" enum="ConnectionStatus">
			The ongoing connection disconnected.
		</constant>
		<constant name="CONNECTION_CONNECTING" value="1" enum="ConnectionStatus">
			A connection attempt is ongoing.
		</constant>
		<constant name="CONNECTION_CONNECTED" value="2" enum="ConnectionStatus">
			The connection attempt succeeded.
		</constant>
		<constant name="TARGET_PEER_BROADCAST" value="0">
			Packets are sent to the server and then redistributed to other peers.
		</constant>
		<constant name="TARGET_PEER_SERVER" value="1">
			Packets are sent to the server alone.
		</constant>
	</constants>
</class>