GameServerManager.onRoomInfoChange(function callback)
监听房间信息更新
参数
function callback
的回调函数
参数
Object res
| 属性 | 类型 | 说明 |
|---|---|---|
| res | Object |
res 的结构
| 属性 | 类型 | 说明 |
|---|---|---|
| appId | string | 小游戏 appId |
| roomIdStr | number | 房间 ID |
| roomState | number | 房间状态 |
| maxMemberNum | number | 房间最多可容纳人数 |
| createTimestamp | number | 创建时间 |
| updateTimestamp | number | 最近更新时间 |
| gameTick | number | 游戏下发帧的时间间隔，单位 ms |
| startPercent | number | 需要满足百分比的玩家都发送了开始指令才能启动游戏。有效范围 0~100，0 表示只要有一个人调用开始就启动，100 表示要求所有人都开始才能启动。 |
| roomExtInfo | string | 游戏自定义的关于房间的扩展信息 |
| gameLastTime | number | 游戏对局时长，单位 s |
| udpReliabilityStrategy | number | UDP可靠性策略， 0：全冗余 N：固定冗余N帧 |
| memberList | Array.<Object> | 成员列表 |
| seed | string | 游戏随机种子 |
roomState 的合法值
| 值 | 说明 | 最低版本 |
|---|---|---|
| 1 | 组队中 | |
| 2 | 该房间的对局游戏已开始 | |
| 3 | 该房间的对局游戏已结束 | |
| 4 | 房间已销毁 | |
| 5 | 房间连接已建立，等待对战连接建立 |
memberList 的结构
| 属性 | 类型 | 说明 |
|---|---|---|
| isReady | boolean | 玩家准备状态 |
| role | number | 角色 |
| posNum | number | 座位号，从 0 开始 |
| headimg | string | 头像 URL（房间 needUserInfo 为 true 时才会有） |
| nickname | string | 用户昵称（房间 needUserInfo 为 true 时才会有） |
| clientId | number | 用户在房间内的唯一标识 |
| enableToStart | boolean | 是否已做好游戏开始准备（调用过 startGame） |
| memberExtInfo | string | 游戏自定义的关于成员的扩展信息 |
role 的合法值
| 值 | 说明 | 最低版本 |
|---|---|---|
| 0 | 普通成员 | |
| 1 | 房主 |