Class JCCRoomQueryInfo

房间信息查询结果类 JCCRoomQueryInfo

Remarks

封装了查询房间信息的结果数据，包含房间标识、房间号、成员数量以及成员用户ID列表等信息。 通过 JRoomManager.query 方法查询房间信息后，结果会通过 JRoomCallback.onQuery 回调返回此类的实例。 可用于在加入房间前检查房间是否存在、查看房间内的参与者等场景。

Example

// 查询特定房间信息
const operationId = roomManager.query("room123");

// 在回调中获取房间信息
onQuery(operationId: number, result: boolean, reason: JClientReason, queryInfo: JCCRoomQueryInfo) {
  if (result) {
    console.log(`房间ID: ${queryInfo.roomId}`);
    console.log(`房间号: ${queryInfo.roomNumber}`);
    console.log(`成员数: ${queryInfo.memberCount}`);
    
    // 获取并处理成员列表
    const members = queryInfo.memberUserIdList;
    for (let i = 0; i < members.length; i++) {
      console.log(`成员${i+1}: ${members.get(i)}`);
    }
  } else {
    console.error(`查询失败，原因: ${reason}`);
  }
}

Accessors

roomId roomNumber memberCount memberUserIdList

Accessors

roomId

  • get roomId(): undefined | string

    获取房间标识

    Returns undefined | string

    房间的唯一标识符

    Remarks

    返回房间的唯一标识符。如果房间不存在，依然会返回查询时提供的roomId。

roomNumber

  • get roomNumber(): undefined | number

    获取房间号

    Returns undefined | number

    服务器分配的房间号

    Remarks

    返回服务器为房间分配的唯一数字标识。 如果房间不存在或查询失败，此值可能为undefined。

memberCount

  • get memberCount(): undefined | number

    获取房间成员数量

    Returns undefined | number

    当前房间内的成员数量

    Remarks

    返回当前房间内的参与者数量。 如果房间不存在或查询失败，此值可能为undefined。

memberUserIdList

  • get memberUserIdList(): ArrayList<string>

    获取房间成员用户ID列表

    Returns ArrayList<string>

    包含所有房间成员用户ID的列表

    Remarks

    返回当前房间内所有参与者的用户ID列表。 如果房间不存在或查询失败，此列表可能为空。 可以通过遍历此列表获取每个成员的用户ID。

设置

主题