消息仅投递在线用户

功能说明

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

使用限制

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

前提条件

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

• 完成 SDK 初始化，详见 快速开始。
• 初始化 SDK 时已注册 ChatManager，能够通过 client.chatManager 调用消息相关接口。
• 了解环信即时通讯 IM 的使用限制，详见 使用限制。

仅向在线用户投递消息

要将消息只投递给在线用户，你需要在创建消息时设置 deliverOnlineOnly: true，或在发送前将 message.deliverOnlineOnly 设置为 true。

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

const message = client.chatManager.createTextMessage({
  conversationId: 'user2',
  conversationType: 'singleChat',
  content: '这条消息只有在线才能收到',
  deliverOnlineOnly: true,
});

await client.chatManager.sendMessage(message);

接口列表

API 名称	所属模块/类	说明
createTextMessage	ChatManager	创建文本消息。
sendMessage	ChatManager	发送消息。