Skip to content

WebSocket 服务(IRocWebSocketService) ​

  • 接口:RocPlay.Services.Network.IRocWebSocketService
  • 状态枚举:WebSocketConnectionState(Disconnected / Connecting / Connected / Disconnecting / Error)
  • 实现(二选一、条件编译,勿同时注册两实现到同一包体)
    • 非仅 WebGL Player、含编辑器:RocWebSocketService(ClientWebSocket)
    • 仅 WebGL Player:RocWebSocketWebGlService + RocWebSocketWebGL.jslib
    • 类上均为 [RocImplementation(typeof(IRocWebSocketService), Priority = 0)]
  • 源码目录:Assets/RocPlay/Services/Network/WebSocket/

帧语义 + 浏览器/WebGL 特例 与 TCP 差异大,因此单独 「连接与帧」 与 「WebGL 与浏览器」 两册;总览仍先读心智。


最小心智模型 ​

  1. 只 Resolve 接口:业务不要 if 选具体实现;同一包体只应存在一种 IRocWebSocketService 实现。
  2. ws:// / wss:// URL:生产 https 页面须 wss://。
  3. 文本与二进制帧:SendTextAsync / SendBinaryAsync 与对应事件。
  4. WebGL 真机验证:编辑器多为 ClientWebSocket;浏览器链路需在 WebGL 构建 下冒烟。
  5. 与 TCP、HTTP 分工:字节流长连见 TCP 服务;短连见 辅助工具 · HTTP;WebGL、.jslib、自定义实现见 WebGL 与浏览器。

职责(摘要) ​

异步以 ws:// 或 wss:// URL 建连、收发文本与二进制帧,并通过事件推送到业务层。


分册(按阅读顺序) ​

顺序分册说明
1连接与帧API、ws/wss、Resolve
2WebGL 与浏览器双实现、运维、.jslib、自定义
3示例最小连接与收发

→ 基础服务总览