# OnlineBattleManager.getRoomList(Object option)
以 Promise 风格调用:支持
# 功能描述
获取房间列表,查看当前可用的房间。
# 参数
# Object option
| 属性 | 类型 | 默认值 | 必填 | 说明 |
| data | Object | 否 | 获取房间列表请求数据 | |
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
# data 对象结构
| 属性 | 类型 | 必填 | 说明 |
| roomType | string | 否 | 房间类型(不填则拉取全部类型的房间) |
| offset | number | 否 | 偏移量(默认0) |
| limit | number | 否 | 请求获取的房间数量(默认20,最大100) |
# option.success 回调函数
# 参数
# Object res
| 属性 | 类型 | 说明 |
| rooms | Array | 房间列表(RoomInfo数组) |
| errMsg | string | 成功时为 "getRoomList:ok" |
# 示例代码
let tapOnlineBattle = tap.getOnlineBattleManager();
// 回调风格
tapOnlineBattle.getRoomList({
data: {
roomType: "新手区",
offset: 0,
limit: 20
},
success: (res) => {
console.log('房间列表:', res.rooms);
if(res.rooms && res.rooms.length > 0) {
console.log('第一个房间ID:', res.rooms[0].id);
console.log('第一个房间名称:', res.rooms[0].name);
} else {
console.log('当前没有可用房间');
}
},
fail: ({errMsg, errno}) => {
console.error('获取房间列表失败:', errMsg);
}
});
// Promise风格
tapOnlineBattle.getRoomList({
data: {
roomType: "新手区",
offset: 0,
limit: 20
}
}).then(res => {
console.log('房间列表:', res.rooms);
}).catch(error => {
console.error('获取房间列表失败:', error);
});
