浏览 SDKs · WASM
平台
SDKsWASM

置顶或取消置顶会话

设置指定会话在当前用户会话列表中的置顶状态。

复制

通过将 isPinned 设置为 true 或 false,可以针对当前登录用户将指定会话置顶或取消置顶。置顶状态仅影响当前用户的会话展示顺序,不会影响其他群成员或单聊对方:

await openimsdk.setConversation({
  conversationID,
  isPinned: true,
});

传入 true 表示置顶,传入 false 表示取消置顶。

接口调用成功后,SDK 会触发 SdkEvent.OnConversationChanged 事件通知会话变更。前端可根据 conversationID 更新对应会话的 isPinned 属性,并按置顶状态与最后更新时间重新排列会话列表。完整的事件监听配置请参考获取会话列表。