# 联机大厅

# 索引

接口		描述
GetPlayerUid	服务端	获取玩家的uid。只有在线玩家才可获取
LobbyGetStorage	服务端	获取存储的数据。仅联机大厅可用
LobbyGetStorageBySort	服务端	排序获取存储的数据。仅联机大厅可用
LobbySetStorageAndUserItem	服务端	设置订单已发货或者存数据。仅联机大厅可用
QueryLobbyUserItem	服务端	查询还没发货的订单。仅联机大厅可用

# GetPlayerUid

服务端

method in mod.server.component.httpToWebServerCompServer.HttpToWebServerCompServer

描述

获取玩家的uid。只有在线玩家才可获取
参数

参数名
数据类型
说明

playerId str 玩家实体id
返回值

数据类型
说明

int 玩家uid
示例

参数名	数据类型	说明
playerId	str	玩家实体id

数据类型	说明
int	玩家uid

import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateHttp(levelId)
uid = comp.GetPlayerUid(playerId)

# LobbyGetStorage

服务端

method in mod.server.component.httpToWebServerCompServer.HttpToWebServerCompServer

描述

获取存储的数据。仅联机大厅可用
参数

参数名
数据类型
说明

callback function 请求回调函数

uid int 玩家uid，如果传0表示获取全局数据

keys list(str) 查询数据的key列表，排序key与非排序key都可获取
返回值

无
备注
- 可以使用uid为0，key为op_config获取开发者平台的运营管理配置中配置的json
- callback需要接受一个参数当请求失败时，参数返回None，当请求成功时，参数为一个dict，格式如下。（获取的key如果没有设置过，就不会出现在返回的最新数据中）
```
{
    "entity": {
        "data": [
            {
                "key": str,     # 数据的key
                "value": int/float/str  # 数据的值
            },
            ...
        ]
    }
}
```
- 该接口有调用频率限流，同一个组件所有联机大厅房间的请求频率最多为每秒200次。如果请求超过该频率会导致阻塞，请求的相应时间变长。
示例

import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateHttp(levelId)
def cb(data):
    if data:
        print { i["key"]: i["value"] for i in data["entity"]["data"] }
    else:
        print "获取数据失败"
keys = ["money"]
comp.LobbyGetStorage(cb, uid, keys)

# LobbyGetStorageBySort

服务端

method in mod.server.component.httpToWebServerCompServer.HttpToWebServerCompServer

描述

排序获取存储的数据。仅联机大厅可用

参数

参数名	数据类型	说明
callback	function	请求回调函数
key	str	查询数据的key。在开发者平台上配置的可排序的key才可以查询
ascend	bool	是否升序
offset	int	从排序后的第几个数据开始返回（从0开始计算）
length	int	返回多少个数据，上限为50

返回值

无
备注
- 全局数据（即uid为0）不参与排序
- 最多只能获取前200的数据（升序前200及降序前200）
- 返回的结果不一定是最新数据，会有两分钟的刷新间隔，建议只用来作客户端显示，获取业务逻辑所需的数据请使用LobbyGetStorage
- callback需要接受一个参数当请求失败时，参数返回None，当请求成功时，参数为一个dict，格式如下。（获取的key如果没有设置过，就不会出现在返回的最新数据中）
```
{
    "entity": {
        "data": [
            {
                "uid": int,     # 玩家uid
                "nickname": str     # 玩家的用户名
                "value": int/float/str,  # 数据的值
            },
            ...
        ]
    }
}
```
示例

import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateHttp(levelId)
def cb(data):
    if data:
        print data["entity"]["data"]
    else:
        print "获取数据失败"
# 获取money从大到小排序第1到第50的数据
comp.LobbyGetStorageBySort(cb, 'money', False, 0, 50)
# 获取money从大到小排序第51到第100的数据
comp.LobbyGetStorageBySort(cb, 'money', False, 50, 50)

# LobbySetStorageAndUserItem

服务端

method in mod.server.component.httpToWebServerCompServer.HttpToWebServerCompServer

