WebSocketPeer¶
Inherits: PacketPeer < Reference < Object
A class representing a specific WebSocket connection.
Description¶
This class represent a specific WebSocket connection, you can do lower level operations with it.
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.
Methods¶
void |
|
get_connected_host ( ) const |
|
get_connected_port ( ) const |
|
get_write_mode ( ) const |
|
is_connected_to_host ( ) const |
|
void |
set_no_delay ( bool enabled ) |
void |
set_write_mode ( WriteMode mode ) |
was_string_packet ( ) const |
Enumerations¶
enum WriteMode:
WRITE_MODE_TEXT = 0 --- Specifies that WebSockets messages should be transferred as text payload (only valid UTF-8 is allowed).
WRITE_MODE_BINARY = 1 --- Specifies that WebSockets messages should be transferred as binary payload (any byte combination is allowed).
Method Descriptions¶
Closes this WebSocket connection. code
is the status code for the closure (see RFC 6455 section 7.4 for a list of valid status codes). reason
is the human readable reason for closing the connection (can be any UTF-8 string that's smaller than 123 bytes).
Note: To achieve a clean close, you will need to keep polling until either WebSocketClient.connection_closed or WebSocketServer.client_disconnected is received.
Note: The HTML5 export might not support all status codes. Please refer to browser-specific documentation for more details.
String get_connected_host ( ) const
Returns the IP address of the connected peer.
Note: Not available in the HTML5 export.
int get_connected_port ( ) const
Returns the remote port of the connected peer.
Note: Not available in the HTML5 export.
WriteMode get_write_mode ( ) const
Gets the current selected write mode. See WriteMode.
bool is_connected_to_host ( ) const
Returns true
if this peer is currently connected.
void set_no_delay ( bool enabled )
Disable Nagle's algorithm on the underling TCP socket (default). See StreamPeerTCP.set_no_delay for more information.
Note: Not available in the HTML5 export.
void set_write_mode ( WriteMode mode )
Sets the socket to use the given WriteMode.
bool was_string_packet ( ) const
Returns true
if the last received packet was sent as a text payload. See WriteMode.