跳到主要内容

版本:2.X

群聊介绍

概述

群组指两个以上用户一起进行聊天,群组成员信息由 App 提供并进行维系,融云只负责将消息传达给群组中的所有用户。

主要功能

功能描述
离线消息支持离线消息存储,存储时间可设置(1 ~ 7 天),默认存储 7 天。
消息提醒离线状态,群组中有新消息时,支持 Push 通知。
本地存储存储在移动端本地,提供本地消息搜索功能。
历史消息提供服务端消息存储存功能,需开通单群聊消息云存储,默认存储时长为 6 个月。
消息删除支持按会话删除本地和存储在服务器的指定消息或会话中全部历史消息。
消息搜索支持按关键字或用户搜索本地指定会话的消息内容。
群消息阅读回执发送群消息后如需要查看消息的阅读状态,可以使用此功能来发送阅读回执请求。
消息撤回消息发送成功后,在有效时间内可撤回该条消息,默认可撤回时间为 2 分钟,时间可配置。
群聊会话免打扰可设置指定的群聊会话,收到新的消息后是否进行提醒,默认进行新消息提醒。
创建群组App 内的群组数量没有限制,默认一个群上限为 3000 人,可调整群上限,需要提交工单申请开通。
加入群组每个群最大至 3000 人,一个用户可加入多个群组,没有限制。默认加入群组后,只能查看加入后群组中产生的消息,如需要查看加入前的消息,则需要开通单群聊消息云存储后,再开通查看加入前群消息功能
退出群组将用户从群中移除,不再接收该群组的消息。
解散群组将指定群组解散,所有成员都无法再接收该群的消息。
群成员查询获取指定群组中群成员用户 Id。
刷新群组信息目前支持更新群组名称。
同步用户所属群组在集成融云前 App Server 已有群组数据,可使用此服务进行同步。
群组成员禁言被禁言用户可以接收查看群组中其他用户消息,但不能通过客户端 SDK 发送消息。
群组整体禁言指定群组所有成员不能发送消息,需要某些用户可以发言时,可将此用户加入到群禁言用户白名单中。
群组禁言用户白名单群组被整体禁言后,禁言白名单中用户可以发送群消息。
发送群组消息向群组中所有成员发送消息。
发送群组定向消息向群中指定的一个或多个用户发送消息,群中其他用户无法收到该消息。
发送群组 @消息发送群组中指定群成员需要特别关注的消息。
发送群组状态消息群组中在线用户会收到此条消息,离线用户不会再收到此条消息,状态消息不计数、不存储。

消息类型

消息类型描述
文字消息用来发送文字类消息,其中可以包括表情、超链接(会自动识别),客户端收到消息后计入未读消息数、进行存储。
语音消息发送高质量的短语音消息,录制的语音文件存储到融云服务端,语音文件格式为 AAC,时长上限为 60 秒,客户端收到消息后计入未读消息数、进行存储。
图片消息用来发送图片类消息,客户端收到消息后计入未读消息数、进行存储。图片缩略图格式为 JPG,大小建议不超过 100k。
GIF 图片消息用来发送 GIF 动态图片消息,客户端收到消息后计入未读消息数、进行存储。
图文消息用来发送图文消息,包含一个标题,一段文字内容和一张图片,客户端收到消息后计入未读消息数、进行存储。
文件消息用来发送文件类消息,客户端收到消息后计入未读消息数、进行存储。
位置消息用来发送地理位置消息,客户端收到消息后计入未读消息数、进行存储。
小视频消息用来发送小视频消息,支持录制发送及选择本地视频文件发送两种方式,录制时长不超过 10 秒,本地选择视频文件方式时长不超过 2 分钟,小视频消息小视频文件格式为 .mp4,客户端收到消息后计入未读消息数、进行存储。
合并转发消息IMKit SDK 中支持将多条消息合并为一条消息进行发送,合并后的消息以 HTML 文件的方式存储到融云服务端,客户端收到消息后计入未读消息数、进行存储。红包、阅后即焚及自定义消息的合并转发功能
命令消息用来发送通用的指令通知消息,消息内可以定义任意 JSON 内容,与通用命令通知消息的区别是不存储、不计数,此类型消息没有 Push 通知。
自定义消息融云内置消息类型,无法满足客户业务需求时,可通过自定义消息类型进行实现,接收自定义消息的格式解析及展示处理需要开发者自行实现

与聊天室的区别

融云提供群组与聊天室业务,其主要区别如下,客户可根据自己的业务场景进行选择:

功能群组(group)聊天室(Chatroom)
场景类似微信的群组,无论是否在线都会接收消息只有在线用户可接收消息,可用于直播、社区、游戏、广场交友、兴趣讨论等场景。
离线缓存消息支持离线消息存储,存储时间可设置(1 ~ 7 天),默认存储 7 天。无离线消息,只有在线用户才可收到聊天室消息
人数限制默认一个群上限为 3000 人聊天室人数无上限
消息提醒离线状态,群组中有新消息时,支持远程推送(PUSH)通知离开聊天室后不再接收消息
本地存储移动端本地数据库存储,提供本地消息搜索接口退出聊天室后同时删除本地聊天室消息,不支持消息搜索功能
云端存储需开通单群聊消息云存储,可以提供 6 - 36 个月存储服务需开通聊天室消息云存储,可以提供 2 - 36 个月存储服务
用户加入限制一个用户可加入多个群组,无限制默认一个用户只能加入一个聊天室,加入多个聊天室功能可在控制台自行开通
加入后消息获取逻辑默认加入群组后,只能查看加入后群组中产生的消息。如需要查看群历史消息,则需要开通单群聊消息云存储后,再开通“查看加入前群消息”功能加入后可获取聊天室中最新的 50 条消息。
销毁/解散逻辑需要通过 AppServer 自行调用解散群组接口。提供销毁聊天室接口,可通过 AppServer 调用。同时聊天室中 1 小时内没有消息产生时,将自动销毁聊天室。
消息可靠度100% 可靠,不丢消息。消息量较大时,超出服务端消费上限的消息将被主动抛弃。您可通过用户白名单、消息白名单、自定义消息级别等服务,改变消息抛弃策略。如果用户在聊天室的用户白名单内,该用户所发送的消息在消息量大时也不会被抛弃。

如需了解服务端消费上限与如何改变消息抛弃策略,可参见服务端文档消息优先级服务聊天室白名单服务
相关接口调用SDK 不提供群组管理功能接口,通过 Server API 提供群组功能接口。SDK 和 Server API 同时提供功能接口,销毁聊天室操作只能通过 Server API 方式调用。
发送消息频率每个客户端 5 条/秒;服务端调用,20 条/秒每个客户端 5 条/秒;服务端调用,100 条/秒