YStudio Y++

WebSocket类客户端:连接成功、消息到达、发送与关闭

Y++ / YStudio 开发文档 · 一点滴


slug: net-03-websocket title: WebSocket类客户端:连接成功、数据到达、发送与关闭 summary: WebSocket类连公开回显或自建服务;注册连接成功/失败/数据到达(消息到达同义);发送文本后关闭。 tags: WebSocket类,客户端,数据到达,ws series: supportlib-netcomm series_order: 3 type: tutorial


WebSocket类客户端:连接成功、消息到达、发送与关闭

面板:支持库 → 扩展类库 → WebSocket类。

硬约束

  1. 先注册事件,再 连接。推荐事件名:连接成功、连接失败、数据到达(消息到达 为旧名同义)。
  2. 数据到达 形参固定:(整数 连接ID, 文本 IP, 整数 端口, 文本 IP端口, 文本 数据)。
  3. 客户端 发送(文本) 不要带连接ID。
  4. 公开回显若不可用,改成你的 ws:// / wss://。

窗口:按钮连 按钮发 按钮关 文本框消息 编辑框日志

WebSocket类 g_ws
文本 g_url = "wss://echo.websocket.events"

函数 写日志(文本 s) {
    编辑框日志.文本 = 编辑框日志.文本 + s + 换行符
}

函数 已连(整数 连接ID, 文本 IP, 整数 端口, 文本 IP端口) {
    写日志("连接成功 " + IP端口 + " URL=" + g_ws.取URL())
}

函数 失败(文本 原因) {
    写日志("连接失败:" + 原因)
}

函数 到数据(整数 连接ID, 文本 IP, 整数 端口, 文本 IP端口, 文本 数据) {
    写日志("收到:" + 数据)
}

函数 主窗口.创建完毕() {
    g_ws.连接成功(&已连)
    g_ws.连接失败(&失败)
    // 写法 A:数据到达(推荐)
    g_ws.数据到达(&到数据)
    // 写法 B:消息到达(&到数据) 同义
    g_ws.置超时(8000)
}

函数 按钮连.单击(整数 X, 整数 Y) {
    // 写法 A:异步(成败看事件)
    如果 (g_ws.连接(g_url) == 假) {
        写日志("未能开始连接:" + g_ws.取错误())
        返回 ()
    }
    写日志("开始连接…")
    // 写法 B:同步
    // 如果 (g_ws.连接_同步(g_url) == 假) { 写日志(g_ws.取错误()) }
}

函数 按钮发.单击(整数 X, 整数 Y) {
    如果 (g_ws.是否已连接() == 假) {
        写日志("未连接")
        返回 ()
    }
    文本 msg = 文本框消息.文本
    如果 (msg == "") {
        msg = "hello-ws"
    }
    如果 (g_ws.发送(msg) == 假) {
        写日志("发送失败:" + g_ws.取错误())
    } 否则 {
        写日志("已发:" + msg)
    }
}

函数 按钮关.单击(整数 X, 整数 Y) {
    g_ws.关闭(1000, "bye")
    写日志("已关闭")
}

函数 主窗口.即将关闭() {
    如果 (g_ws.是否已连接()) {
        g_ws.关闭()
    }
}

对照:WebSocket类