mirror of
https://github.com/stan220/godot-docs.git
synced 2026-09-08 17:28:58 +00:00
classref: Sync with current master branch (c09d83010)
This commit is contained in:
@@ -11,7 +11,12 @@ MultiplayerPeerExtension
|
||||
|
||||
**Inherits:** :ref:`MultiplayerPeer<class_MultiplayerPeer>` **<** :ref:`PacketPeer<class_PacketPeer>` **<** :ref:`RefCounted<class_RefCounted>` **<** :ref:`Object<class_Object>`
|
||||
|
||||
Class that can be inherited to implement custom multiplayer API networking layers via GDExtension.
|
||||
|
||||
Description
|
||||
-----------
|
||||
|
||||
This class is designed to be inherited from a GDExtension plugin to implement custom networking layers for the multiplayer API (such as WebRTC). All the methods below **must** be implemented to have a working custom multiplayer implementation. See also :ref:`MultiplayerAPI<class_MultiplayerAPI>`.
|
||||
|
||||
Methods
|
||||
-------
|
||||
@@ -57,96 +62,128 @@ Method Descriptions
|
||||
|
||||
- :ref:`int<class_int>` **_get_available_packet_count** **(** **)** |virtual| |const|
|
||||
|
||||
Called when the available packet count is internally requested by the :ref:`MultiplayerAPI<class_MultiplayerAPI>`.
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeerExtension_method__get_connection_status:
|
||||
|
||||
- :ref:`int<class_int>` **_get_connection_status** **(** **)** |virtual| |const|
|
||||
|
||||
Called when the connection status is requested on the :ref:`MultiplayerPeer<class_MultiplayerPeer>` (see :ref:`MultiplayerPeer.get_connection_status<class_MultiplayerPeer_method_get_connection_status>`).
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeerExtension_method__get_max_packet_size:
|
||||
|
||||
- :ref:`int<class_int>` **_get_max_packet_size** **(** **)** |virtual| |const|
|
||||
|
||||
Called when the maximum allowed packet size (in bytes) is requested by the :ref:`MultiplayerAPI<class_MultiplayerAPI>`.
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeerExtension_method__get_packet:
|
||||
|
||||
- :ref:`int<class_int>` **_get_packet** **(** const uint8_t ** r_buffer, int32_t* r_buffer_size **)** |virtual|
|
||||
|
||||
Called when a packet needs to be received by the :ref:`MultiplayerAPI<class_MultiplayerAPI>`, with ``p_buffer_size`` being the size of the binary ``p_buffer`` in bytes.
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeerExtension_method__get_packet_peer:
|
||||
|
||||
- :ref:`int<class_int>` **_get_packet_peer** **(** **)** |virtual| |const|
|
||||
|
||||
Called when the ID of the :ref:`MultiplayerPeer<class_MultiplayerPeer>` who sent the most recent packet is requested (see :ref:`MultiplayerPeer.get_packet_peer<class_MultiplayerPeer_method_get_packet_peer>`).
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeerExtension_method__get_transfer_channel:
|
||||
|
||||
- :ref:`int<class_int>` **_get_transfer_channel** **(** **)** |virtual| |const|
|
||||
|
||||
Called when the transfer channel to use is read on this :ref:`MultiplayerPeer<class_MultiplayerPeer>` (see :ref:`MultiplayerPeer.transfer_channel<class_MultiplayerPeer_property_transfer_channel>`).
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeerExtension_method__get_transfer_mode:
|
||||
|
||||
- :ref:`int<class_int>` **_get_transfer_mode** **(** **)** |virtual| |const|
|
||||
|
||||
Called when the transfer mode to use is read on this :ref:`MultiplayerPeer<class_MultiplayerPeer>` (see :ref:`MultiplayerPeer.transfer_mode<class_MultiplayerPeer_property_transfer_mode>`).
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeerExtension_method__get_unique_id:
|
||||
|
||||
- :ref:`int<class_int>` **_get_unique_id** **(** **)** |virtual| |const|
|
||||
|
||||
Called when the unique ID of this :ref:`MultiplayerPeer<class_MultiplayerPeer>` is requested (see :ref:`MultiplayerPeer.get_unique_id<class_MultiplayerPeer_method_get_unique_id>`).
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeerExtension_method__is_refusing_new_connections:
|
||||
|
||||
- :ref:`bool<class_bool>` **_is_refusing_new_connections** **(** **)** |virtual| |const|
|
||||
|
||||
Called when the "refuse new connections" status is requested on this :ref:`MultiplayerPeer<class_MultiplayerPeer>` (see :ref:`MultiplayerPeer.refuse_new_connections<class_MultiplayerPeer_property_refuse_new_connections>`).
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeerExtension_method__is_server:
|
||||
|
||||
- :ref:`bool<class_bool>` **_is_server** **(** **)** |virtual| |const|
|
||||
|
||||
Called when the "is server" status is requested on the :ref:`MultiplayerAPI<class_MultiplayerAPI>`. See :ref:`MultiplayerAPI.is_server<class_MultiplayerAPI_method_is_server>`.
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeerExtension_method__poll:
|
||||
|
||||
- :ref:`int<class_int>` **_poll** **(** **)** |virtual|
|
||||
|
||||
Called when the :ref:`MultiplayerAPI<class_MultiplayerAPI>` is polled. See :ref:`MultiplayerAPI.poll<class_MultiplayerAPI_method_poll>`.
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeerExtension_method__put_packet:
|
||||
|
||||
- :ref:`int<class_int>` **_put_packet** **(** const uint8_t* p_buffer, :ref:`int<class_int>` p_buffer_size **)** |virtual|
|
||||
|
||||
Called when a packet needs to be sent by the :ref:`MultiplayerAPI<class_MultiplayerAPI>`, with ``p_buffer_size`` being the size of the binary ``p_buffer`` in bytes.
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeerExtension_method__set_refuse_new_connections:
|
||||
|
||||
- void **_set_refuse_new_connections** **(** :ref:`bool<class_bool>` p_enable **)** |virtual|
|
||||
|
||||
Called when the "refuse new connections" status is set on this :ref:`MultiplayerPeer<class_MultiplayerPeer>` (see :ref:`MultiplayerPeer.refuse_new_connections<class_MultiplayerPeer_property_refuse_new_connections>`).
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeerExtension_method__set_target_peer:
|
||||
|
||||
- void **_set_target_peer** **(** :ref:`int<class_int>` p_peer **)** |virtual|
|
||||
|
||||
Called when the target peer to use is set for this :ref:`MultiplayerPeer<class_MultiplayerPeer>` (see :ref:`MultiplayerPeer.set_target_peer<class_MultiplayerPeer_method_set_target_peer>`).
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeerExtension_method__set_transfer_channel:
|
||||
|
||||
- void **_set_transfer_channel** **(** :ref:`int<class_int>` p_channel **)** |virtual|
|
||||
|
||||
Called when the channel to use is set for this :ref:`MultiplayerPeer<class_MultiplayerPeer>` (see :ref:`MultiplayerPeer.transfer_channel<class_MultiplayerPeer_property_transfer_channel>`).
|
||||
|
||||
----
|
||||
|
||||
.. _class_MultiplayerPeerExtension_method__set_transfer_mode:
|
||||
|
||||
- void **_set_transfer_mode** **(** :ref:`int<class_int>` p_mode **)** |virtual|
|
||||
|
||||
Called when the transfer mode is set on this :ref:`MultiplayerPeer<class_MultiplayerPeer>` (see :ref:`MultiplayerPeer.transfer_mode<class_MultiplayerPeer_property_transfer_mode>`).
|
||||
|
||||
.. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)`
|
||||
.. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)`
|
||||
.. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`
|
||||
|
||||
Reference in New Issue
Block a user