2
0

class_networkedmultiplayerpeer.rst 5.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146
  1. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  2. .. DO NOT EDIT THIS FILE, but the NetworkedMultiplayerPeer.xml source instead.
  3. .. The source is found in doc/classes or modules/<name>/doc_classes.
  4. .. _class_NetworkedMultiplayerPeer:
  5. NetworkedMultiplayerPeer
  6. ========================
  7. **Inherits:** :ref:`PacketPeer<class_packetpeer>` **<** :ref:`Reference<class_reference>` **<** :ref:`Object<class_object>`
  8. **Inherited By:** :ref:`NetworkedMultiplayerENet<class_networkedmultiplayerenet>`
  9. **Category:** Core
  10. Brief Description
  11. -----------------
  12. A high-level network interface to simplify multiplayer interactions.
  13. Member Functions
  14. ----------------
  15. +------------------------+-------------------------------------------------------------------------------------------------------------+
  16. | :ref:`int<class_int>` | :ref:`get_connection_status<class_NetworkedMultiplayerPeer_get_connection_status>` **(** **)** const |
  17. +------------------------+-------------------------------------------------------------------------------------------------------------+
  18. | :ref:`int<class_int>` | :ref:`get_packet_peer<class_NetworkedMultiplayerPeer_get_packet_peer>` **(** **)** const |
  19. +------------------------+-------------------------------------------------------------------------------------------------------------+
  20. | :ref:`int<class_int>` | :ref:`get_unique_id<class_NetworkedMultiplayerPeer_get_unique_id>` **(** **)** const |
  21. +------------------------+-------------------------------------------------------------------------------------------------------------+
  22. | void | :ref:`poll<class_NetworkedMultiplayerPeer_poll>` **(** **)** |
  23. +------------------------+-------------------------------------------------------------------------------------------------------------+
  24. | void | :ref:`set_target_peer<class_NetworkedMultiplayerPeer_set_target_peer>` **(** :ref:`int<class_int>` id **)** |
  25. +------------------------+-------------------------------------------------------------------------------------------------------------+
  26. Signals
  27. -------
  28. .. _class_NetworkedMultiplayerPeer_connection_failed:
  29. - **connection_failed** **(** **)**
  30. Emitted when a connection attempt fails.
  31. .. _class_NetworkedMultiplayerPeer_connection_succeeded:
  32. - **connection_succeeded** **(** **)**
  33. Emitted when a connection attempt succeeds.
  34. .. _class_NetworkedMultiplayerPeer_peer_connected:
  35. - **peer_connected** **(** :ref:`int<class_int>` id **)**
  36. Emitted by the server when a client connects.
  37. .. _class_NetworkedMultiplayerPeer_peer_disconnected:
  38. - **peer_disconnected** **(** :ref:`int<class_int>` id **)**
  39. Emitted by the server when a client disconnects.
  40. .. _class_NetworkedMultiplayerPeer_server_disconnected:
  41. - **server_disconnected** **(** **)**
  42. Emitted by clients when the server disconnects.
  43. Member Variables
  44. ----------------
  45. .. _class_NetworkedMultiplayerPeer_refuse_new_connections:
  46. - :ref:`bool<class_bool>` **refuse_new_connections** - If ``true`` this ``NetworkedMultiplayerPeer`` refuses new connections. Default value: ``false``.
  47. .. _class_NetworkedMultiplayerPeer_transfer_mode:
  48. - :ref:`TransferMode<enum_networkedmultiplayerpeer_transfermode>` **transfer_mode** - The manner in which to send packets to the ``target_peer``. See enum TransferMode.
  49. Numeric Constants
  50. -----------------
  51. - **TARGET_PEER_BROADCAST** = **0** --- Packets are sent to the server and then redistributed to other peers.
  52. - **TARGET_PEER_SERVER** = **1** --- Packets are sent to the server alone.
  53. Enums
  54. -----
  55. .. _enum_NetworkedMultiplayerPeer_TransferMode:
  56. enum **TransferMode**
  57. - **TRANSFER_MODE_UNRELIABLE** = **0** --- Packets are sent via unordered UDP packets.
  58. - **TRANSFER_MODE_UNRELIABLE_ORDERED** = **1** --- Packets are sent via ordered UDP packets.
  59. - **TRANSFER_MODE_RELIABLE** = **2** --- Packets are sent via TCP packets.
  60. .. _enum_NetworkedMultiplayerPeer_ConnectionStatus:
  61. enum **ConnectionStatus**
  62. - **CONNECTION_DISCONNECTED** = **0** --- The ongoing connection disconnected.
  63. - **CONNECTION_CONNECTING** = **1** --- A connection attempt is ongoing.
  64. - **CONNECTION_CONNECTED** = **2** --- The connection attempt succeeded.
  65. Description
  66. -----------
  67. Manages the connection to network peers. Assigns unique IDs to each client connected to the server.
  68. Member Function Description
  69. ---------------------------
  70. .. _class_NetworkedMultiplayerPeer_get_connection_status:
  71. - :ref:`int<class_int>` **get_connection_status** **(** **)** const
  72. Returns the current state of the connection. See enum ConnectionStatus.
  73. .. _class_NetworkedMultiplayerPeer_get_packet_peer:
  74. - :ref:`int<class_int>` **get_packet_peer** **(** **)** const
  75. Returns the ID of the ``NetworkedMultiplayerPeer`` who sent the most recent packet.
  76. .. _class_NetworkedMultiplayerPeer_get_unique_id:
  77. - :ref:`int<class_int>` **get_unique_id** **(** **)** const
  78. Returns the ID of this ``NetworkedMultiplayerPeer``.
  79. .. _class_NetworkedMultiplayerPeer_poll:
  80. - void **poll** **(** **)**
  81. Waits up to 1 second to receive a new network event.
  82. .. _class_NetworkedMultiplayerPeer_set_target_peer:
  83. - void **set_target_peer** **(** :ref:`int<class_int>` id **)**
  84. The peer to which packets will be sent. Default value: ``0``.