mirror of
https://github.com/godotengine/godot-docs.git
synced 2025-12-31 17:49:03 +03:00
classref: Sync with current master branch (f87858a8f)
This commit is contained in:
Yuri Sizov
@@ -12,10 +12,12 @@ MultiplayerPeer
|
||||
|
||||
**Inherits:** :ref:`PacketPeer<class_PacketPeer>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
|
||||
|
||||
**Inherited By:** :ref:`ENetMultiplayerPeer<class_ENetMultiplayerPeer>`, :ref:`MultiplayerPeerExtension<class_MultiplayerPeerExtension>`, :ref:`WebRTCMultiplayerPeer<class_WebRTCMultiplayerPeer>`, :ref:`WebSocketMultiplayerPeer<class_WebSocketMultiplayerPeer>`
|
||||
**Inherited By:** :ref:`ENetMultiplayerPeer<class_ENetMultiplayerPeer>`, :ref:`MultiplayerPeerExtension<class_MultiplayerPeerExtension>`, :ref:`OfflineMultiplayerPeer<class_OfflineMultiplayerPeer>`, :ref:`WebRTCMultiplayerPeer<class_WebRTCMultiplayerPeer>`, :ref:`WebSocketMultiplayerPeer<class_WebSocketMultiplayerPeer>`
|
||||
|
||||
Abstract class for specialized :ref:`PacketPeer<class_PacketPeer>`\ s used by the :ref:`MultiplayerAPI<class_MultiplayerAPI>`.
|
||||
|
||||
.. rst-class:: classref-introduction-group
|
||||
|
||||
Description
|
||||
-----------
|
||||
|
||||
@@ -25,6 +27,8 @@ Manages the connection with one or more remote peers acting as server or client
|
||||
|
||||
\ **Note:** When exporting to Android, make sure to enable the ``INTERNET`` permission in the Android export preset before exporting the project or using one-click deploy. Otherwise, network communication of any kind will be blocked by Android.
|
||||
|
||||
.. rst-class:: classref-introduction-group
|
||||
|
||||
Tutorials
|
||||
---------
|
||||
|
||||
@@ -32,246 +36,373 @@ Tutorials
|
||||
|
||||
- `WebRTC Signaling Demo <https://godotengine.org/asset-library/asset/537>`__
|
||||
|
||||
.. rst-class:: classref-reftable-group
|
||||
|
||||
Properties
|
||||
----------
|
||||
|
||||
+--------------------------------------------------------+--------------------------------------------------------------------------------------+-----------+
|
||||
| :ref:`bool<class_bool>` | :ref:`refuse_new_connections<class_MultiplayerPeer_property_refuse_new_connections>` | ``false`` |
|
||||
+--------------------------------------------------------+--------------------------------------------------------------------------------------+-----------+
|
||||
| :ref:`int<class_int>` | :ref:`transfer_channel<class_MultiplayerPeer_property_transfer_channel>` | ``0`` |
|
||||
+--------------------------------------------------------+--------------------------------------------------------------------------------------+-----------+
|
||||
| :ref:`TransferMode<enum_MultiplayerPeer_TransferMode>` | :ref:`transfer_mode<class_MultiplayerPeer_property_transfer_mode>` | ``2`` |
|
||||
+--------------------------------------------------------+--------------------------------------------------------------------------------------+-----------+
|
||||
.. table::
|
||||
:widths: auto
|
||||
|
||||
+--------------------------------------------------------+--------------------------------------------------------------------------------------+-----------+
|
||||
| :ref:`bool<class_bool>` | :ref:`refuse_new_connections<class_MultiplayerPeer_property_refuse_new_connections>` | ``false`` |
|
||||
+--------------------------------------------------------+--------------------------------------------------------------------------------------+-----------+
|
||||
| :ref:`int<class_int>` | :ref:`transfer_channel<class_MultiplayerPeer_property_transfer_channel>` | ``0`` |
|
||||
+--------------------------------------------------------+--------------------------------------------------------------------------------------+-----------+
|
||||
| :ref:`TransferMode<enum_MultiplayerPeer_TransferMode>` | :ref:`transfer_mode<class_MultiplayerPeer_property_transfer_mode>` | ``2`` |
|
||||
+--------------------------------------------------------+--------------------------------------------------------------------------------------+-----------+
|
||||
|
||||
.. rst-class:: classref-reftable-group
|
||||
|
||||
Methods
|
||||
-------
|
||||
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| void | :ref:`close<class_MultiplayerPeer_method_close>` **(** **)** |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| void | :ref:`disconnect_peer<class_MultiplayerPeer_method_disconnect_peer>` **(** :ref:`int<class_int>` peer, :ref:`bool<class_bool>` force=false **)** |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| :ref:`int<class_int>` | :ref:`generate_unique_id<class_MultiplayerPeer_method_generate_unique_id>` **(** **)** |const| |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| :ref:`ConnectionStatus<enum_MultiplayerPeer_ConnectionStatus>` | :ref:`get_connection_status<class_MultiplayerPeer_method_get_connection_status>` **(** **)** |const| |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| :ref:`int<class_int>` | :ref:`get_packet_channel<class_MultiplayerPeer_method_get_packet_channel>` **(** **)** |const| |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| :ref:`TransferMode<enum_MultiplayerPeer_TransferMode>` | :ref:`get_packet_mode<class_MultiplayerPeer_method_get_packet_mode>` **(** **)** |const| |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| :ref:`int<class_int>` | :ref:`get_packet_peer<class_MultiplayerPeer_method_get_packet_peer>` **(** **)** |const| |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| :ref:`int<class_int>` | :ref:`get_unique_id<class_MultiplayerPeer_method_get_unique_id>` **(** **)** |const| |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| :ref:`bool<class_bool>` | :ref:`is_server_relay_supported<class_MultiplayerPeer_method_is_server_relay_supported>` **(** **)** |const| |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| void | :ref:`poll<class_MultiplayerPeer_method_poll>` **(** **)** |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| void | :ref:`set_target_peer<class_MultiplayerPeer_method_set_target_peer>` **(** :ref:`int<class_int>` id **)** |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
.. table::
|
||||
:widths: auto
|
||||
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| void | :ref:`close<class_MultiplayerPeer_method_close>` **(** **)** |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| void | :ref:`disconnect_peer<class_MultiplayerPeer_method_disconnect_peer>` **(** :ref:`int<class_int>` peer, :ref:`bool<class_bool>` force=false **)** |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| :ref:`int<class_int>` | :ref:`generate_unique_id<class_MultiplayerPeer_method_generate_unique_id>` **(** **)** |const| |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| :ref:`ConnectionStatus<enum_MultiplayerPeer_ConnectionStatus>` | :ref:`get_connection_status<class_MultiplayerPeer_method_get_connection_status>` **(** **)** |const| |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| :ref:`int<class_int>` | :ref:`get_packet_channel<class_MultiplayerPeer_method_get_packet_channel>` **(** **)** |const| |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| :ref:`TransferMode<enum_MultiplayerPeer_TransferMode>` | :ref:`get_packet_mode<class_MultiplayerPeer_method_get_packet_mode>` **(** **)** |const| |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| :ref:`int<class_int>` | :ref:`get_packet_peer<class_MultiplayerPeer_method_get_packet_peer>` **(** **)** |const| |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| :ref:`int<class_int>` | :ref:`get_unique_id<class_MultiplayerPeer_method_get_unique_id>` **(** **)** |const| |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| :ref:`bool<class_bool>` | :ref:`is_server_relay_supported<class_MultiplayerPeer_method_is_server_relay_supported>` **(** **)** |const| |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| void | :ref:`poll<class_MultiplayerPeer_method_poll>` **(** **)** |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
| void | :ref:`set_target_peer<class_MultiplayerPeer_method_set_target_peer>` **(** :ref:`int<class_int>` id **)** |
|
||||
+----------------------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------+
|
||||
|
||||
.. rst-class:: classref-section-separator
|
||||
|
||||
----
|
||||
|
||||
.. rst-class:: classref-descriptions-group
|
||||
|
||||
Signals
|
||||
-------
|
||||
|
||||
.. _class_MultiplayerPeer_signal_peer_connected:
|
||||
|
||||
- **peer_connected** **(** :ref:`int<class_int>` id **)**
|
||||
.. rst-class:: classref-signal
|
||||
|
||||
**peer_connected** **(** :ref:`int<class_int>` id **)**
|
||||
|
||||
Emitted when a remote peer connects.
|
||||
|
||||
.. rst-class:: classref-item-separator
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeer_signal_peer_disconnected:
|
||||
|
||||
- **peer_disconnected** **(** :ref:`int<class_int>` id **)**
|
||||
.. rst-class:: classref-signal
|
||||
|
||||
**peer_disconnected** **(** :ref:`int<class_int>` id **)**
|
||||
|
||||
Emitted when a remote peer has disconnected.
|
||||
|
||||
.. rst-class:: classref-section-separator
|
||||
|
||||
----
|
||||
|
||||
.. rst-class:: classref-descriptions-group
|
||||
|
||||
Enumerations
|
||||
------------
|
||||
|
||||
.. _enum_MultiplayerPeer_ConnectionStatus:
|
||||
|
||||
.. _class_MultiplayerPeer_constant_CONNECTION_DISCONNECTED:
|
||||
|
||||
.. _class_MultiplayerPeer_constant_CONNECTION_CONNECTING:
|
||||
|
||||
.. _class_MultiplayerPeer_constant_CONNECTION_CONNECTED:
|
||||
.. rst-class:: classref-enumeration
|
||||
|
||||
enum **ConnectionStatus**:
|
||||
|
||||
- **CONNECTION_DISCONNECTED** = **0** --- The MultiplayerPeer is disconnected.
|
||||
.. _class_MultiplayerPeer_constant_CONNECTION_DISCONNECTED:
|
||||
|
||||
- **CONNECTION_CONNECTING** = **1** --- The MultiplayerPeer is currently connecting to a server.
|
||||
.. rst-class:: classref-enumeration-constant
|
||||
|
||||
- **CONNECTION_CONNECTED** = **2** --- This MultiplayerPeer is connected.
|
||||
:ref:`ConnectionStatus<enum_MultiplayerPeer_ConnectionStatus>` **CONNECTION_DISCONNECTED** = ``0``
|
||||
|
||||
The MultiplayerPeer is disconnected.
|
||||
|
||||
.. _class_MultiplayerPeer_constant_CONNECTION_CONNECTING:
|
||||
|
||||
.. rst-class:: classref-enumeration-constant
|
||||
|
||||
:ref:`ConnectionStatus<enum_MultiplayerPeer_ConnectionStatus>` **CONNECTION_CONNECTING** = ``1``
|
||||
|
||||
The MultiplayerPeer is currently connecting to a server.
|
||||
|
||||
.. _class_MultiplayerPeer_constant_CONNECTION_CONNECTED:
|
||||
|
||||
.. rst-class:: classref-enumeration-constant
|
||||
|
||||
:ref:`ConnectionStatus<enum_MultiplayerPeer_ConnectionStatus>` **CONNECTION_CONNECTED** = ``2``
|
||||
|
||||
This MultiplayerPeer is connected.
|
||||
|
||||
.. rst-class:: classref-item-separator
|
||||
|
||||
----
|
||||
|
||||
.. _enum_MultiplayerPeer_TransferMode:
|
||||
|
||||
.. _class_MultiplayerPeer_constant_TRANSFER_MODE_UNRELIABLE:
|
||||
|
||||
.. _class_MultiplayerPeer_constant_TRANSFER_MODE_UNRELIABLE_ORDERED:
|
||||
|
||||
.. _class_MultiplayerPeer_constant_TRANSFER_MODE_RELIABLE:
|
||||
.. rst-class:: classref-enumeration
|
||||
|
||||
enum **TransferMode**:
|
||||
|
||||
- **TRANSFER_MODE_UNRELIABLE** = **0** --- Packets are not acknowledged, no resend attempts are made for lost packets. Packets may arrive in any order. Potentially faster than :ref:`TRANSFER_MODE_UNRELIABLE_ORDERED<class_MultiplayerPeer_constant_TRANSFER_MODE_UNRELIABLE_ORDERED>`. Use for non-critical data, and always consider whether the order matters.
|
||||
.. _class_MultiplayerPeer_constant_TRANSFER_MODE_UNRELIABLE:
|
||||
|
||||
- **TRANSFER_MODE_UNRELIABLE_ORDERED** = **1** --- 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 :ref:`TRANSFER_MODE_RELIABLE<class_MultiplayerPeer_constant_TRANSFER_MODE_RELIABLE>`. 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.
|
||||
.. rst-class:: classref-enumeration-constant
|
||||
|
||||
- **TRANSFER_MODE_RELIABLE** = **2** --- 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 the 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.
|
||||
:ref:`TransferMode<enum_MultiplayerPeer_TransferMode>` **TRANSFER_MODE_UNRELIABLE** = ``0``
|
||||
|
||||
Packets are not acknowledged, no resend attempts are made for lost packets. Packets may arrive in any order. Potentially faster than :ref:`TRANSFER_MODE_UNRELIABLE_ORDERED<class_MultiplayerPeer_constant_TRANSFER_MODE_UNRELIABLE_ORDERED>`. Use for non-critical data, and always consider whether the order matters.
|
||||
|
||||
.. _class_MultiplayerPeer_constant_TRANSFER_MODE_UNRELIABLE_ORDERED:
|
||||
|
||||
.. rst-class:: classref-enumeration-constant
|
||||
|
||||
:ref:`TransferMode<enum_MultiplayerPeer_TransferMode>` **TRANSFER_MODE_UNRELIABLE_ORDERED** = ``1``
|
||||
|
||||
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 :ref:`TRANSFER_MODE_RELIABLE<class_MultiplayerPeer_constant_TRANSFER_MODE_RELIABLE>`. 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.
|
||||
|
||||
.. _class_MultiplayerPeer_constant_TRANSFER_MODE_RELIABLE:
|
||||
|
||||
.. rst-class:: classref-enumeration-constant
|
||||
|
||||
:ref:`TransferMode<enum_MultiplayerPeer_TransferMode>` **TRANSFER_MODE_RELIABLE** = ``2``
|
||||
|
||||
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 the 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.
|
||||
|
||||
.. rst-class:: classref-section-separator
|
||||
|
||||
----
|
||||
|
||||
.. rst-class:: classref-descriptions-group
|
||||
|
||||
Constants
|
||||
---------
|
||||
|
||||
.. _class_MultiplayerPeer_constant_TARGET_PEER_BROADCAST:
|
||||
|
||||
.. rst-class:: classref-constant
|
||||
|
||||
**TARGET_PEER_BROADCAST** = ``0``
|
||||
|
||||
Packets are sent to all connected peers.
|
||||
|
||||
.. _class_MultiplayerPeer_constant_TARGET_PEER_SERVER:
|
||||
|
||||
- **TARGET_PEER_BROADCAST** = **0** --- Packets are sent to all connected peers.
|
||||
.. rst-class:: classref-constant
|
||||
|
||||
- **TARGET_PEER_SERVER** = **1** --- Packets are sent to the remote peer acting as server.
|
||||
**TARGET_PEER_SERVER** = ``1``
|
||||
|
||||
Packets are sent to the remote peer acting as server.
|
||||
|
||||
.. rst-class:: classref-section-separator
|
||||
|
||||
----
|
||||
|
||||
.. rst-class:: classref-descriptions-group
|
||||
|
||||
Property Descriptions
|
||||
---------------------
|
||||
|
||||
.. _class_MultiplayerPeer_property_refuse_new_connections:
|
||||
|
||||
- :ref:`bool<class_bool>` **refuse_new_connections**
|
||||
.. rst-class:: classref-property
|
||||
|
||||
+-----------+-----------------------------------+
|
||||
| *Default* | ``false`` |
|
||||
+-----------+-----------------------------------+
|
||||
| *Setter* | set_refuse_new_connections(value) |
|
||||
+-----------+-----------------------------------+
|
||||
| *Getter* | is_refusing_new_connections() |
|
||||
+-----------+-----------------------------------+
|
||||
:ref:`bool<class_bool>` **refuse_new_connections** = ``false``
|
||||
|
||||
If ``true``, this ``MultiplayerPeer`` refuses new connections.
|
||||
.. rst-class:: classref-property-setget
|
||||
|
||||
- void **set_refuse_new_connections** **(** :ref:`bool<class_bool>` value **)**
|
||||
- :ref:`bool<class_bool>` **is_refusing_new_connections** **(** **)**
|
||||
|
||||
If ``true``, this **MultiplayerPeer** refuses new connections.
|
||||
|
||||
.. rst-class:: classref-item-separator
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeer_property_transfer_channel:
|
||||
|
||||
- :ref:`int<class_int>` **transfer_channel**
|
||||
.. rst-class:: classref-property
|
||||
|
||||
+-----------+-----------------------------+
|
||||
| *Default* | ``0`` |
|
||||
+-----------+-----------------------------+
|
||||
| *Setter* | set_transfer_channel(value) |
|
||||
+-----------+-----------------------------+
|
||||
| *Getter* | get_transfer_channel() |
|
||||
+-----------+-----------------------------+
|
||||
:ref:`int<class_int>` **transfer_channel** = ``0``
|
||||
|
||||
.. rst-class:: classref-property-setget
|
||||
|
||||
- void **set_transfer_channel** **(** :ref:`int<class_int>` value **)**
|
||||
- :ref:`int<class_int>` **get_transfer_channel** **(** **)**
|
||||
|
||||
The channel to use to send packets. Many network APIs such as ENet and WebRTC allow the creation of multiple independent channels which behaves, in a way, like separate connections. This means that reliable data will only block delivery of other packets on that channel, and ordering will only be in respect to the channel the packet is being sent on. Using different channels to send **different and independent** state updates is a common way to optimize network usage and decrease latency in fast-paced games.
|
||||
|
||||
\ **Note:** The default channel (``0``) actually works as 3 separate channels (one for each :ref:`TransferMode<enum_MultiplayerPeer_TransferMode>`) so that :ref:`TRANSFER_MODE_RELIABLE<class_MultiplayerPeer_constant_TRANSFER_MODE_RELIABLE>` and :ref:`TRANSFER_MODE_UNRELIABLE_ORDERED<class_MultiplayerPeer_constant_TRANSFER_MODE_UNRELIABLE_ORDERED>` does not interact with each other by default. Refer to the specific network API documentation (e.g. ENet or WebRTC) to learn how to set up channels correctly.
|
||||
|
||||
.. rst-class:: classref-item-separator
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeer_property_transfer_mode:
|
||||
|
||||
- :ref:`TransferMode<enum_MultiplayerPeer_TransferMode>` **transfer_mode**
|
||||
.. rst-class:: classref-property
|
||||
|
||||
+-----------+--------------------------+
|
||||
| *Default* | ``2`` |
|
||||
+-----------+--------------------------+
|
||||
| *Setter* | set_transfer_mode(value) |
|
||||
+-----------+--------------------------+
|
||||
| *Getter* | get_transfer_mode() |
|
||||
+-----------+--------------------------+
|
||||
:ref:`TransferMode<enum_MultiplayerPeer_TransferMode>` **transfer_mode** = ``2``
|
||||
|
||||
.. rst-class:: classref-property-setget
|
||||
|
||||
- void **set_transfer_mode** **(** :ref:`TransferMode<enum_MultiplayerPeer_TransferMode>` value **)**
|
||||
- :ref:`TransferMode<enum_MultiplayerPeer_TransferMode>` **get_transfer_mode** **(** **)**
|
||||
|
||||
The manner in which to send packets to the target peer. See :ref:`TransferMode<enum_MultiplayerPeer_TransferMode>`, and the :ref:`set_target_peer<class_MultiplayerPeer_method_set_target_peer>` method.
|
||||
|
||||
.. rst-class:: classref-section-separator
|
||||
|
||||
----
|
||||
|
||||
.. rst-class:: classref-descriptions-group
|
||||
|
||||
Method Descriptions
|
||||
-------------------
|
||||
|
||||
.. _class_MultiplayerPeer_method_close:
|
||||
|
||||
- void **close** **(** **)**
|
||||
.. rst-class:: classref-method
|
||||
|
||||
void **close** **(** **)**
|
||||
|
||||
Immediately close the multiplayer peer returning to the state :ref:`CONNECTION_DISCONNECTED<class_MultiplayerPeer_constant_CONNECTION_DISCONNECTED>`. Connected peers will be dropped without emitting :ref:`peer_disconnected<class_MultiplayerPeer_signal_peer_disconnected>`.
|
||||
|
||||
.. rst-class:: classref-item-separator
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeer_method_disconnect_peer:
|
||||
|
||||
- void **disconnect_peer** **(** :ref:`int<class_int>` peer, :ref:`bool<class_bool>` force=false **)**
|
||||
.. rst-class:: classref-method
|
||||
|
||||
void **disconnect_peer** **(** :ref:`int<class_int>` peer, :ref:`bool<class_bool>` force=false **)**
|
||||
|
||||
Disconnects the given ``peer`` from this host. If ``force`` is ``true`` the :ref:`peer_disconnected<class_MultiplayerPeer_signal_peer_disconnected>` signal will not be emitted for this peer.
|
||||
|
||||
.. rst-class:: classref-item-separator
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeer_method_generate_unique_id:
|
||||
|
||||
- :ref:`int<class_int>` **generate_unique_id** **(** **)** |const|
|
||||
.. rst-class:: classref-method
|
||||
|
||||
:ref:`int<class_int>` **generate_unique_id** **(** **)** |const|
|
||||
|
||||
Returns a randomly generated integer that can be used as a network unique ID.
|
||||
|
||||
.. rst-class:: classref-item-separator
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeer_method_get_connection_status:
|
||||
|
||||
- :ref:`ConnectionStatus<enum_MultiplayerPeer_ConnectionStatus>` **get_connection_status** **(** **)** |const|
|
||||
.. rst-class:: classref-method
|
||||
|
||||
:ref:`ConnectionStatus<enum_MultiplayerPeer_ConnectionStatus>` **get_connection_status** **(** **)** |const|
|
||||
|
||||
Returns the current state of the connection. See :ref:`ConnectionStatus<enum_MultiplayerPeer_ConnectionStatus>`.
|
||||
|
||||
.. rst-class:: classref-item-separator
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeer_method_get_packet_channel:
|
||||
|
||||
- :ref:`int<class_int>` **get_packet_channel** **(** **)** |const|
|
||||
.. rst-class:: classref-method
|
||||
|
||||
:ref:`int<class_int>` **get_packet_channel** **(** **)** |const|
|
||||
|
||||
Returns the channel over which the next available packet was received. See :ref:`PacketPeer.get_available_packet_count<class_PacketPeer_method_get_available_packet_count>`.
|
||||
|
||||
.. rst-class:: classref-item-separator
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeer_method_get_packet_mode:
|
||||
|
||||
- :ref:`TransferMode<enum_MultiplayerPeer_TransferMode>` **get_packet_mode** **(** **)** |const|
|
||||
.. rst-class:: classref-method
|
||||
|
||||
:ref:`TransferMode<enum_MultiplayerPeer_TransferMode>` **get_packet_mode** **(** **)** |const|
|
||||
|
||||
Returns the :ref:`TransferMode<enum_MultiplayerPeer_TransferMode>` the remote peer used to send the next available packet. See :ref:`PacketPeer.get_available_packet_count<class_PacketPeer_method_get_available_packet_count>`.
|
||||
|
||||
.. rst-class:: classref-item-separator
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeer_method_get_packet_peer:
|
||||
|
||||
- :ref:`int<class_int>` **get_packet_peer** **(** **)** |const|
|
||||
.. rst-class:: classref-method
|
||||
|
||||
Returns the ID of the ``MultiplayerPeer`` who sent the next available packet. See :ref:`PacketPeer.get_available_packet_count<class_PacketPeer_method_get_available_packet_count>`.
|
||||
:ref:`int<class_int>` **get_packet_peer** **(** **)** |const|
|
||||
|
||||
Returns the ID of the **MultiplayerPeer** who sent the next available packet. See :ref:`PacketPeer.get_available_packet_count<class_PacketPeer_method_get_available_packet_count>`.
|
||||
|
||||
.. rst-class:: classref-item-separator
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeer_method_get_unique_id:
|
||||
|
||||
- :ref:`int<class_int>` **get_unique_id** **(** **)** |const|
|
||||
.. rst-class:: classref-method
|
||||
|
||||
Returns the ID of this ``MultiplayerPeer``.
|
||||
:ref:`int<class_int>` **get_unique_id** **(** **)** |const|
|
||||
|
||||
Returns the ID of this **MultiplayerPeer**.
|
||||
|
||||
.. rst-class:: classref-item-separator
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeer_method_is_server_relay_supported:
|
||||
|
||||
- :ref:`bool<class_bool>` **is_server_relay_supported** **(** **)** |const|
|
||||
.. rst-class:: classref-method
|
||||
|
||||
:ref:`bool<class_bool>` **is_server_relay_supported** **(** **)** |const|
|
||||
|
||||
Returns true if the server can act as a relay in the current configuration (i.e. if the higher level :ref:`MultiplayerAPI<class_MultiplayerAPI>` should notify connected clients of other peers, and implement a relay protocol to allow communication between them).
|
||||
|
||||
.. rst-class:: classref-item-separator
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeer_method_poll:
|
||||
|
||||
- void **poll** **(** **)**
|
||||
.. rst-class:: classref-method
|
||||
|
||||
void **poll** **(** **)**
|
||||
|
||||
Waits up to 1 second to receive a new network event.
|
||||
|
||||
.. rst-class:: classref-item-separator
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeer_method_set_target_peer:
|
||||
|
||||
- void **set_target_peer** **(** :ref:`int<class_int>` id **)**
|
||||
.. rst-class:: classref-method
|
||||
|
||||
void **set_target_peer** **(** :ref:`int<class_int>` id **)**
|
||||
|
||||
Sets the peer to which packets will be sent.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user