SDKsuni-app / uni-app x商业版

查询分组内会话

分页查询指定会话分组及其中的会话详情。

会话分组属于商业版能力。按会话分组 ID 分页查询该分组资料及所属会话的详细列表。

参数说明

参数	类型	是否必填	说明
`conversationGroupID`	`string`	是	要查询的会话分组 ID。
`pagination.pageNumber`	`number`	是	页码，从 `1` 开始。
`pagination.showNumber`	`number`	是	每页读取的会话数量。

import { getConversationGroupInfoWithConversations } from '@/uni_modules/unix-openim-sdk'

const result = await getConversationGroupInfoWithConversations({
  conversationGroupID,
  pagination: {
    pageNumber: 1,
    showNumber: 20,
  },
})

if (result != null) {
  renderConversationGroup(
    result.conversationGroup,
    result.conversations,
    result.ConversationTotal ?? 0,
  )
}

返回结果

字段	类型	说明
`conversationGroup`	`OpenIMConversationGroupItem` 或 `null`	当前会话分组资料。
`ConversationTotal`	`number` 或 `null`	分组内会话总数；字段名首字母为大写。
`conversations`	`OpenIMConversationItem[]`	当前页会话详情。

分页加载完成条件应结合 ConversationTotal 和已加载条目数判断。客户端应以 conversationGroupID 合并分组资料，以 conversationID 合并各会话状态。查询本身不会触发分组事件；收到分组变化事件时，应参考会话分组概览重置分页并重新拉取。

这个页面有帮助吗？