SDKsuni-app / uni-app x

查询指定会话

按单聊用户或群组查询一条会话记录。

getOneConversation() 适合从联系人、用户资料或群资料进入聊天页。单聊把对方 userID 作为 sourceID；群聊把 groupID 作为 sourceID。不要自行拼接 conversationID 或构造会话对象。

参数说明

参数	类型	是否必填	说明
`sourceID`	`string`	是	单聊为对方用户 ID，群聊为群组 ID。
`sessionType`	`OpenIMSessionType`	是	单聊使用 `OpenIMSessionTypeSingle`，群聊使用 `OpenIMSessionTypeWriteGroup`。

import {
  OpenIMSessionTypeSingle,
  getOneConversation,
} from '@/uni_modules/unix-openim-sdk'

const conversation = await getOneConversation({
  sourceID: targetUserID,
  sessionType: OpenIMSessionTypeSingle,
})

if (conversation != null) {
  openChatPage(conversation)
}

Promise 成功后返回 OpenIMConversationItem | null，字段含义见获取会话列表。该查询只返回调用时的数据，不会触发会话事件；后续变化应按 conversationID 合并，完整监听见会话列表页。

这个页面有帮助吗？