浏览 SDKs · Flutter
平台
SDKsFlutter商业版

查询群组通话房间

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

复制

按群组 ID 查询当前正在进行的音视频通话房间:

参数说明

参数类型是否必填说明
groupIDString是目标群组 ID。
final room = await OpenIM.iMManager.signalingManager
    .signalingGetRoomByGroupID(groupID: groupID);

if (room.roomID?.isNotEmpty == true) {
  renderParticipants(room.participant ?? const []);
}

返回结果

Future 成功返回 RoomCallingInfo 对象,包含房间基本信息、邀请详情与参与者列表。

字段类型说明
roomIDString?进行中的通话房间 ID;为空表示该群组当前没有进行中的通话。
invitationInvitationInfo?当前通话的邀请详情。
participantList<ParticipantInfo>?当前房间内的参与者列表。
tokenString?房间入会凭据。

若返回的 roomID 非空,可结合获取通话房间 Token获取媒体凭证加入通话。若无进行中的群通话,应把空房间视为无可恢复通话,不要继续使用旧凭据。