浏览 SDKs · uni-app / uni-app x
平台
SDKsuni-app / uni-app x商业版

查询群组通话房间

按群组 ID 查询当前正在进行的通话房间。

复制

按 groupID 查询当前群组正在进行的通话房间信息,不接收自定义 roomID:

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

const result = await signalingGetRoomByGroupID({ groupID })

if (result?.roomID != null) {
  restoreGroupCall(result.roomID!, result.invitation)
} else {
  clearStaleGroupCall(groupID)
}

Promise 成功后返回 OpenIMSignalingGetRoomByGroupIDResult | null:

字段类型说明
roomIDstring 或 null当前群通话的房间 ID。
invitationOpenIMSignalingInvitationInfo 或 null当前房间对应的邀请数据。

结果为空或没有有效 roomID 时,表示当前群组没有可恢复的通话房间,客户端应清理本地旧通话状态。Promise 被拒绝表示查询失败;除非服务端明确返回房间不存在的业务错误码,否则不要将网络超时或鉴权失败判定为没有通话。通话事件监听与界面同步见处理通话事件。