外观
接入前准备
密信 IM 开发版 5.0 用于把即时通讯接入已有产品。你的业务服务继续管理账号、组织和业务权限;IM 服务负责会话、消息、群组和同步;客户端通过 SDK 直接连接 IM 服务。
选择接入组合
| 目标 | 组合 | 需要自行完成 |
|---|---|---|
| 使用标准聊天界面 | IM SDK + UIKit | 业务登录、导航、品牌配置与系统权限 |
| 完全自定义聊天界面 | IM SDK | 页面、消息呈现和交互 |
| 增加音视频通话 | Call SDK,可配 Call UIKit | 媒体服务、权限与推送接入 |
| 对接已有业务后台 | Server API + Webhook | 用户映射、事件消费、业务鉴权 |
SDK 与源码通过授权交付,配套提供组件、接入资料和版本清单。本站文档用于选型和集成,获取交付包请联系客服。
准备四类信息
- 业务账号:稳定的用户 ID、昵称与头像,两个可用于互发消息的测试账号。已有字符串主键的系统,需先设计到 IM 数值 ID 的稳定映射。
- 服务地址:客户业务 API、IM REST、IM WebSocket;需要通话时另外准备媒体服务地址。本文所有
example.com地址均为占位示例。 - 服务端授权:由部署方给业务后端配置调用方标识、密钥和允许访问的 API。密钥只保留在后端。
- 客户端版本:确定目标平台与配套 SDK/服务端版本,按平台接入说明选择 UIKit、推送与音视频组件。
确定部署网络
私有化可以部署在客户自有机房、专有云或指定云资源内,支持按项目规划内网、外网或两者结合的访问方式。部署时分别配置业务 HTTP、IM WebSocket、对象存储和音视频媒体的网络入口。
IM REST 接受 HTTP/HTTPS,WebSocket 接受 WS/WSS。生产环境使用 HTTPS/WSS 并正确校验证书,为通信链路提供 TLS 保护。
接入顺序
先用两个账号完成登录、文本收发、断线恢复和退出,再接入附件、群组、通话和业务事件,便于逐步串联完整业务流程。
按顺序阅读:业务账号与用户映射 → 登录与 IM Session → 发送第一条消息。平台配置见 Flutter,环境规划见 私有化部署。