描述

设置订单已发货或者存数据。仅联机大厅可用

参数

参数名	数据类型	说明
callback	function	请求回调函数
uid	int	玩家uid，如果传0表示设置全局数据
orderId	int或None	订单Id，可选
entitiesGetter	function或None	用于返回存储的数据的函数，可选

返回值

无

备注

uid为0，key为op_config对应开发者平台的运营管理配置中配置的json，使用这个接口时请避免覆盖掉
callback需要接受一个参数当请求失败时，参数返回None。当请求成功时，参数为一个dict，包含返回码，最新数据等信息。
- 当code为0时，表示设置成功。
- 当code为2时，表示数据冲突，例如多个房间同时设置同一个玩家的数据或者全局数据。
- 当code为5时，表示订单冲突，例如该订单已经标记为发货了。
当请求成功时，无论返回码是多少，都应该使用返回的最新数据更新本地数据。当数据冲突时，callback回调结束后会自动重新调用entitiesGetter获取数据并发起重试。当订单冲突时，callback回调结束后不会重试。（当发生冲突时，设置的key如果之前没有设置过，就不会出现在返回的最新数据中））具体格式如下：
```
{
    “code”: int,  # 返回码
    "message": str  # 返回信息
    "entity": {
        "data": [  # 数据库最新值
            {
                "key": str,     # 数据的key
                "value": object  # 数据的值
            },
            ...
        ]
    }
}
```

entitiesGetter需要返回一个list(dict)，格式为：

[
    {
        "key": str,  # 数据的key，长度最大为64个字符
                     # uid为0，key为op_config对应开发者平台的运营管理配置中配置的json，请注意避免覆盖掉
        "value": object  # 数据的值
                         # 1. 如果是排序的key，value只能是int或者long，范围为-2^63到2^63-1
                         # 2. 如果是非排序的key，value需要是可以被json序列化的对象，如int/float/str/list/dict等
                         #   该object序列化为json字符串后，最大不能超过1024*1024个字符
                         #   中文字符串需要是utf8编码，不要用unicode
                         #   请留意json跟dict的区分，例如json的key一定要是字符串，json没有tuple等
    },
    ...
]

该接口有调用频率限流，同一个组件所有联机大厅房间的请求频率最多为每秒50次。如果请求超过该频率会导致阻塞，请求的相应时间变长。
同一个uid的LobbyGetStorage与LobbySetStorageAndUserItem调用会保证顺序执行

示例

import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateHttp(levelId)
playerId = "12345"
orderId = 12345
money = { playerId: 100 }
def cb(data):
    if data:
        # 更新本地数据
        newData = { i["key"]: i["value"] for i in data["entity"]["data"] }
        money[playerId] = newData["money"]
    else:
        print "发货/设置数据失败"
def getter():
    return [
        {
            "key": "money",
            "value": money[playerId] + 100
        }
    ]
comp.LobbySetStorageAndUserItem(cb, uid, orderId, getter)

# QueryLobbyUserItem

服务端

method in mod.server.component.httpToWebServerCompServer.HttpToWebServerCompServer

描述

查询还没发货的订单。仅联机大厅可用
参数

参数名
数据类型
说明

callback function 请求回调函数

uid int 玩家uid
返回值

无

备注

callback需要接受一个参数当请求失败时，参数返回None，当请求成功时，参数为一个dict，格式为：

{
    "entity": {
        "orders": [
            {
                "order_id": int,    # 订单id
                "timestamp": int,   # 购买时间
                "cmd": str          # 实现指令
                "product_count": int  # 购买数量。目前不允许一次购买多个，所以返回都是1
            },
            ...
        ]
    }
}

示例

import mod.server.extraServerApi as serverApi
comp = serverApi.GetEngineCompFactory().CreateHttp(levelId)
def cb(data):
    if data:
        print data["entity"]["orders"]
    else:
        print "查询订单失败"
comp.QueryLobbyUserItem(cb, uid)

← 自定义成就 →