Promise GameServerManager.createRoom(object object)

创建游戏房间

参数

object object

属性 类型 默认值 必填 说明
maxMemberNum number 房间最大人数
startPercent number 0 需要满足百分比的玩家都发送了开始指令才能启动游戏。有效范围 0~100,0 表示只要有一个人调用开始就启动,100 表示要求所有人都开始才能启动。
needUserInfo boolean false 是否需要用户头像和昵称
gameLastTime number 1200 游戏对局时长,到达指定时长时游戏会结束,最大值 3600。
roomExtInfo string 游戏自定义的关于房间扩展信息,其他人可在 RoomInfo 中读取到最多 32 个字节
memberExtInfo string 游戏自定义的关于个人的扩展信息,其他人可在 MemberInfo 中读取到,最多 32 个字节
needGameSeed boolean false 是否需要生成游戏随机种子,设置为 true,房间信息会携带 gameSeed 属性
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

object.needUserInfo 的合法值

说明 最低版本
true 需要用户头像和昵称,则每个加入房间的人必须授权过用户信息,MemberInfo 中会有 headimage 和 nickname
false 不需要用户头像和昵称,MemberInfo 中不会有 headimage 和 nickname

object.success 回调函数

参数
object res
属性 类型 说明
data object

res.data 的结构

属性 类型 说明
accessInfo string 房间唯一标识
clientId number 用户在房间内的唯一标识

返回值

Promise

调用结果返回的 Promise,resolve/reject 回调结果对应 success/fail。