WebSocketPeer

Inherits: PacketPeer < Reference < Object

Category: Core

Brief Description

A class representing a specific WebSocket connection.

Methods

void close ( int code=1000, String reason=”” )
String get_connected_host ( ) const
int get_connected_port ( ) const
WriteMode get_write_mode ( ) const
bool is_connected_to_host ( ) const
void set_write_mode ( WriteMode mode )
bool was_string_packet ( ) const

Enumerations

enum WriteMode:

  • WRITE_MODE_TEXT = 0 — Specify that WebSockets messages should be transferred as text payload (only valid UTF-8 is allowed).
  • WRITE_MODE_BINARY = 1 — Specify that WebSockets messages should be transferred as binary payload (any byte combination is allowed).

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.

Method Descriptions

  • void close ( int code=1000, String reason=”” )

Close this WebSocket connection. code is the status code for the closure (see RFC6455 section 7.4 for a list of valid status codes). reason is the human readable reason for closing the connection (can be any UTF8 string, must be less 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: HTML5 export might not support all status codes. Please refer to browsers-specific documentation for more details.

  • String get_connected_host ( ) const

Returns the IP Address of the connected peer. (Not available in HTML5 export)

  • int get_connected_port ( ) const

Returns the remote port of the connected peer. (Not available in HTML5 export)

Get the current selected write mode. See WriteMode.

  • bool is_connected_to_host ( ) const

Returns true if this peer is currently connected.

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