websocket

Version: stable

FUNCTION
connect()
disconnect()
send()
CONSTANT
EVENT_CONNECTED
EVENT_DISCONNECTED
EVENT_MESSAGE
EVENT_ERROR

Functions

connect()

connect(url,params,callback)

Connects to a remote address

PARAMETERS

url string url of the remote connection
params table optional parameters as properties. The following parameters can be set
callback function callback that receives all messages from the connection
self object The script instance that was used to register the callback
connection object the connection
data table the event payload

RETURNS

object the connection

EXAMPLES

  local function websocket_callback(self, conn, data)
    if data.event == websocket.EVENT_DISCONNECTED then
      log("Disconnected: " .. tostring(conn))
      self.connection = nil
      update_gui(self)
    elseif data.event == websocket.EVENT_CONNECTED then
      update_gui(self)
      log("Connected: " .. tostring(conn))
    elseif data.event == websocket.EVENT_ERROR then
      log("Error: '" .. data.message .. "'")
    elseif data.event == websocket.EVENT_MESSAGE then
      log("Receiving: '" .. tostring(data.message) .. "'")
    end
  end

  function init(self)
    self.url = "ws://echo.websocket.events"
    local params = {
      timeout = 3000,
      headers = "Sec-WebSocket-Protocol: chat\r\nOrigin: mydomain.com\r\n"
    }
    self.connection = websocket.connect(self.url, params, websocket_callback)
  end

  function finalize(self)
      if self.connection ~= nil then
        websocket.disconnect(self.connection)
      end
  end

disconnect()

disconnect(connection)

Explicitly close a websocket

PARAMETERS

connection object the websocket connection

send()

send(connection,message,options)

Send data on a websocket

PARAMETERS

connection object the websocket connection
message string the message to send
options table options for this particular message. May be `nil`

EXAMPLES

  local function websocket_callback(self, conn, data)
    if data.event == websocket.EVENT_CONNECTED then
      websocket.send(conn, "Hello from the other side")
    end
  end

  function init(self)
    self.url = "ws://echo.websocket.org"
    local params = {}
    self.connection = websocket.connect(self.url, params, websocket_callback)
  end

Constants

EVENT_CONNECTED

The websocket was connected

EVENT_DISCONNECTED

The websocket disconnected

EVENT_MESSAGE

The websocket received data

EVENT_ERROR

The websocket encountered an error