# lock-step.getGameFrame
本接口应在服务器端调用,详细说明参见服务端API。
分片拉取对局游戏帧
# 请求地址
GET https://api.weixin.qq.com/wxa/getwxagameframe?access_token=XXX&access_info=YYY&begin_frame_id=ZZZ&end_frame_id=TTT
# 请求参数
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
access_token / cloudbase_access_token | string | 是 | 微信后台接口调用凭证 | |
access_info | string | 是 | 填onGameEnd接口返回给开发者的gameAccessInfo | |
begin_frame_id | number | 是 | 待获取帧的起始frame_id | |
end_frame_id | number | 是 | 待获取帧的终止frame_id,左闭右开区间 |
# 返回值
# Object
返回的 JSON 数据包
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误提示信息 |
data | Object | 房间/对局访问凭证数据 |
errcode 的合法值
值 | 说明 | 最低版本 |
---|---|---|
0 | 请求成功 | |
-1 | 系统繁忙,此时请开发者稍候再试 | |
1 | 数据不存在 | |
5 | 非法的请求数据 | |
6000 | 获取数据失败 |
data 的结构
属性 | 类型 | 说明 |
---|---|---|
has_more | bool | 是否还有更多帧可以获取 |
frame_list | Array.<Object> | 游戏帧数据列表 |
frame_list 的结构
属性 | 类型 | 说明 |
---|---|---|
frame_id | number | 帧编号,从1开始 |
pkg_list | Array.<Object> | 指令包列表,每个指令包具体格式见下面 |
pkg_list 的结构
属性 | 类型 | 说明 |
---|---|---|
open_id | string | 该包发送者的OpenId |
action_list | Array.<string> | 第三方自定义游戏指令数组 |
b | bool | true代表是空帧 |
dp_id | number | 微信内部使用,无需理解,为了更快速返回数据,没有去掉该字段内容 |