# 2-控制服事件

事件的定义。

# 服务器

# ResetGamesBeginEvent

  • 描述

    开始重置lobby/game事件。具体可以参见API【ResetServer】

  • 参数

    参数名 数据类型 说明
    serverId int 服务器id
  • 返回值

# ResetGamesEndEvent

  • 描述

    重置lobby/game结束事件。本事件只是表示重置完成了,但是服务器可能还未完成初始化。具体可以参见API【ResetServer】

  • 参数

    参数名 数据类型 说明
    serverId int 服务器id
    bSuccess bool 重置是否成功。true表示重置成功,否则表示失败
  • 返回值

# RollingCloseServersEndEvent

  • 描述

    使用RollingCloseServersEndEvent滚动关服结束事件。

  • 参数

    参数名 数据类型 说明
    request str 滚动关服的请求参数,为json格式字符串,包含以下属性:serverlist,serverIds,apolloid,apollo_key
    response str 滚动关服的返回参数,为json格式字符串,包含以下属性:code错误码,message错误信息,entity移除的服务器信息,其中字段与RollingUpdateServersEndEvent相同
    suc bool 滚动关服是否成功
  • 返回值

# RollingUpdateServersEndEvent

  • 描述

    使用RollingUpdateServers滚动更新服务器结束事件。

  • 参数

    参数名 数据类型 说明
    request str 滚动更新的请求参数,为json格式字符串,包含以下属性:app_version,ip,server_type,add_num,apolloid,apollo_key
    response str 滚动更新的返回参数,为json格式字符串,包含以下属性:code错误码,message错误信息,entity新增或移除的服务器信息
    suc bool 滚动更新是否成功
  • 返回值

  • 备注

    entity为一个list(dict),每个元素包含以下字段,对应mcstudio的服务器配置:

    字段 类型 说明
    serverid int 服务器id
    ip str 服务器ip
    mods str 服务器mod列表
    app_type str game/lobby/proxy
    type str 服务器类型
    save bool 是否保存地图
    save_id int 使用地图
    gb int 单进程内存

# ServerConnectedEvent

  • 描述

    lobby/game/proxy成功建立连接时触发

  • 参数

    参数名 数据类型 说明
    serverId int 服务器id
    protocolVersion int 协议版本号
  • 返回值

# ServerDisconnectEvent

  • 描述

    lobby/game/proxy断开连接时触发

  • 参数

    参数名 数据类型 说明
    serverId int 服务器id
  • 返回值

# 配置

# NetGameCommonConfChangeEvent

  • 描述

    公共配置发生变化时触发,具体包括:新增或删服服务器;服务器相关配置变化;日志等级发生变化

  • 返回值

# 玩家

# PlayerLoginServerEvent

  • 描述

    玩家开始登陆事件,此时master开始给玩家分配lobby/game,可以区分玩家是登录还是切服

  • 参数

    参数名 数据类型 说明
    serverId int 客户端即将登录的服务器id
    uid int/long 玩家的uid
    protocolVersion int 协议版本号
    isTransfer bool True: 切服,False:登录
    isReconnect bool True: 断线重连,False:正常登录
    isPeUser bool True: 玩家从手机端登录,False:玩家从PC端登录
  • 返回值

# PlayerLogoutServerEvent

  • 描述

    玩家登出时触发,玩家在lobby/game下载行为包的过程中退出也会触发该事件,可以以区分玩家是登出还是切服

  • 参数

    参数名 数据类型 说明
    serverId int 客户端连接的proxy服务器id
    uid int/long 玩家的uid
    isTransfer bool True: 切服,False:登出
  • 返回值

# PlayerTransferServerEvent

  • 描述

    玩家开始切服事件,此时master开始为玩家准备服务器,玩家还没切服完毕,后续可能切服失败

  • 参数

    参数名 数据类型 说明
    serverId int 客户端连接的proxy服务器id
    uid int/long 玩家的uid
    targetServerId int 目标lobby/game服务器id
    targetServerType str 目标服务器类型,比如"game"或"lobby"。若targetServerId为0,则会从目标类型的多个服务器中随机选一个,作为目标服务器
    protocolVersion int 协议版本号
    transferParam str 切服参数。调用【TransferToOtherServer】或【TransferToOtherServerById】传入的切服参数。
  • 返回值