virtualx-engine/doc/classes/NetworkedMultiplayerPeer.xml

<?xml version="1.0" encoding="UTF-8" ?>
<class name="NetworkedMultiplayerPeer" inherits="PacketPeer" category="Core" version="3.2">
	<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>
		<link>https://docs.godotengine.org/en/latest/tutorials/networking/high_level_multiplayer.html</link>
	</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 [NetworkedMultiplayerPeer] 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 [NetworkedMultiplayerPeer].
			</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_target_peer">
			<return type="void">
			</return>
			<argument index="0" name="id" type="int">
			</argument>
			<description>
				Sets the peer to which packets will be sent.
				The [code]id[/code] can be one of: [code]TARGET_PEER_BROADCAST[/code] to send to all connected peers, [code]TARGET_PEER_SERVER[/code] to send to the peer acting as server, a valid peer ID to send to that specific peer, a negative peer ID to send to all peers except that one. Default: [code]TARGET_PEER_BROADCAST[/code]
			</description>
		</method>
	</methods>
	<members>
		<member name="refuse_new_connections" type="bool" setter="set_refuse_new_connections" getter="is_refusing_new_connections">
			If [code]true[/code], this [NetworkedMultiplayerPeer] refuses new connections. Default value: [code]false[/code].
		</member>
		<member name="transfer_mode" type="int" setter="set_transfer_mode" getter="get_transfer_mode" enum="NetworkedMultiplayerPeer.TransferMode">
			The manner in which to send packets to the [code]target_peer[/code]. See [enum TransferMode].
		</member>
	</members>
	<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 not acknowledged, no resend attempts are made for lost packets. Packets may arrive in any order. Potentially faster than [code]TRANSFER_MODE_UNRELIABLE_ORDERED[/code]. Use for non-critical data, and always consider whether the order matters.
		</constant>
		<constant name="TRANSFER_MODE_UNRELIABLE_ORDERED" value="1" enum="TransferMode">
			Packets are not acknowledged, no resend attempts are made for lost packets. Packets are received in the order they were sent in. Potentially faster than [code]TRANSFER_MODE_RELIABLE[/code]. Use for non-critical data or data that would be outdated if received late due to resend attempt(s) anyway, for example movement and positional data.
		</constant>
		<constant name="TRANSFER_MODE_RELIABLE" value="2" enum="TransferMode">
			Packets must be received and resend attempts should be made until the packets are acknowledged. Packets must be received in the order they were sent in. Most reliable transfer mode, but potentially slowest due to the overhead. Use for critical data that must be transmitted and arrive in order, for example an ability being triggered or a chat message. Consider carefully if the information really is critical, and use sparingly.
		</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>