消息仅投递在线用户

功能说明

环信即时通讯 IM 支持只将消息投递给在线用户。若接收方不在线，则无法收到消息。该功能适用于只需向在线用户展示的实时信息，例如通过透传消息更新群投票票数：在线用户关注实时变化，离线用户再次上线时由业务侧获取最终状态。

使用限制

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

前提条件

开始前，请确保满足以下条件：

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

仅向在线用户投递消息

要将消息只投递给在线用户，你需要发送消息时将 ChatMessage#deliverOnlineOnly 设置为 true。

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

// 创建一条文本消息，`content` 为消息文字内容。
// `conversationId` 为消息接收方，单聊时为对端用户 ID、群聊时为群组 ID。
final message = ChatMessage.createTxtSendMessage(
  targetId: conversationId,
  content: content,
  // 会话类型：单聊为 ChatType.Chat，群聊为 ChatType.GroupChat，默认为单聊。
  chatType: ChatType.Chat,
);
// 设置为 true 时，消息只投递给在线用户；若接收方离线，服务器会丢弃该消息。
// 默认值为 false：不论用户是否在线均投递。接收方离线时，消息会在其再次上线后投递。
message.deliverOnlineOnly = true;
// 发送消息。
await ChatClient.getInstance.chatManager.sendMessage(message);

接口列表

API 名称	所属模块/类	说明
createTxtSendMessage	ChatMessage	创建待发送的文本消息。
deliverOnlineOnly	ChatMessage	设置消息是否只投递给在线用户。
sendMessage	ChatManager	发送消息。