Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
MultiplayerPeerExtension¶
Inherits: MultiplayerPeer < PacketPeer < RefCounted < Object
Class that can be inherited to implement custom multiplayer API networking layers via GDExtension.
描述¶
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 MultiplayerAPI.
Methods¶
void |
_close ( ) virtual |
void |
_disconnect_peer ( int p_peer, bool p_force ) virtual |
_get_available_packet_count ( ) virtual const |
|
_get_connection_status ( ) virtual const |
|
_get_max_packet_size ( ) virtual const |
|
_get_packet ( const uint8_t ** r_buffer, int32_t* r_buffer_size ) virtual |
|
_get_packet_channel ( ) virtual const |
|
_get_packet_mode ( ) virtual const |
|
_get_packet_peer ( ) virtual const |
|
_get_packet_script ( ) virtual |
|
_get_transfer_channel ( ) virtual const |
|
_get_transfer_mode ( ) virtual const |
|
_get_unique_id ( ) virtual const |
|
_is_refusing_new_connections ( ) virtual const |
|
_is_server ( ) virtual const |
|
_is_server_relay_supported ( ) virtual const |
|
void |
_poll ( ) virtual |
_put_packet ( const uint8_t* p_buffer, int p_buffer_size ) virtual |
|
_put_packet_script ( PackedByteArray p_buffer ) virtual |
|
void |
_set_refuse_new_connections ( bool p_enable ) virtual |
void |
_set_target_peer ( int p_peer ) virtual |
void |
_set_transfer_channel ( int p_channel ) virtual |
void |
_set_transfer_mode ( TransferMode p_mode ) virtual |
Method Descriptions¶
void _close ( ) virtual
Called when the multiplayer peer should be immediately closed (see MultiplayerPeer.close).
void _disconnect_peer ( int p_peer, bool p_force ) virtual
Called when the connected p_peer
should be forcibly disconnected (see MultiplayerPeer.disconnect_peer).
int _get_available_packet_count ( ) virtual const
Called when the available packet count is internally requested by the MultiplayerAPI.
ConnectionStatus _get_connection_status ( ) virtual const
Called when the connection status is requested on the MultiplayerPeer (see MultiplayerPeer.get_connection_status).
int _get_max_packet_size ( ) virtual const
Called when the maximum allowed packet size (in bytes) is requested by the MultiplayerAPI.
Error _get_packet ( const uint8_t ** r_buffer, int32_t* r_buffer_size ) virtual
Called when a packet needs to be received by the MultiplayerAPI, with r_buffer_size
being the size of the binary r_buffer
in bytes.
int _get_packet_channel ( ) virtual const
Called to get the channel over which the next available packet was received. See MultiplayerPeer.get_packet_channel.
TransferMode _get_packet_mode ( ) virtual const
Called to get the TransferMode the remote peer used to send the next available packet. See MultiplayerPeer.get_packet_mode.
int _get_packet_peer ( ) virtual const
Called when the ID of the MultiplayerPeer who sent the most recent packet is requested (see MultiplayerPeer.get_packet_peer).
PackedByteArray _get_packet_script ( ) virtual
Called when a packet needs to be received by the MultiplayerAPI, if _get_packet isn't implemented. Use this when extending this class via GDScript.
int _get_transfer_channel ( ) virtual const
Called when the transfer channel to use is read on this MultiplayerPeer (see MultiplayerPeer.transfer_channel).
TransferMode _get_transfer_mode ( ) virtual const
Called when the transfer mode to use is read on this MultiplayerPeer (see MultiplayerPeer.transfer_mode).
int _get_unique_id ( ) virtual const
Called when the unique ID of this MultiplayerPeer is requested (see MultiplayerPeer.get_unique_id). The value must be between 1
and 2147483647
.
bool _is_refusing_new_connections ( ) virtual const
Called when the "refuse new connections" status is requested on this MultiplayerPeer (see MultiplayerPeer.refuse_new_connections).
bool _is_server ( ) virtual const
Called when the "is server" status is requested on the MultiplayerAPI. See MultiplayerAPI.is_server.
bool _is_server_relay_supported ( ) virtual const
Called to check if the server can act as a relay in the current configuration. See MultiplayerPeer.is_server_relay_supported.
void _poll ( ) virtual
Called when the MultiplayerAPI is polled. See MultiplayerAPI.poll.
Error _put_packet ( const uint8_t* p_buffer, int p_buffer_size ) virtual
Called when a packet needs to be sent by the MultiplayerAPI, with p_buffer_size
being the size of the binary p_buffer
in bytes.
Error _put_packet_script ( PackedByteArray p_buffer ) virtual
Called when a packet needs to be sent by the MultiplayerAPI, if _put_packet isn't implemented. Use this when extending this class via GDScript.
void _set_refuse_new_connections ( bool p_enable ) virtual
Called when the "refuse new connections" status is set on this MultiplayerPeer (see MultiplayerPeer.refuse_new_connections).
void _set_target_peer ( int p_peer ) virtual
Called when the target peer to use is set for this MultiplayerPeer (see MultiplayerPeer.set_target_peer).
void _set_transfer_channel ( int p_channel ) virtual
Called when the channel to use is set for this MultiplayerPeer (see MultiplayerPeer.transfer_channel).
void _set_transfer_mode ( TransferMode p_mode ) virtual
Called when the transfer mode is set on this MultiplayerPeer (see MultiplayerPeer.transfer_mode).