ZEGO即时通讯SDK发布3.3.0版本,新增会话扩展字段、离线推送通知新增免打扰等功能

ZEGO即时通讯SDK发布3.3.0版本,新增会话扩展字段、离线推送通知新增免打扰等功能

💡 原文中文,约1300字,阅读约需3分钟。
📝

内容提要

ZEGO即时通讯SDK(ZIM)3.3.0发布,新增会话扩展字段、社群频道消息置顶与回复、离线推送免打扰及通知开关、入群申请查询、允许给自己发消息等功能;撤回消息时限延长至48小时,支持批量查询会话、展示置顶状态,社群成员查询单页最多1000条。

🔎

延伸解读

会话扩展字段:把业务数据挂到会话上

新增的会话扩展字段允许开发者为单聊、群聊附加自定义业务数据,例如会话标签分组、皮肤配置或业务属性标记。设置后,查询会话列表或收到会话变更通知时,扩展信息会通过 ZIMConversation.extendedData 返回。这意味着会话层面的个性化配置可以随会话数据一起下发,减少额外维护映射关系的成本,但需注意扩展字段的存储与同步依赖 SDK 的会话机制。

离线推送规则细化:开关与免打扰时段

ZIMUserOfflinePushRule 新增推送总开关、消息推送与呼叫推送的独立开关,以及每天固定时段的免打扰规则。用户可在个人设置页分别控制是否接收离线推送,并设置如 22:00 至次日 08:00 的免打扰时段。这为应用提供了更细粒度的通知管理能力,但免打扰时段仅针对离线推送,在线消息接收不受影响,开发时需区分在线与离线场景。

社群频道能力补强:置顶与回复

消息置顶(pinMessage / queryPinnedMessageList)与回复消息(replyMessage)能力从原有场景扩展到社群频道会话。频道内可将重要公告、规则固定在顶部,也可针对某条消息引用回复形成树状结构。结合消息列表展示置顶状态(ZIMTipsMessageEvent),社群运营者能更高效地组织频道内容,但置顶消息列表的查询与管理需调用对应接口。

查询与撤回优化:批量与时限调整

撤回消息的最大发送时长由 24 小时延长至 48 小时,为消息纠错留出更宽窗口。批量查询会话支持单次最多获取 100 个指定会话的详细信息,减少多次请求开销。社群用户列表查询的分页大小默认 100 条,可联系 ZEGO 技术支持调整为单页最多 1000 条。这些优化提升了管理效率,但批量查询和分页调整均有明确上限,需按接口约束使用。

❓

Q&A

ZIM 3.3.0 版本新增了哪些主要功能?

新增功能包括:会话扩展字段、社群频道消息置顶和消息回复、离线推送通知免打扰和不同类型的通知策略、入群申请列表查询、允许用户给自己发送消息。

会话扩展字段有什么作用?

会话扩展字段用于为单聊、群聊会话附加自定义业务数据,例如会话标签分组、会话皮肤配置、业务方会话属性标记等。设置后,查询会话列表或收到会话变更通知时,扩展信息会通过 ZIMConversation.extendedData 返回。

离线推送的免打扰功能怎么用?

用户离线推送规则(ZIMUserOfflinePushRule)新增推送开关与免打扰时间规则,可在个人设置页配置新消息通知、呼叫通知开关及免打扰时段。免打扰时段可设置每天固定时段(如 22:00 至次日 08:00)不收推送。

入群申请查询功能支持哪些操作?

支持查询指定群组的审批列表(含待审批与已审批记录),以及查询当前用户自己的入群申请与邀请记录。群主/管理员可在群管理页面进行审批或追溯;普通用户可在“我的申请”页面跟踪申请进度。

撤回消息的时限有什么变化?

撤回消息的最大发送时长由24小时放开至48小时。

批量查询会话有什么限制?

支持一次性获取多个指定会话的详细信息,单次最多可查询100个会话。

社群用户列表查询的分页大小可以调整吗?

可以。社群用户列表查询时的分页大小(默认100条)支持调整为单页最多1000条。如需调整,请联系ZEGO技术支持。

🏷️

标签

➡️

继续阅读