基础功能
本文档为融云开发者列出了即时通讯单聊、群聊、超级群和聊天室业务的基础功能。
单聊会话
单聊会话指两个用户一对一聊天。融云不维护用户关系,发送消息时不会验证是否为好友。会话由融云建立并保持,当 App 在后台运行或者 App 进程被杀死后,有新消息时会收到推送通知。
功能 | 描述 |
---|---|
离线消息 | 支持离线消息存储,存储时间可设置(1 ~ 7 天),默认存储 7 天。 |
消息提醒 | 离线状态,单聊中有新消息时,支持 Push 通知。 |
本地存储 | 接收过的消息存储在移动端本地,提供本地消息搜索功能。 |
历史消息 | 提供云端消息存储功能,需开通单群聊消息云存储单群聊消息云存储,默认存储时 长为 6 个月。 |
消息删除 | 存储在本地和云端的消息都支持删除功能。可以删除指定消息,也可以删除会话中全部历史消息。 |
消息搜索 | 支持按关键字或用户搜索本地指定会话的消息内容。 |
消息阅读回执 | 发送单聊消息后如需要查看消息的阅读状态,可以使用此功能来发送阅读回执请求。 |
消息撤回 | 消息发送成功后,可以撤回该条消息。IMLib 对撤回时间不做限制;IMKit 默认可撤回时间 2 分钟,时间可配置。 |
单聊会话免打扰 | 可设置指定单聊会话,收到新消息后是否提醒。默认进行新消息提醒。 |
单聊黑名单 | 不想接收到某一用户的消息时,可将此用户加入到黑名单中。应用中每个用户都可以设置自己的黑名单列表,请使用 Server API 接口设置黑名单。 |
单聊白名单 | 对用户相互发送消息有限制的客户,可使用用户白名单功能。将用户加入白名单后,才能收到该用户发送的单聊消息,请使用 Server API 接口设置白名单 用户白名单服务与用户黑名单服务不能同时使用,融云默认开启用户黑名单服务,如需要开通白名单服务请 提交工单申请开通。服务开通 15 分钟后生效,同时黑名单服 务不再生效。 |
发送状态消息 | 在线用户会收到此条消息,离线用户不会再收到此条消息。状态消息不计数、不存储。 |
群聊会话
群聊会话指两个以上用户一起聊天。群组成员信息由 App 提供并维系,融云负责将消息传达给群成员。
功能 | 描述 |
---|---|
离线消息 | 支持离线消息存储,存储时间可设置(1 ~ 7 天),默认存储 7 天。 |
消息提醒 | 离线状态,群组中有新消息时,支持 Push 通知。 |
本地存储 | 接收过的消息存储在移动端本地,提供本地消息搜索功能。 |
历史消息 | 提供云端消息存储功能,需开通单群聊消息云存储,默认存储时长为 6 个月。 |
消息删除 | 存储在本地和云端的消息都支持删除功能。可以删除指定消息,也可以删除会话中全部历史消息。 |
消息搜索 | 支持按关键字或用户搜索本地指定会话的消息内容。 |
群消息阅读回执 | 发送群消息后如需要查看消息的阅读状态,可以使用此功能来发送阅 读回执请求。 |
消息撤回 | 消息发送成功后,可以撤回该条消息。IMLib 对撤回时间不做限制;IMKit 默认可撤回时间 2 分钟,时间可配置。 |
群聊会话免打扰 | 可设置指定群聊会话,收到新消息后是否提醒,默认进行新消息提醒。 |
创建群组 | App 内群组数量没有限制,默认一个群上限为 3000 人。 |
加入群组 | 每个群最大上限 3000 人,一个用户可加入多个群组,没有限制。默认加入群组后,只能查看加入后群组中产生的消息,如需要查看加入前的消息,则需要开通单群聊消息云存储后,再开通新用户获取加入群组前历史消息。 |
退出群组 | 将用户从群中移除,不再接收该群组的消息。 |
解散群组 | 将指定群组解散,所有成员都无法再接收该群的消息。 |
群成员查询 | 获取指定群组中群成员用户 Id。 |
刷新群组信息 | 支持更新群组名称。 |
同步用户所属群组 | 在集成融云前 App Server 已有群组数据,可使用此服务进行同步。 |
群组成员禁言 |