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 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 微信内部使用,无需理解,为了更快速返回数据,没有去掉该字段内容