class_websocketpeer.rst 5.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101
  1. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  2. .. DO NOT EDIT THIS FILE, but the WebSocketPeer.xml source instead.
  3. .. The source is found in doc/classes or modules/<name>/doc_classes.
  4. .. _class_WebSocketPeer:
  5. WebSocketPeer
  6. =============
  7. **Inherits:** :ref:`PacketPeer<class_packetpeer>` **<** :ref:`Reference<class_reference>` **<** :ref:`Object<class_object>`
  8. **Category:** Core
  9. Brief Description
  10. -----------------
  11. A class representing a specific WebSocket connection.
  12. Member Functions
  13. ----------------
  14. +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------+
  15. | void | :ref:`close<class_WebSocketPeer_close>` **(** **)** |
  16. +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------+
  17. | :ref:`String<class_string>` | :ref:`get_connected_host<class_WebSocketPeer_get_connected_host>` **(** **)** const |
  18. +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------+
  19. | :ref:`int<class_int>` | :ref:`get_connected_port<class_WebSocketPeer_get_connected_port>` **(** **)** const |
  20. +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------+
  21. | :ref:`WriteMode<enum_websocketpeer_writemode>` | :ref:`get_write_mode<class_WebSocketPeer_get_write_mode>` **(** **)** const |
  22. +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------+
  23. | :ref:`bool<class_bool>` | :ref:`is_connected_to_host<class_WebSocketPeer_is_connected_to_host>` **(** **)** const |
  24. +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------+
  25. | void | :ref:`set_write_mode<class_WebSocketPeer_set_write_mode>` **(** :ref:`WriteMode<enum_websocketpeer_writemode>` mode **)** |
  26. +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------+
  27. | :ref:`bool<class_bool>` | :ref:`was_string_packet<class_WebSocketPeer_was_string_packet>` **(** **)** const |
  28. +-------------------------------------------------+---------------------------------------------------------------------------------------------------------------------------+
  29. Enums
  30. -----
  31. .. _enum_WebSocketPeer_WriteMode:
  32. enum **WriteMode**
  33. - **WRITE_MODE_TEXT** = **0** --- Specify that WebSockets messages should be transferred as text payload (only valid UTF-8 is allowed).
  34. - **WRITE_MODE_BINARY** = **1** --- Specify that WebSockets messages should be transferred as binary payload (any byte combination is allowed).
  35. Description
  36. -----------
  37. This class represent a specific WebSocket connection, you can do lower level operations with it.
  38. You can choose to write to the socket in binary or text mode, and you can recognize the mode used for writing by the other peer.
  39. Member Function Description
  40. ---------------------------
  41. .. _class_WebSocketPeer_close:
  42. - void **close** **(** **)**
  43. Close this WebSocket connection, actively disconnecting the peer.
  44. .. _class_WebSocketPeer_get_connected_host:
  45. - :ref:`String<class_string>` **get_connected_host** **(** **)** const
  46. Returns the IP Address of the connected peer. (Not available in HTML5 export)
  47. .. _class_WebSocketPeer_get_connected_port:
  48. - :ref:`int<class_int>` **get_connected_port** **(** **)** const
  49. Returns the remote port of the connected peer. (Not available in HTML5 export)
  50. .. _class_WebSocketPeer_get_write_mode:
  51. - :ref:`WriteMode<enum_websocketpeer_writemode>` **get_write_mode** **(** **)** const
  52. Get the current selected write mode. See :ref:`WriteMode<enum_@globalscope_writemode>`.
  53. .. _class_WebSocketPeer_is_connected_to_host:
  54. - :ref:`bool<class_bool>` **is_connected_to_host** **(** **)** const
  55. Returns ``true`` if this peer is currently connected.
  56. .. _class_WebSocketPeer_set_write_mode:
  57. - void **set_write_mode** **(** :ref:`WriteMode<enum_websocketpeer_writemode>` mode **)**
  58. Sets the socket to use the given :ref:`WriteMode<enum_@globalscope_writemode>`.
  59. .. _class_WebSocketPeer_was_string_packet:
  60. - :ref:`bool<class_bool>` **was_string_packet** **(** **)** const
  61. Returns ``true`` if the last received packet was sent as a text payload. See :ref:`WriteMode<enum_@globalscope_writemode>`