GameServerManager

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

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

方法

Promise GameServerManager.broadcastInRoom(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.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.onRoomInfoChange(function callback)

监听房间信息更新

GameServerManager.offRoomInfoChange(function callback)

取消监听房间信息更新

GameServerManager.onStateUpdate(function callback)

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

GameServerManager.offStateUpdate(function callback)

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

GameServerManager.onSyncFrame(function callback)

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

GameServerManager.offSyncFrame(function callback)

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