flare-core 概览
定位
flare-core 是 Rust 长连接库(Apache-2.0),面向 IM、实时推送、在线协作等需要 WebSocket / QUIC、协议协商与连接治理的场景。
它 不包含:会话列表、消息 seq、未读数、群组业务——这些属于 flare-im-core / flare-im-core-sdk。
能力清单
| 能力 | 说明 |
|---|---|
| 传输 | WebSocket(含 TLS)、QUIC;客户端多协议竞速 |
| 协商 | Protobuf / JSON;Gzip / Zstd |
| 连接 | 心跳、活跃检测、多设备冲突策略 |
| 认证 | Token 校验扩展点 |
| 构建模式 | ClientBuilder / ServerBuilder、FlareServerBuilder(生产推荐) |
分层
Application (ServerEventHandler, Authenticator)
↓
Core (ServerCore / ClientCore, ConnectionManager)
↓
Transport (HybridServer / HybridClient, WebSocket, QUIC)
何时只选 flare-core
- 你已有消息/会话存储,只需 统一长连接接入层
- 自定义二进制/Protobuf 帧,不需要 Flare IM 领域模型
- 网关、IoT、游戏房间信令等 非标准 IM 场景
资源
| 资源 | 链接 |
|---|---|
| 仓库 | monorepo flare-core/ |
| API | docs.rs/flare-core |
| 示例 | 仓库内 examples/、doc/ |