librws 1.2.4

您想把以下类似条目添加到 Podfile 中：

target 'MyApp' do
  pod 'librws', '~> 1.2'
end

然后在终端或从 CocoaPods.app 中运行 pod install。

或者为了进行测试运行，运行以下命令：

pod try librws

librws 1.2.4

由
Oleh Kulykov

librws - 轻量级、跨平台 WebSocket 客户端 C 库。

特点

无额外依赖
单一的头部库接口 librws.h，包含公共方法
线程安全
在后台线程中执行 send/receive 逻辑

Podfile

pod 'librws'

示例

创建和存储 WebSocket 对象句柄

  // Define variable or field for socket handle
  rws_socket _socket = NULL;
  ............
  // Create socket object
  _socket = rws_socket_create();

设置 WebSocket 连接 URL

// Combined url: "ws://echo.websocket.org:80/"
rws_socket_set_scheme(_socket, "ws");
rws_socket_set_host(_socket, "echo.websocket.org");
rws_socket_set_port(_socket, 80);
rws_socket_set_path(_socket, "/");

设置 WebSocket 响应回调

警告：必须调用 rws_socket_set_on_disconnected

// Main callbacks functions
// callback trigered on socket disconnected with/without error
static void on_socket_disconnected(rws_socket socket) {
  // process error
  rws_error error = rws_socket_get_error(socket);
  if (error) { 
    printf("\nSocket disconnect with code, error: %i, %s", rws_error_get_code(error), rws_error_get_description(error)); 
  }
  // forget about this socket object, due to next disconnection sequence
  _socket = NULL;
}
// callback trigered on socket connected and handshake done
static void on_socket_connected(rws_socket socket) {
  printf("\nSocket connected");
}
// callback trigered on socket received text
static void on_socket_received_text(rws_socket socket, const char * text, const unsigned int length) {
  printf("\nSocket text: %s", text);
}
..................
// Set socket callbacks
rws_socket_set_on_disconnected(_socket, &on_socket_disconnected); // required
rws_socket_set_on_connected(_socket, &on_socket_connected);
rws_socket_set_on_received_text(_socket, &on_socket_received_text);

连接

rws_socket_connect(_socket);

向 WebSocket 发送消息

const char * example_text =
  "{\"version\":\"1.0\",\"supportedConnectionTypes\":[\"websocket\"],\"minimumVersion\":\"1.0\",\"channel\":\"/meta/handshake\"}";
rws_socket_send_text(_socket, example_text);

断开连接或删除 WebSocket 对象

由于套接字可以是连接的，我们需要发送断开连接消息，而不是简单的懒关闭，所以需要等待然后删除对象。这就是为什么只需调用 rws_socket_disconnect_and_release，它是线程安全的，然后忘记这个套接字对象。

rws_socket_disconnect_and_release(_socket);
_socket = NULL;

许可证

MIT 许可证 (MIT)

特此授予任何人获得本软件及其相关文档文件（“软件”）副本的权利，免费进行软件交易，包括（但不限于）使用、复制、修改、合并、发布、分发、再许可和/或出售软件副本的权利，并准许获得软件的人得以进行此类交易，但受以下条件的约束