# GameServerManager

基础库 2.8.0 开始支持,低版本需做兼容处理

游戏服务管理器,可通过 wx.getGameServerManager 获取。

# 方法

# Promise GameServerManager.broadcastInRoom(object object)

在房间内广播

# Promise GameServerManager.cancelMatch(object object)

取消游戏匹配

# Promise GameServerManager.changeSeat(object object)

玩家换座位

# Promise GameServerManager.createRoom(object object)

创建游戏房间

# Promise GameServerManager.endGame()

结束帧同步

# Promise GameServerManager.endStateService()

结束游戏状态同步服务

# GameServerManager.getFriendsStateData()

获取所有好友的在线状态及信息。该接口需要用户授权,且只在开放数据域下可用。

# Promise GameServerManager.getLastRoomInfo()

获取最近参与房间的 accessInfo

# Promise GameServerManager.getLostFrames(object object)

补帧,补帧区间为 [beginFrameId, endFrameId),即左闭右合。

# Promise GameServerManager.getRoomInfo()

获取房间详情

# Promise GameServerManager.inviteFriend(object object)

邀请好友,该好友的系统状态必须为在线(该接口需要在开放数据域使用)

# Promise GameServerManager.joinRoom(object object)

加入游戏房间

# Promise GameServerManager.kickoutMember(object object)

把一名玩家踢出房间(仅房主有权限)

# Promise GameServerManager.login()

登录游戏服务

# Promise GameServerManager.logout()

登出游戏服务

# Promise GameServerManager.memberLeaveRoom(object object)

普通成员退出房间

# Promise GameServerManager.ownerLeaveRoom(object object)

房主退出房间,assign_owner_to_pos_num 参数被优先处理,其次是 assign_to_min_pos_num,如果二者都没有被设置,则房主退出且房间销毁。

# Promise GameServerManager.reconnect(object object)

重连游戏服务。如果此时连接并未断开或游戏未开始,会直接成功;如果游戏已开始并且连接已断开,会进行重连,并返回此时服务器的最大帧号。

# Promise GameServerManager.restart()

重启游戏并进入"组队中"的状态。如果当前房间游戏已结束,调用可进入"组队中"状态并重置所有玩家的准备状态;如果当前房间已经在"组队中"状态,调用不改变状态;如果当前房间游戏进行中,调用失败。

# boolean GameServerManager.setInviteData(string data)

设置邀请好友附带的数据

# Promise GameServerManager.setState(object object)

更新玩家状态信息

# GameServerManager.startGame()

启动帧同步

# Promise GameServerManager.startMatch(object object)

开始游戏匹配

# Promise GameServerManager.startStateService(object object)

开启状态管理服务,只有开启状态管理服务,才能获取在线好友列表以及接收好友邀请

# Promise GameServerManager.updateReadyStatus(object object)

更新玩家准备信息

# Promise GameServerManager.uploadFrame(object object)

上传游戏帧

# GameServerManager.onLogout(function callback)

监听用户登出游戏服务事件,可能是主动登出也可能是其他原因被动登出

# GameServerManager.offLogout(function callback)

取消监听用户登出游戏服务事件

# GameServerManager.onBeKickedOut(function callback)

监听自己被踢出当前房间

# GameServerManager.offBeKickedOut(function callback)

取消监听自己被踢出当前房间

# GameServerManager.onBroadcast(function callback)

监听收到同个房间内的广播消息

# GameServerManager.offBroadcast(function callback)

取消监听收到同个房间内的广播消息

# GameServerManager.onDisconnect(function callback)

监听断开连接,收到此事件后,需要调用 GameServerManager.reconnect 进行重连

# GameServerManager.offDisconnect(function callback)

取消监听断开连接,收到此事件

# GameServerManager.onGameStart(function callback)

监听帧同步游戏开始

# GameServerManager.offGameStart(function callback)

取消监听帧同步游戏开始

# GameServerManager.onGameEnd(function callback)

监听帧同步游戏结束

# GameServerManager.offGameEnd(function callback)

取消监听帧同步游戏结束

# GameServerManager.onInvite(function callback)

监听接收邀请,当用户确认邀请之后会收到此事件

# GameServerManager.offInvite(function callback)

取消监听接收邀请,当用户确认邀请之后会收到此事件

# GameServerManager.onLockStepError(function callback)

监听帧同步出错

# GameServerManager.offLockStepError(function callback)

取消监听帧同步出错

# GameServerManager.onMatch(function callback)

监听游戏匹配成功的事件

# GameServerManager.offMatch(function callback)

取消监听游戏匹配成功的事件

# GameServerManager.onRoomInfoChange(function callback)

监听房间信息更新

# GameServerManager.offRoomInfoChange(function callback)

取消监听房间信息更新

# GameServerManager.onStateUpdate(function callback)

监听好友在线状态变更(该接口需要在开放数据域使用)

# GameServerManager.offStateUpdate(function callback)

取消监听好友在线状态变更(该接口需要在开放数据域使用)

# GameServerManager.onSyncFrame(function callback)

监听收到同个房间的帧同步消息

# GameServerManager.offSyncFrame(function callback)

取消监听收到同个房间的帧同步消息