消息仅投递在线用户

功能说明

环信即时通讯 IM 支持只将消息投递给在线用户。若接收方不在线，则无法收到消息。该功能用于实现应用只需要向在线用户进行展示目的，例如，利用透传消息实现群投票的票数实时变化, 只有在线用户需要关注实时变化的动态, 离线用户只需要再次上线时获取最终状态。

使用限制

• 适用会话类型： 仅支持单聊和群组聊天，不适用于聊天室。
• 支持消息类型： 各类型的消息均支持该功能，仅投递给在线用户。
• 离线存储限制： 不支持离线存储。 若发送消息时接收方离线，则无法收到消息；即使重新登录后，也不会收到该消息。普通消息在接收方在线时实时送达；接收方离线时会触发离线推送，并在再次上线后由环信 IM 服务器下发离线期间的消息。
• 漫游存储限制： 默认不支持漫游存储。发送的消息默认不存储在环信消息服务器，用户无法在其他终端设备获取该消息。如需开通在线消息的漫游存储，需联系环信商务。

前提条件

• 完成 SDK 初始化，详见 快速开始。
• 了解环信即时通讯 IM 的使用限制，详见 使用限制。

仅向在线用户投递消息

要将消息只投递给在线用户，你需要在发送消息时将 deliverOnlineOnly 设置为 YES。接收方离线时，服务器不会投递该消息。

下面以发送文本消息为例进行说明：

// 调用 initWithText 创建文本消息。`content` 为文本消息的内容。
EMTextMessageBody *body = [[EMTextMessageBody alloc] initWithText:content];
// 消息接收方：单聊为对端用户的 ID，群聊为群组 ID。
EMChatMessage *message = [[EMChatMessage alloc] initWithConversationID:conversationId body:body ext:nil];
// 会话类型：单聊为 `EMChatTypeChat`，群聊为 `EMChatTypeGroupChat`。
message.chatType = EMChatTypeChat;
// 消息是否只投递在线用户。（默认）`NO`：不论用户是否在线均投递；`YES`：只投递给在线用户。若用户离线，消息不投递。
message.deliverOnlineOnly = YES;
// 发送消息。
[[EMClient sharedClient].chatManager sendMessage:message progress:nil completion:nil];

接口列表

API 名称	所属模块/类型	说明
deliverOnlineOnly	EMChatMessage	设置消息是否只投递在线用户。
sendMessage	IEMChatManager	发送消息。