WuKongEasySDK

WuKongEasySDK 通过 WebSocket JSON-RPC CONNECT 提供轻量连接与在线消息 API。它适合已经拥有业务后端、希望自己维护界面和产品状态的应用。

选择平台，发送第一条消息

完成对应教程后，你会让 Alice 与 Bob 分别连接，在个人 Channel 中双向发送一个文本 JSON Payload，并在退出时正确移除监听器和连接。

先判断是否适合

EasySDK 不是聊天 UI，也不是完整产品后端。send 成功表示服务端返回了发送结果，不表示对方已经收到、展示或处理消息。需要完整能力时，回到 SDK 选择。

开始前：由业务后端提供连接材料

客户端不应该创建自己的身份或调用 Product HTTP 管理接口。用户登录产品后，受信业务后端通过 HTTPS 返回最小连接材料：

{
  "uid": "alice",
  "token": "short-lived-token",
  "websocketUrl": "wss://im.example.com/ws"
}

先完成认证与 Token。当前默认组合不会因为 /user/token 保存成功就自动获得生产级 CONNECT 校验；部署必须接入可信验证器，并证明无效、过期和撤销 Token 会被拒绝。

Alice 与 Bob 验收闭环

四个平台遵循同一条最小路径：

1. 为 Alice 和 Bob 分别取得自己的 uid、短期 token 与 websocketUrl；
2. 在两个独立设备、进程或浏览器上下文中按平台教程创建客户端；
3. 两端都观察到连接成功后，Alice 向个人 Channel bob 发送文本 JSON Payload；
4. Alice 保存发送结果，Bob 在实时消息事件中核对 fromUid、Channel 与 Payload；
5. Bob 向 Alice 回发，验证反向链路；
6. 退出页面或账号，移除监听器并断开连接，确认没有重复事件或后台连接。

这个闭环只验证在线消息。发送确认、实时接收与业务完成是三个不同状态，具体建模见消息收发。

希望先验证环境时，直接按运行官方示例使用已通过的服务端和客户端 revision，不必先把教学代码移入自己的应用。

四端生命周期差异

页面可以订阅连接状态，但不应因为页面重建而创建第二条连接。平台教程中的完整最小代码分别展示了正确的 owner 和清理位置。

上线前还要完成

• 使用 WSS，并验证证书、反向代理 WebSocket Upgrade 与设备侧可达性；
• 验证 Token 过期、撤销、错误身份和重放都会被拒绝；
• 在 Release 构建中保持 SDK 诊断关闭，并用非生产 canary 检查设备日志、Console、崩溃报告和采集器；
• 分别验收断网重连、离线恢复、去重、推送、多设备、容量、监控、升级与回滚；
• 记录服务端 revision、SDK 版本、平台、设备和网络环境，不把一次开发闭环当作生产 receipt。

继续使用上线检查关闭这些门禁。

版本与证据

当前正式发布版本

正式包运行凭据

应用依赖只使用这些精确版本，不使用 latest 或宽松版本范围。四个正式版本都已包含默认关闭、输出脱敏的日志安全修复：

当前教程的任务顺序校准自旧版 EasySDK 概览、iOS、Android、Flutter和 Web 页面；API、版本与安全边界以上表的正式源码和分发产物为准。

下一步

先运行官方示例，再选择目标平台完成应用接入。需要离线消息、会话、未读和更完整的平台 API 时，改用完整版 SDK。