logo
当前页

使用 ZIM SDK 实现离线推送

2026-04-02

ZIM 支持在发送单聊消息、发送群组消息、发起呼叫邀请等场景,使用离线推送消息的功能。

注意

在实现离线推送前,请确保:

实现流程

场景 1:发送 “单聊消息” 或 “群组消息” 时使用离线推送功能

  1. 首先开发者需要通过 ZIMPushConfig 对象,设置离线推送标题、内容、以及其他自定义属性。

  2. 然后通过 ZIMMessageSendConfig 对象的 pushConfig 参数,配置离线消息的相关配置等。

  3. 发送方调用 sendMessage,传入 “sentConfig”,向接收方发送单聊消息或者向群组发送群聊消息。

  4. 接收方或者群组内的用户,如果处于离线状态,将会在上线后,接收到发送方之前发送的离线消息。

zim::ZIMPushConfig pushConfig;
pushConfig.title = "离线推送标题";
pushConfig.content = "离线推送内容";
pushConfig.payload = "自定义透传字段,非必填";
pushConfig.resourcesID = "资源ID";

zim::ZIMMessageSendConfig sendConfig;
sendConfig.pushConfig = pushConfig;

zim::ZIMMessage* message = nullptr;
zim::ZIMTextMessage text_message;
text_message.message = "message";
message = &text_message;

zim::ZIMConversationType type = zim::ZIMConversationType::ZIM_CONVERSATION_TYPE_PEER
auto notification = std::make_shared<zim::ZIMMessageSendNotification>(
            [=](const std::shared_ptr<zim::ZIMMessage> &message) { int i = 0; });
// 单聊时,toConversationID 即是对方的 userID;群组时,toConversationID 即是群组的 groupID。
zim_->sendMessage(message, "toConversationID", type, sendConfig, notification,
                    [=](const std::shared_ptr<zim::ZIMMessage> &message,
                              const zim::ZIMError &errorInfo) { int i = 0; });

场景 2:发送呼叫邀请时使用离线推送功能

  1. 开发者通过 ZIMPushConfig 对象,设置离线推送标题、内容、以及其他自定义属性。

  2. 然后通过 ZIMCallInviteConfig 对象的 pushConfig 参数,配置离线消息的相关配置等。

  3. 发送方调用 callInvite,传入 “callInviteConfig”,发起呼叫邀请。

  4. 被邀请的用户若处于离线状态,将会收到对应的离线推送,上线后,若呼叫邀请还未结束,将会收到 onCallInvitationReceived 的回调。

zim::ZIMPushConfig pushConfig;
pushConfig.title = "离线推送标题";
pushConfig.content = "离线推送内容";
pushConfig.payload = "自定义透传字段,非必填";
pushConfig.resourcesID = "资源ID";

zim::ZIMCallInviteConfig callInviteConfig;
callInviteConfig.pushConfig = pushConfig;


zim_->callInvite(invitees, callInviteConfig, [=](std::string callID, zim::ZIMCallInvitationSentInfo info, zim::ZIMError errorInfo) {}); 

场景 3:iOS 通知分组

开发者在通知发送端配置 ZIMPushConfigthreadID 参数,即可实现 iOS 离线推送的通知分组效果。

zim::ZIMPushConfig pushConfig;
pushConfig.title = "离线推送标题";
pushConfig.content = "离线推送内容";
pushConfig.threadID = "通知分组标志";

场景 4:iOS 通知徽标数量

开发者可通过调用 updateUserBadge 接口更新徽标数量。

常见使用场景为:多端登录时,如果某端清除了某个会话未读消息数后,iOS 端的通知徽标数量需要同步减掉该会话的未读消息数。 比如,当前徽标数量为 10,清除的会话未读数为 8,那么可调用此接口更新徽标数量为 2。

zim_->updateUserBadge(2, [=](zim::ZIMError errorInfo) {}); 

上一篇

呼叫邀请

下一篇

resourcesID 说明

当前页

返回到顶部