跳至正文

三条集成路径

路径 A — 仅传输层(flare-core)

适合:自有消息模型与存储,只需稳定长连接。

步骤动作
1引入 flare-core,实现 ServerEventHandler
2定义 Payload / Frame 与客户端契约
3自建鉴权、房间、路由

文档:flare-core 快速开始 · docs.rs


路径 B — 完整 IM 客户端(flare-im-core-sdk)

适合:后端已是 Flare IM(或兼容 flare-proto 的网关),重点做 App / 桌面。

步骤动作
1SdkConfig 配置 endpoint / http_endpoint / tenant_id
2initlogin,注册 EventBus
3sync_messages(conv_id, last_seq, limit) 增量同步
4可选:C FFI / Tauri 绑定

文档:/docs/sdk/02-quickstart


路径 C — 自建 IM 后端(flare-im-core + SDK)

适合:私有化完整 IM,按需挂 Hook / Social。

步骤动作
1Compose 起基础设施
2启动 flare-im-core 微服务
3SDK 或 Tauri 示例对接默认端口
4业务扩展 → Hook / Extension(见 flare-im-core flare-capabilityconfig/hooks.example.toml

文档:Core 快速开始 · /docs/server


对照表

需求选型许可
自定义协议长连接flare-coreApache-2.0
标准 IM 客户端flare-im-core-sdkApache-2.0
标准 IM 服务端flare-im-coreApache-2.0
自定义业务域HookPlugin / ExtensionPlugin与 Core 编译隔离

常见问题

Q:能否只用 SDK 不部署 flare-im-core?
A:可以,若你提供兼容的 signaling 与 gRPC 端点(需自行保证 seq / 同步语义一致)。

Q:如何扩展风控、审计?
A:实现 HookPlugin,在 pre_send 等生命周期接入;不修改 flare-im-core 源码。