服务介绍
欢迎使用融云即时通讯。本页面简单介绍了融云即时通讯架构、体系和关键概念。
融云的架构设计特点:
- 无需改变现有 App 的架构,直接嵌入现有代码框架中;
- 无需改变现有 App Server 的架构,独立部署一份用于用户授权的 Service 即可;
- 专注于提供通讯能力,使用私有的二进制通信协议,消息轻量、有序、不丢消息;
- 安全的身份认证和授权方式,无需担心 SDK 能力滥用(盗用身份的垃圾消息、垃圾群发)问题。
融云即时通讯服务不要求在 App 之外建立并行的用户体系,不需要您同步 App 的用户资料到融云,不影响 App 现有的系统架构与帐号体系,与现有业务体系能够实现完美融合。
功能特性
融云目前已提供即时通讯产品单聊、群聊、超级群、聊天室,在融云业务中,这些产品对应不同的会话类型。
单聊(Private)业务即一对一聊天。群组(Group)业务类似微信群。超级群与聊天室业务均不设用户总数上限。超级群 (UltraGroup) 类似 Discord,提供了一种新的群组业务形态,在超级群中提供公有/私有频道、用户组等功能,适用于构建超级社区。聊天室(Chatroom)只有在线用户可接收消息,广泛适用于直播、社区、游戏、广场交友、兴趣讨论等场景。
单聊、群组、超级群、聊天室的主要差异如下:
功能 | 单聊(Private) | 群组(Group) | 超级群(UltraGroup) | 聊天室(Chatroom) |
---|---|---|---|---|
场景类比 | 类似微信私聊 | 类似微信群组 | 类似 Discord | 聊天室 |
特性/优势 | 支持离线消息推送和历史消息记录漫游 | 支持离线消息推送和历史消息记录漫游,可用于兴趣群、办公群、客服服务沟通等 | 不限成员数量;支持修改已发消息;提供公有/私有频道、用户组等社群功能 | 不限成员数量;只有在线用户可接收消息,退出时清除本地历史消息 |
计费套餐 | 所有 | 所有 | 仅限 IM 尊享版 | 所有 |
开通服务 | 不需要 | 不需要 | 需要 | 不需要 |
UI 组件 | 提供 Android/iOS/Web 版 IMKit/Global IM UIKit | 提供 Android/iOS/Web 版 IMKit/Global IM UIKit | 不提供 | 不提供 |
创建方式 | 无需创建 | 服务端 API | 服务端 API | 服务端 API |
销毁/解散方式 | 不适用 | 服务端 API | 服务端 API | 服务端 API,或者通过自动销毁机制 |
成员数量限制 | 不适用 | 群成员数上限 3000 | 不限 | 不限 |
用户加入限制 | 不适用 | 不限 | 最多加入 100 个群,每个群中可加入 50 个频道 | 默认仅可加入 1 个聊天室,可自行关闭限制 |
获取加入前的消息 | 不适用 | 默认不允许,可自行关闭限制 | 默认不允许,可自行关闭限制 | 客户端加入聊天室即可获取最新消息,最多 50 条 |
客户端发送消息频率 | 每个客户端 5 条/秒 | 每个客户端 5 条/秒 | 每个客户端 5 条/秒 | 每个客户端 5 条/秒, |
服务端发送消息频率 | 默认限频见 API 接口列表,可付费上调。 | 默认限频见 API 接口列表,可付费上调。 | 默认限频见 API 接口列表,可付费上调。 | 默认限频见 API 接口列表,可付费上调。 |
扩展消息 | 支持 | 支持 | 支持 | 不支持 |
修改消息 | 不支持 | 不支持 | 支持 | 不支持 |
消息可靠度 | 100% 可靠 | 100% 可靠 | 100% 可靠 | 超出服务端消费上限的消息将被主动抛弃,可开通消息优先级服务、聊天室白名单服务。 |
消息本地存储 | 移动端、PC 端支持 | 移动端、PC 端支持 | 移动端、PC 端支持 | 不支持 |
消息云端存储 | 需开通,可存储 6 - 36 个月 | 需开通,可存储 6 - 36 个月 | 默认存储 7 天,提供 3 - 36 个月存储服务 | 需开通,可存储 2 - 36 个月 |
离线缓存消息 | 默认 7 天离线消息缓存 | 默认 7 天离线消息缓存 | 不支持 | 不支持 |
消息本地搜索 | 支持 | 支持 | 支持 | 不支持 |
离线消息推送* | 支持 | 支持 | 支持,可调整推送频率 | 不支持 |
* 离线消息推送服务是指使用融云 IM 云端推送服务,在用户离线时通过第三方推送服务将通知推送到用户手机上。融云负责对接厂商推送平台,已覆盖小米、华为、荣耀、OPPO(适用于一加、realme)、vivo、魅族、FCM、APNs 手机系统级推送通道。支持标签推送、多种推送场景、推送统计、全量用户通知等特性。
高级与扩展功能
IM 服务支持的高级与扩展功能,包括但不限于以下项目:
- 用户管理:例如用户封禁、用户黑名单(拉黑)、用户白名单,群组及聊天室禁言、聊天室成员封禁等。
- 在线状态订阅:将用户每一个终端在线、离线或登出后的状态,同步给应用开发者指定的服务器地址。
- 多设备在线消息同步:同时支持桌面端、移动端、以及多个 Web 端之间的消息在线同步。
- 全量消息路由:支持将单聊、群组、聊天室、超级群等的消息数据同步到应用开发者指定的服务器地址。
- 内容审核:支持设置敏感词列表,过滤或替换消息中的敏感词。利用消息回调服务,可将消息先转发到应用开发者指定的服务器地址,由应用服务器判定是否可发送给目标接收者。
- 服务端推送通知:支持标签推送、包名推送、推送统计、全量用户通知等特性。
部分功能需要在控制台开通服务后方可使用。部分为收费增值服务,详见即时通讯计费细则。
服务端
您的后端可利用融云服务端提供的 IM Server API 执行以下操作:
部分高级扩展特性仅在 IM Server API 中提供,例如 系统通知、在线用户广播、用户封禁等。详细描述,请参见 API 接口列表。
即时通讯业务提供服务端回调(Webhook),支持将业务的数据、状态通知同步到您设置的回调地址,例如用户在线状态变更、聊天室房间状态变更等。支持通过回调响应正文的参数控制消息是否发送给接收者。所有服务端回调均需要在控制台分别配置回调地址并启用。
客户端
您的应用程序可通过集成 IMLib SDK 和 UI 库来连接到融云服务、传输消息即时消息、以及构建其他功能。
- 即时通讯核心 SDK :IMLib SDK 旨在提供一种整合即时通讯通信 (IM) 能力的简单方案。借助 IMLib SDK 封装的通信能力和会话、消息等对象,您可以从头开始构建自己的 UI。请参阅 IMLib SDK。
- 即时通讯 UI 库 :IMKit 和 Global IM UIKit 是 UI 组件库,集成了会话与会话列表界面,并提供了丰富的自定义功能,可简化您的集成体验。请参阅 IMKit 以及 Global IM UIKit。
只要客户端(包括应用服务端)使用一致的 App Key,不同平台、不同版本 SDK 的客户端之间可以互通消息。
控制台
控制台作为一个综合服务平台,提供对 App Key、App Secret、计费操作和各种其他功能配置的一站式访问与管理能力。
您还可以使用控制台调试 IM Server API、查询消息状态、查询连接状态、添加 Webhook 等等。
数据与隐私
融云不会利用客户的数据。同时融云提供完善的数据隐私保护策略,欢迎了解 SDK 隐私政策。
如果需要存储、查看、获取与即时通讯相关的数据,请参考以下方式:
- 如需在云端长期存储单聊会话、群聊会话、聊天室会话的历史消息,您可以开通消息云存储服务。默认的长期存储时长与业务类型相关,可按需调整。该服务存储的数据仅供客户端获取历史消息时使用。
- 如需直接下载应用下全部用户的消息历史,请开通 Server API 历史消息日志下载。开通后可使用服务端 API 获取最多三天的消息日志。
- 除此之外,您还可以开通全量消息路由服务,实时将消息同步到您的业务服务器。
- 您可以前往融云控制台数据统计页面,查看即时通讯用户统计、业务统计、消息统计、业务健康检查等数据。开通相应服务后,还能获取如业务数据分析等数据。