NetworkedMultiplayerPeer

Inherits: PacketPeer < Reference < Object

Inherited By: NetworkedMultiplayerENet

Category: Core

Brief Description

A high-level network interface to simplify multiplayer interactions.

Member Functions

int get_connection_status ( ) const
int get_packet_peer ( ) const
int get_unique_id ( ) const
void poll ( )
void set_target_peer ( int id )

Signals

  • connection_failed ( )

Emitted when a connection attempt fails.

  • connection_succeeded ( )

Emitted when a connection attempt succeeds.

  • peer_connected ( int id )

Emitted by the server when a client connects.

  • peer_disconnected ( int id )

Emitted by the server when a client disconnects.

  • server_disconnected ( )

Emitted by clients when the server disconnects.

Member Variables

  • bool refuse_new_connections - If true this NetworkedMultiplayerPeer refuses new connections. Default value: false.
  • TransferMode transfer_mode - The manner in which to send packets to the target_peer. See enum TransferMode.

Numeric Constants

  • TARGET_PEER_BROADCAST = 0 — Packets are sent to the server and then redistributed to other peers.
  • TARGET_PEER_SERVER = 1 — Packets are sent to the server alone.

Enums

enum TransferMode

  • TRANSFER_MODE_UNRELIABLE = 0 — Packets are sent via unordered UDP packets.
  • TRANSFER_MODE_UNRELIABLE_ORDERED = 1 — Packets are sent via ordered UDP packets.
  • TRANSFER_MODE_RELIABLE = 2 — Packets are sent via TCP packets.

enum ConnectionStatus

  • CONNECTION_DISCONNECTED = 0 — The ongoing connection disconnected.
  • CONNECTION_CONNECTING = 1 — A connection attempt is ongoing.
  • CONNECTION_CONNECTED = 2 — The connection attempt succeeded.

Description

Manages the connection to network peers. Assigns unique IDs to each client connected to the server.

Member Function Description

  • int get_connection_status ( ) const

Returns the current state of the connection. See enum ConnectionStatus.

  • int get_packet_peer ( ) const

Returns the ID of the NetworkedMultiplayerPeer who sent the most recent packet.

  • int get_unique_id ( ) const

Returns the ID of this NetworkedMultiplayerPeer.

  • void poll ( )

Waits up to 1 second to receive a new network event.

  • void set_target_peer ( int id )

The peer to which packets will be sent. Default value: 0.