浏览 SDKs · Flutter
平台
SDKsFlutter商业版

查询会话置顶消息

使用 Flutter SDK 获取会话当前的置顶消息列表。

复制

拉取指定会话中当前处于置顶状态的消息列表快照:

参数说明

参数类型是否必填说明
conversationIDString是目标会话 ID。
final messages = await OpenIM.iMManager.messageManager
    .getConversationPinnedMsg(conversationID: conversationID);
replacePinnedMessages(conversationID, messages);

返回结果

Future 成功返回当前会话的置顶消息列表(List<Message>)。

该接口不包含置顶操作者或置顶时间戳等元数据字段。查询操作建立静态快照,不会触发事件通知;本地状态应按 conversationID 整体替换并按非空 clientMsgID 去重。后续置顶或取消置顶的完整变更与事件处理请参考置顶或取消置顶消息。