优化websocket连接

docs/36字花-移动端接口设计草案.md

@@ -697,6 +697,31 @@
   - 订阅资金流：`{"action":"subscribe","topics":["bet.accepted","wallet.changed"]}`
   - 订阅托管流：`{"action":"subscribe","topics":["auto.spin.progress","wallet.changed"]}`
 
+#### 7.1.1 消息协议字段定义（联调口径）
+
+- 客户端 -> 服务端：
+  - `action`：动作名（当前约定 `ping` / `subscribe`）
+  - `topics`：仅 `subscribe` 时必填，表示要订阅的主题列表（数组）
+- 服务端 -> 客户端：
+  - `event`：事件名（如 `period.tick`、`wallet.changed`、`jackpot.hit`）
+  - `topic`：所属主题（通常与 `event` 一致；用于前端按主题路由）
+  - `data`：业务载荷（对象）
+  - `server_time`：服务端时间戳（秒，倒计时与对时基准）
+
+#### 7.1.2 订阅行为说明
+
+- **仅建立连接不会自动下发全部业务消息**；客户端需要发送 `subscribe` 明确订阅主题。
+- 成功订阅后服务端返回：`{"event":"ws.subscribed","topics":[...]}`。
+- 若未订阅主题，通常只能收到握手首帧（`ws.connected`）和心跳回包（`pong`）。
+
+#### 7.1.3 推送频率与触发规则（当前实现）
+
+- `period.tick`：**每秒一次**（用于倒计时、状态同步）。
+- `admin.live.snapshot`：**每秒一次**（后台实时对局页全量快照）。
+- `period.opened` / `period.payout` / `admin.live.opened`：按开奖流程阶段触发（事件触发型，非固定频率）。
+- `wallet.changed`：仅在余额发生变更时推送（如下注扣款、充值入账、派彩入账）。
+- `jackpot.hit`：**仅在本期存在中大奖命中用户时推送**；无命中不推送。
+
 ### 7.1A 后台连接方式（管理端联调）
 
 - 后台菜单：仅保留一个菜单 `连接服务器websocket`，用于统一联调 WebSocket