发布日志
2025 年 01 月
发布日期：2025-01-06
新增功能
功能项 | 功能描述 | 相关接口 |
|---|---|---|
| 组合消息 | 新增组合消息类型，支持在一条消息中包含多种内容项，包括文本、图片、音频、视频、文件以及自定义消息。可实现如文本+图片、文本+视频、文本+音频等多种组合方式，灵活满足不同场景需求。 | MessageBody 说明 |
| 查询消息 | 支持在服务端通过传入 MsgSeq 列表查询单个指定会话（群聊、单聊）中的多条消息。 | 查询消息 |
| 消息发送前后回调支持获取媒体消息详细内容 | 当消息类型为媒体消息时，开发者可以通过这两个回调获取如原图宽高、大图宽高、缩略图宽高、视频首帧宽高等详细信息。 | |
| 宽高字段纠正 | 当调用服务端接口发送图片消息和视频消息时，ZIM 服务端会检查消息体中有关图片宽高、视频首帧宽高的字段。若相关字段不正确，ZIM 服务端会纠正相关字段。 | |
| 审核失败原因 | 发送消息接口的响应参数中新增了 AuditInfos 字段。当消息因审核未通过而导致发送失败时，该字段提供审核失败的详细原因。 |
改进优化
优化项 | 优化描述 | 相关接口 |
|---|---|---|
| 单个会话的标记数量限制上调 | 每个会话可拥有的标记数量上限从 20 上调至 30。 | 设置会话标记 |
2024 年 10 月
发布日期：2024-10-15
新增功能
功能项 | 功能描述 | 相关接口 |
|---|---|---|
| 查询用户信息 | 支持在服务端通过用户 ID 查询用户的信息，包含用户名称、用户头像和扩展字段。 | 查询用户信息 |
| 撤回房间消息 | 支持从服务端调用接口撤回房间消息。 | 撤回房间消息 |
改进优化
功能项 | 功能描述 | 相关接口 |
|---|---|---|
| 发送群聊消息响应参数优化 | 服务端 API SendGroupMessage 的响应参数新增 MsgId，可用于定位消息。 | 发送群组消息 |
| 消息发送后回调参数优化 | 当消息发送失败，消息发送后回调中的 msg_id 参数将不再为空。 | 消息发送后回调 |
| 获取消息拓展字段 | 支持通过消息发送前回调中的 payload 参数获取用户发送消息时传入的拓展字段。 | 消息发送前回调 |
MessageBody 扩展字段长度可上调 | MessageBody 结构中的 ExtendedData 长度上限默认为 1 KB。如需上调，请联系 ZEGO 技术支持。 | MessageBody 说明 |
2024 年 08 月
发布日期：2024-08-02
新增功能
功能项 | 功能描述 | 相关接口 |
|---|---|---|
| 会话标记 | 支持用户对会话设置标记，适用于需要关注某会话或无法处理某条会话的场景。可使用本功能实现会话分组，即对多个会话设置相同的标记。 | 设置会话标记 |
| 离线消息推送无限频 | 支持开发者在调用服务端接口 发送单聊消息 和 发送群组消息 向国内 Android 厂商进行无限频离线推送。 | MessageBody 说明 - OfflinePush - PushStrategyId |
| 服务端发送房间消息接口支持发送者有感知 | 新增 SenderUnaware 字段，允许通过服务端发送房间消息后，请求参数中的 FromUserId（发送方用户 ID）所对应的客户端对此次发送有感知。 | 发送房间消息 |
2024 年 05 月
发布日期：2024-05-31
新增功能
功能项 | 功能描述 | 相关接口 |
|---|---|---|
| 管理呼叫邀请 | 支持在服务端发起、接受和拒绝呼叫邀请。 | |
| 管理禁言 | 支持在服务端禁言群组和特定群成员。 | |
| 设置群成员角色 | 支持在服务端修改群成员的角色。 | 设置群成员角色 |
2024 年 03 月
发布日期：2024-03-29
新增功能
功能项 | 功能描述 | 相关接口 |
|---|---|---|
| 查询会话列表 | 支持在服务端分页查询用户最新的 1000 个会话（单聊与群聊）。 | 查询会话列表 |
| 查询历史消息 | 支持在服务端分页查询用户指定单聊或群聊会话的历史消息列表。 | |
| 修改群组规格 | 支持在服务端修改群组的入群验证模式、邀请模式、邀请目标验证模式和群成员人数上限。 | 修改群组规格限制 |
改进优化
功能项 | 功能描述 | 相关接口 |
|---|---|---|
| 服务端创建群组接口新增参数 | 新增 CreateGroupTime 参数，支持设置创建群组的事件。 | 创建群组 |
| 服务端添加群成员接口新增参数 | 新增 GroupMemberInfos 参数，支持定义入群用户的入群时间和入群模式。 | 添加群成员 |
2024 年 02 月
发布日期：2024-02-02
新增功能
功能项 | 功能描述 | 相关接口 |
|---|---|---|
| 设置会话免打扰 | 支持在服务端对群聊会话和单聊会话设置免打扰状态。 | 设置会话消息免打扰 |
| 置顶会话 | 支持在服务端为用户设置会话的置顶状态。 | 置顶会话 |
| 修改群资料 | 支持在服务端修改置顶群组的头像、名称和公告。 说明 如需使用此功能，请联系 ZEGO 技术支持了解详情。 | - |
| 管理好友 | 支持在服务端为用户添加和删除好友，查询好友列表，检查好友关系，更新好友备注和属性。 | |
| 管理黑名单 | 支持在服务端为用户批量拉黑、解除黑名单、查询黑名单、检查黑名单关系。 |
2024 年 01 月
发布日期：2024-01-05
新增功能
功能项 | 功能描述 | 相关接口 |
|---|---|---|
| 撤回消息 | 支持从服务端调用接口撤回单聊消息和群聊消息。 | |
| 修改用户资料 | 支持从服务端调用接口修改用户资料信息，包括用户昵称、头像等。 | 修改用户资料 |
改进优化
功能项 | 功能描述 | 相关接口 |
|---|---|---|
| 发送单聊消息接口新增响应参数 | 新增 SuccessList 参数，成员参数包含 UserId、MsgId 和 MsgSeq，说明消息接受成功用户的相关信息。MsgSeq 可用于 撤回单聊消息。 | 发送单聊消息 |
| 发送群聊消息接口新增响应参数 | 新增 MsgSeq，可用于 撤回群聊消息。 | 发送群聊消息 |
| 消息发送后回调新增字段 | 新增 user_list 字段，用于批量返回消息接收用户信息。说明：仅当开发者调用服务端接口 发送单聊消息 时，此字段有值。 | 消息发送后回调 |
2023 年 11 月
发布日期：2023-11-20
新增功能
功能项 | 功能描述 | 相关接口 |
|---|---|---|
| 添加群成员 | 支持将指定用户拉进至群组中。 | 添加群成员 |
| 解散群组 | 支持解散指定群组。 | 解散群组 |
| 转让群主 | 支持将群主转让给指定的群成员。 | 转让群主 |
| 设置群成员昵称 | 支持为指定群成员设置其群昵称。 | 设置群成员昵称 |
| 消息支持附带回执 | 通过服务端发送单聊消息、群聊消息时，可以附带回执功能，以便得知消息是否已读。支持的消息类型包含文本、图片、文件、音频、视频、自定义消息，详情请参考 MessageBody 说明。 | |
| 登录登出回调 | 在用户登录、退出时，ZIM 服务端会主动回调通知给开发者服务端。 | 登录登出回调 |
| 全员离线推送 | 在调用服务端接口进行全员推送时，支持选择推送类型，实现离线推送。 | 全员推送 |
改进优化
优化项 | 优化描述 | 相关接口 |
|---|---|---|
| 呼叫创建服务端回调 | 呼叫创建服务端回调新增 caller 字段说明发起呼叫的用户，详情请参考 呼叫创建回调。 | - |
2023 年 10 月
发布日期：2023-10-26
新增功能
功能项 | 功能描述 | 相关接口 |
|---|---|---|
| 新增信令消息支持类型 | 支持通过服务端发送经 base64 编码后的二进制信令消息，详情请参考 MessageBody 说明。 | - |
2023 年 08 月
发布日期：2023-08-31
新增功能
功能项 | 功能描述 | 相关接口 |
|---|---|---|
| 发送单聊消息接口支持发送者无感知 | 新增 SenderUnaware 字段，允许通过服务端发送单聊消息后，请求参数中的 FromUserId（发送方用户 ID）所对应的客户端对此次发送无感知。 | 发送单聊消息 |
| 发送房间消息接口支持发送者有感知 | 新增 SenderUnaware 字段，允许通过服务端发送房间消息后，请求参数中的 FromUserId（发送方用户 ID）所对应的客户端对此次发送有感知。 | 发送房间消息 |
| 全员推送 | 支持向所有在线用户（包括消息发送用户自己）发送特定内容的消息，如文本、图片等。本功能适用于全员活动公告、送礼跨房间飘屏等场景。 | 全员推送 |
| 查询用户是否在房间内 | 支持通过此接口，查询指定用户是否在目标房间内。 | 查询用户是否在房间内 |
2023 年 07 月
发布日期：2023-07-18
新增功能
功能项 | 功能描述 | 相关接口 |
|---|---|---|
| 获取房间成员信息 | 支持调用服务端接口，根据房间 ID 获取房间成员的信息，包括房间用户数量、用户 ID 及名称。 | 获取房间成员信息 |
| 消息发送接口新增支持更多消息类型 | 支持通过服务端接口发送图片、文件、音频、视频、自定义和弹幕类型消息，详情请参考 MessageBody 说明。 |
2023 年 05 月
发布日期：2023-05-23
新增功能
功能项 | 功能描述 | 相关接口 |
|---|---|---|
| 消息发送前回调 | 通过设置服务端回调，在用户发送单聊、群聊或房间聊天消息时，ZIM 向开发者服务端发送请求，开发者可实现：
| 消息发送前回调 |
| 消息发送后回调 | 通过设置服务端回调，在用户发送单聊、群聊、房间消息成功或失败后，ZIM 向开发者服务端发送请求，开发者可实现：
| 消息发送后回调 |
| 批量注册用户 | 支持调用服务端接口，指定用户信息（用户 ID 等），开发者可实现发起一次请求，注册多名用户。说明：最多支持一次性注册 100 名用户。 | 批量注册用户 |
| 查询 App 下的群列表 | 支持调用服务端接口获取 App 中所有群组的 ID。 | 查询 App 下的群列表 |
| 查询群成员列表 | 支持调用服务端接口，指定群组 ID，获取对应群组的成员列表。 | 查询群成员列表 |
| 移除群成员 | 支持调用服务端接口，指定群组 ID 和用户 ID，批量群成员。 说明 最多支持一次性移除 50 名群成员。 | 移除群成员 |
2023 年 01 月
发布日期：2023-01-11
新增功能
功能项 | 功能描述 | 相关接口 |
|---|---|---|
| 服务端新增呼叫邀请相关回调 | 用户可以通过 ZIM 服务端的回调，明确呼叫邀请的结果，适用于网络环境不好时，SDK 反馈的结果不稳定。 |