index :: net

net.ws.server

WebSocket сервер

доступно с версии: 0.9.8

---

методы:

• clients output connected clients as list CLIENT_ID CLIENT_ADDR… etc.
  

• close gracefully close connection with specified client(s)
  параметры:

  • TARGET client selector. If '*' or 'all' - send message to all clients. If 'first' - send message to first connected client. If 'last' - send message to last connected client. If 'id' or '==' - send message to client with specified ID. If 'except' or '!=' - send message to all client except specified.
    тип: symbol
    обязательно: True
    

  • [ID] client ID. Required, if client selector is one of: 'id', '==', '!=' or 'except'.
    тип: int
    

• listen starts/stop websocket server
  параметры:

  • PORT listening port. If 0 - stops server.
    тип: int
    обязательно: True
    

  • [ADDR] listening address. If not specified - using 0.0.0.0 (all network interfaces)
    тип: symbol
    

• ping send ping message to specified client(s)
  параметры:

  • TARGET client selector. If '*' or 'all' - send message to all clients. If 'first' - send message to first connected client. If 'last' - send message to last connected client. If 'id' or '==' - send message to client with specified ID. If 'except' or '!=' - send message to all client except specified.
    тип: symbol
    обязательно: True
    

  • [ID] client ID. Required, if client selector is one of: 'id', '==', '!=' or 'except'.
    тип: int
    

  • [DATA] list of integers in [0..255] range
    тип: list
    

• send send as text message to specified client(s)
  параметры:

  • TARGET client selector. If '*' or 'all' - send message to all clients. If 'first' - send message to first connected client. If 'last' - send message to last connected client. If 'id' or '==' - send message to client with specified ID. If 'except' or '!=' - send message to all client except specified.
    тип: symbol
    обязательно: True
    

  • [ID] client ID. Required, if client selector is one of: 'id', '==', '!=' or 'except'.
    тип: int
    

  • [ARGS] arguments
    тип: list
    

• send_binary send as binary bytes to specified client(s)
  параметры:

  • TARGET client selector. If '*' or 'all' - send message to all clients. If 'first' - send message to first connected client. If 'last' - send message to last connected client. If 'id' or '==' - send message to client with specified ID. If 'except' or '!=' - send message to all client except specified.
    тип: symbol
    обязательно: True
    

  • [ID] client ID. Required, if client selector is one of: 'id', '==', '!=' or 'except'.
    тип: int
    

  • [DATA] list of integers in [0..255] range
    тип: list
    

• send_json send as encoded json to specified client(s)
  параметры:

  • TARGET client selector. If '*' or 'all' - send message to all clients. If 'first' - send message to first connected client. If 'last' - send message to last connected client. If 'id' or '==' - send message to client with specified ID. If 'except' or '!=' - send message to all client except specified.
    тип: symbol
    обязательно: True
    

  • [ID] client ID. Required, if client selector is one of: 'id', '==', '!=' or 'except'.
    тип: int
    

  • [ARGS] arguments
    тип: list
    

• shutdown abort connection with specified client(s)
  параметры:

  • TARGET client selector. If '*' or 'all' - send message to all clients. If 'first' - send message to first connected client. If 'last' - send message to last connected client. If 'id' or '==' - send message to client with specified ID. If 'except' or '!=' - send message to all client except specified.
    тип: symbol
    обязательно: True
    

  • [ID] client ID. Required, if client selector is one of: 'id', '==', '!=' or 'except'.
    тип: int
    

• stop stops server, equal to [listen 0( message
  

свойства:

• @mode Запросить/установить parsing mode for incoming client messages. If 'fudi' - interpret incoming websocket data as Pd messages, if 'sym' - always interpret as symbols, 'data' - parse ceammc data, 'json' - convert json values to ceammc data.
  тип: symbol
  варианты: data, fudi, json, sym
  по умолчанию: fudi
  

входы:

• message input
  тип: control

выходы:

• [connected( when client is connected, [closed( when client closed, [text( on text message, [ping( on ping message from client, [binary( on binary message
  тип: control
• list: CLIENT_ID CLIENT_ADDR
  тип: control

ключевые слова:

websocket net server

Смотрите также: [net.ws.client]

Авторы: Serge Poltavsky

Лицензия: GPL3 or later