design §9 原文把可查牌模式的四项功能列成无序列表,不可查牌只写 「不提供以上任何查看 / 明牌功能」,随后展开的例子却只提了主牌数量、 对子结构、明牌按钮、亮牌统计,没提第一条「已经打出的牌可以查看」, 导致"以上"的范围有歧义。代码据此照发出牌历史,前一轮核对把它记为 待确认项(01 表 D6)。 规则设计者已确认:**不可查牌模式必须屏蔽出牌历史,只有可查牌模式 才能查看**。据此: - design §9 改写为无歧义表述:先给出「查牌 = 回看不该随时可见的信 息」的定义,把可查牌的四项功能编号列出(① 出牌历史 ② 报无主后的 他家主牌数/对子数 ③ 明牌 ④ 庄家亮牌),不可查牌逐条对应说明一项 都不提供;并补一段边界说明——**当前这一轮桌面上的牌两种模式下都 必须可见**,否则后出的人无从跟牌、无从判断本轮谁最大,断线重连同 理(当前轮照常恢复,往轮历史按模式开关给不给)。 - class.export.js:get_deskinfo 的 PushCards.pushlist 构建与排序整 体移入 `if (!cfg.nocheck)`,不查牌时不带该属性;当前轮桌面牌由 PushCards.playproc.cards 恢复,两种模式都有。 - 协议文档:pushlist 补「仅可查牌模式下有此属性」,playproc 补「两 种模式恒有」及其原因。 - 合规文档:01 表 D6 由「待确认/未修」改为已确认并修复,从「尚未处 置」移出;02 测试计划断言总数 357→361 并新增该维度覆盖行。 test_rpc 新增 4 项:不查牌房无 pushlist、可查牌房有 pushlist,且两 种模式下当前轮桌面牌 playproc.cards 都能恢复。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
30 KiB
二七王协议包列表
说明:data 均为发送方与接收方之间约定的 JSON 内容;成败判定只看推送包里的 data.success。
0. 通用约定(所有包适用,下文各表不再逐一重复)
0.1 成败标志 data.success
每一个「服务器 → 客户端」的包,data 都必带 success(布尔):
success: true—— 操作成功 / 正常推送。下文各包的字段表描述的都是这种情况,表里不再重复列success这一行。success: false—— 操作失败,见 0.2。
前端一律 if (!data.success) 判成败,不看 status / code,也不写 status 兼容兜底。
0.2 失败回包
服务端受理请求时,任一校验不通过都会回一个失败包(此前是静默丢弃、前端只能干等倒计时):
- rpc 与请求包同名(如
chupai失败回chupai,而不是chupai1/2/3); - 只回发给请求者(
conmode/fromid取自请求包),其他两家收不到; data只含success: false与errcode,无业务字段。
| 参数名 | 类型 | 说明 |
|---|---|---|
| success | 布尔 | 恒为 false |
| errcode | 整数 | 失败原因,见下表 |
errcode 取值(服务端 youle_erqiwang.ERR,mod.js):
| 值 | 名称 | 含义 |
|---|---|---|
| 1 | PLAYER | 玩家/房间/座位校验不通过(平台 check_player 返回 null) |
| 2 | NODESK | 牌桌或牌局不存在 |
| 3 | STEP | 当前阶段不允许该操作(如非出牌阶段发 chupai) |
| 4 | SEAT | 位置不符,或还没轮到该玩家操作 |
| 5 | PARAM | 参数非法:类型/范围/张数不对、牌不在手上、牌id 重复 |
| 6 | RULE | 规则不允许:叫分未更低、出牌不合法、投降条件不满足、房间模式禁止等 |
牌id 列表的入参约束(
cards字段,maipai/chupai):必须是非空数组,元素必须是0 ~ 107的整数牌id,且互不重复。字符串形式的数字(如"5")、小数、越界值、重复值一律按PARAM拒绝,服务端不做类型兜底转换。
例外:
tishi成功时不回执。该包是闲家给对家的主观提示、不含任何对局状态,服务端只转发给对家(design §11),发送者收不到成功包;只有失败才回给发送者。
0.3 断线重连包不在此约定内
deskinfo 由平台组装在 pack.data.deskinfo 下(见文末「断线重连」),data.success 由平台填写,子游戏不注入。
1. 发牌(fapai)
发包者:服务器 收包者:游戏 app:youle route:erqiwang rpc:fapai
| 参数名 | 类型 | 说明 |
|---|---|---|
| asetidx | 整数 | 当前局数 |
| asetcount | 整数 | 总局数 |
| cards | 数组 | 自己得到的牌id列表 |
| seat | 整数 | 当前等待叫分者的位置 |
| countdown | 整数 | 叫分倒计时 |
2. 叫分或不叫(jiaofen,客户端→服务器)
发包者:游戏 收包者:服务器 app:youle route:erqiwang rpc:jiaofen
| 参数名 | 类型 | 说明 |
|---|---|---|
| agentid | 字符 | 代理id |
| playerid | 整数 | 玩家id |
| gameid | 字符 | 游戏id |
| roomcode | 整数 | 房间号 |
| seat | 整数 | 叫分者的位置序号 |
| call | 整数 | 分数,0表示不叫 |
3. 叫分或不叫(jiaofen,服务器→客户端)
发包者:服务器 收包者:游戏 app:youle route:erqiwang rpc:jiaofen
| 参数名 | 类型 | 说明 |
|---|---|---|
| seat | 整数 | 叫分者的位置序号 |
| call | 整数 | 分数,0表示不叫 |
| currcall | 整数 | 当前叫到的分数 |
| multiple | 整数 | 叫分对应的基础子数 get_base_bycall(call, climb),随房间「爬坡」开关取值(roomtype 位3):常规算子 65→2 60→3 55→4 50及以下→6;爬坡 65→2 60→3 55→4 50→6 45→7 40→8 35→9 30→10 25→11 20→12 15→13 10→14 5→15;两种模式下 70→2;无叫分→0。与结算包 aset.multiple 同源同值(design §7.1/§7.3.1) |
| nextseat | 整数 | 下一个叫分者的位置序号 |
| countdown | 整数 | 叫分倒计时 |
4. 上庄(shangzhuang)
发包者:服务器 收包者:游戏 app:youle route:erqiwang rpc:shangzhuang
| 参数名 | 类型 | 说明 |
|---|---|---|
| seat | 整数 | 叫分者的位置序号 |
| call | 整数 | 分数,0表示不叫 |
| banker | 整数 | 庄家的位置序号 |
| grade | 整数 | 庄家的叫分 |
| multiple | 整数 | 叫分对应的基础子数 get_base_bycall(call, climb),随房间「爬坡」开关取值(roomtype 位3):常规算子 65→2 60→3 55→4 50及以下→6;爬坡 65→2 60→3 55→4 50→6 45→7 40→8 35→9 30→10 25→11 20→12 15→13 10→14 5→15;两种模式下 70→2;无叫分→0。与结算包 aset.multiple 同源同值(design §7.1/§7.3.1) |
| bottomcards | 数组 | 8 张暗牌。庄家恒有;闲家仅当 70 分坐庄时才有(供 3 秒亮牌用),非 70 分时闲家没有该属性(暗牌只有庄家可见,design §4) |
| ancard3s | 整数 | 仅 70 分坐庄时出现且为 1:表示庄家把暗牌摸入手前,需将 bottomcards 这 8 张暗牌向所有玩家亮出 3 秒(design §4/§7.1);非 70 分无此属性 |
| cards | 数组 | 拿了暗牌后手上的牌(36 张,含暗牌),庄家才有此属性,闲家没有该属性 |
| countdown | 整数 | 选主倒计时 |
| touxiang | 整数 | 是否允许投降 0:不允许 1:允许(仅 70 分坐庄为 1)。投降与选主互斥、同为选主阶段(step2)的决策,见 touxiang 包与 design §4 |
5. 投降(touxiang,客户端→服务器)
发包者:游戏 收包者:服务器 app:youle route:erqiwang rpc:touxiang
| 参数名 | 类型 | 说明 |
|---|---|---|
| agentid | 字符 | 代理id |
| playerid | 整数 | 玩家id |
| gameid | 字符 | 游戏id |
| roomcode | 整数 | 房间号 |
| seat | 整数 | 庄家的位置序号。投降是选主阶段(step 2)与选主互斥的选择:mod.touxiang 仅在 step==2、banker==seat、call==70 时受理;点投降即直接结算,不选主、不埋牌、不出牌(design §4) |
6. 选主(xuanzhu,客户端→服务器)
发包者:游戏 收包者:服务器 app:youle route:erqiwang rpc:xuanzhu
| 参数名 | 类型 | 说明 |
|---|---|---|
| agentid | 字符 | 代理id |
| playerid | 整数 | 玩家id |
| gameid | 字符 | 游戏id |
| roomcode | 整数 | 房间号 |
| seat | 整数 | 选主者的位置序号 |
| flower | 整数 | 花色 1方块 2梅花 3红心 4黑桃 |
7. 选主(xuanzhu,服务器→客户端)
发包者:服务器 收包者:游戏 app:youle route:erqiwang rpc:xuanzhu
| 参数名 | 类型 | 说明 |
|---|---|---|
| banker | 整数 | 庄家的位置序号 |
| flower | 整数 | 花色 1方块 2梅花 3红心 4黑桃 |
| countdown | 整数 | 埋牌倒计时 |
| cards | 数组 | 选主后自己手上的牌id列表 |
8. 埋牌(maipai,客户端→服务器)
发包者:游戏 收包者:服务器 app:youle route:erqiwang rpc:maipai
| 参数名 | 类型 | 说明 |
|---|---|---|
| agentid | 字符 | 代理id |
| playerid | 整数 | 玩家id |
| gameid | 字符 | 游戏id |
| roomcode | 整数 | 房间号 |
| seat | 整数 | 埋牌者的位置序号 |
| cards | 数组 | 埋牌的id列表 |
9. 埋牌(maipai,服务器→客户端)
发包者:服务器 收包者:游戏 app:youle route:erqiwang rpc:maipai
| 参数名 | 类型 | 说明 |
|---|---|---|
| cards | 数组 | 埋牌后手上的牌,去掉了埋牌,庄家才有此属性,闲家没有该属性 |
| bottomcards | 数组 | 埋的牌,庄家才有此属性,闲家没有该属性 |
| seat | 整数 | 出牌者的位置序号(即将首出的庄家) |
| countdown | 整数 | 出牌倒计时 |
| liangpai | json | 庄家亮牌信息(design §8.2),只有闲家、且可查牌模式、且庄家埋牌后手牌达标时才有。结构(各字段按是否达标出现):zhu 主牌总数、zhupair 主对子数、zhutuo 主拖拉机组数(固定主牌王+2+7 总数 ≥10 时有这三项);wang 王数(王≥3 时);qi 7 数(7≥6 时);er 2 数(2≥6 时)。都不达标则无此属性 |
10. 出牌(chupai,客户端→服务器)
发包者:游戏 收包者:服务器 app:youle route:erqiwang rpc:chupai
| 参数名 | 类型 | 说明 |
|---|---|---|
| agentid | 字符 | 代理id |
| playerid | 整数 | 玩家id |
| gameid | 字符 | 游戏id |
| roomcode | 整数 | 房间号 |
| seat | 整数 | 出牌者的位置序号 |
| cards | 数组 | 出牌的id列表 |
11. 第一个玩家出牌(chupai1)
发包者:服务器 收包者:游戏 app:youle route:erqiwang rpc:chupai1
| 参数名 | 类型 | 说明 |
|---|---|---|
| seat | 整数 | 出牌者的位置序号 |
| cards | 数组 | 实际打出的牌id列表;甩错时(见 shuaicuo)为被强制打出的那一张最小主牌单张 |
| shuaicuo | 整数 | 甩错标志,仅甩错时出现且为 1(design §5.4.5:甩牌未通过最大性判定,整套甩牌收回,本轮只强制打出最小一张、失去本轮甩牌资格);正常出牌无此属性 |
| info | 数组 | 出牌者的座位牌况 o_paiju.seatlist[seat],仅可查牌模式下发(不查牌无此属性,design §9)。5 元素数组:前 4 个对应花色1~4 的 [无该花色标志, 该花色无对标志](0/1),第 5 个为报副情况 [剩余主牌数, 剩余主对数](初始 [-1,-1])。一旦全场有人报无主,服务端会按各家实际手牌同时刷新三个座位的这一格(design §9「为全体三人显示另外两家」);但本包只带出牌者这一个座位的,另两家的最新值可从后续出牌包或重连包 PushCards.seatlist 取 |
| count | 整数 | 出牌数量(甩错时为 1) |
| flower | 整数 | 出牌花色 |
| cardtype | 整数 | 出牌牌型:>100 单张(101 一张、102 两张…)、>200 对子(201 一对、202 两对…)、>300 拖拉机(302 两连对、303 三连对…),见 class.pai.js 顶部注释。注意:cardtype 只能表达单一牌型,而甩牌是单张/对子/拖拉机自由混搭(design §5.4.3),会被牌型推导压平成 1xx 或 2xx(例如「主K对 + 主5」得 103、「两连对 + 一散对」得 203)。甩牌的真实结构请读 shuai,不要据 cardtype 反推 |
| shuai | json | 甩牌分量构成,仅本次出牌是合法甩牌时才有(非甩牌、以及甩错退化为单张时都没有该属性)。结构 { tractors: [连对数...], pairs: 独立对子数, singles: 单张数 },例如「主K对 + 主5」为 {tractors:[],pairs:1,singles:1}。与服务端跟牌时逐分量强制匹配用的 shuai_demand 同源(design §5.4.3/§5.4.4) |
| nextseat | 整数 | 下一个出牌者的位置序号 |
| countdown | 整数 | 下一个出牌者的出牌倒计时 |
| baozhu | 整数 | 是否已有玩家报无主(主牌出空)0否 1是;对应服务端 have_baofu()(任一玩家 seatlist[seat][4][0]==0)。仅可查牌模式下才可能为 1,供客户端展示他家主牌数量/对子结构并出现"明牌"按钮;不查牌模式恒为 0(design §9) |
| cardsinhand | 数组 | 出牌者出牌后手上剩下的牌id列表,只有出牌者才有此属性 |
12. 第二个玩家出牌(chupai2)
发包者:服务器 收包者:游戏 app:youle route:erqiwang rpc:chupai2
| 参数名 | 类型 | 说明 |
|---|---|---|
| seat | 整数 | 出牌者的位置序号 |
| cards | 数组 | 出的牌id列表 |
| info | 数组 | 出牌者的座位牌况 o_paiju.seatlist[seat],仅可查牌模式下发(不查牌无此属性,design §9)。5 元素数组:前 4 个对应花色1~4 的 [无该花色标志, 该花色无对标志](0/1),第 5 个为报副情况 [剩余主牌数, 剩余主对数](初始 [-1,-1])。一旦全场有人报无主,服务端会按各家实际手牌同时刷新三个座位的这一格(design §9「为全体三人显示另外两家」);但本包只带出牌者这一个座位的,另两家的最新值可从后续出牌包或重连包 PushCards.seatlist 取 |
| nextseat | 整数 | 下一个出牌者的位置序号 |
| countdown | 整数 | 出牌倒计时 |
| baozhu | 整数 | 是否已有玩家报无主(主牌出空)0否 1是;对应服务端 have_baofu()(任一玩家 seatlist[seat][4][0]==0)。仅可查牌模式下才可能为 1,供客户端展示他家主牌数量/对子结构并出现"明牌"按钮;不查牌模式恒为 0(design §9) |
| cardsinhand | 数组 | 出牌后出牌者手上剩下的牌id列表,只有出牌者才有此属性 |
13. 第三个玩家出牌(chupai3)
发包者:服务器 收包者:游戏 app:youle route:erqiwang rpc:chupai3
| 参数名 | 类型 | 说明 |
|---|---|---|
| seat | 整数 | 出牌者的位置序号 |
| cards | 数组 | 出的牌id列表 |
| info | 数组 | 出牌者的座位牌况 o_paiju.seatlist[seat],仅可查牌模式下发(不查牌无此属性,design §9)。5 元素数组:前 4 个对应花色1~4 的 [无该花色标志, 该花色无对标志](0/1),第 5 个为报副情况 [剩余主牌数, 剩余主对数](初始 [-1,-1])。一旦全场有人报无主,服务端会按各家实际手牌同时刷新三个座位的这一格(design §9「为全体三人显示另外两家」);但本包只带出牌者这一个座位的,另两家的最新值可从后续出牌包或重连包 PushCards.seatlist 取 |
| nextseat | 整数 | 下一个出牌者的位置序号 |
| countdown | 整数 | 出牌倒计时 |
| baozhu | 整数 | 是否已有玩家报无主(主牌出空)0否 1是;对应服务端 have_baofu()(任一玩家 seatlist[seat][4][0]==0)。仅可查牌模式下才可能为 1,供客户端展示他家主牌数量/对子结构并出现"明牌"按钮;不查牌模式恒为 0(design §9) |
| cardsinhand | 数组 | 出牌后出牌者手上剩下的牌id列表,只有出牌者才有此属性 |
| maxseat | 整数 | 本轮出牌谁最大,只有本轮最后一个玩家出牌后才有此属性 |
| grade | 整数 | 本轮闲家得分,只有本轮最后一个玩家出牌后且闲家有得分才有此属性 |
13.5 明牌(mingpai,客户端→服务器)
发包者:游戏 收包者:服务器 app:youle route:erqiwang rpc:mingpai
查看另外两家手中全部主牌的具体牌面(design §9)。服务端仅在可查牌模式、出牌阶段(step5)、且已有玩家报无主(have_baofu())时受理;不满足时按 0.2 回 mingpai 失败包(不查牌 / 未报无主 → RULE,非出牌阶段 → STEP)。
| 参数名 | 类型 | 说明 |
|---|---|---|
| agentid | 字符 | 代理id |
| playerid | 整数 | 玩家id |
| gameid | 字符 | 游戏id |
| roomcode | 整数 | 房间号 |
| seat | 整数 | 请求者的位置序号 |
13.6 明牌(mingpai,服务器→客户端)
发包者:服务器 收包者:游戏 app:youle route:erqiwang rpc:mingpai (只回发给请求者)
| 参数名 | 类型 | 说明 |
|---|---|---|
| seat | 整数 | 请求者的位置序号 |
| others | 数组 | 另外两家各自未出的全部主牌,元素 { seat: 位置序号, zhucards: [主牌id列表] } |
"再点一次取消查看"是客户端的显示开关,无需再请求服务端。
13.7 出牌提示(tishi,客户端→服务器)
发包者:游戏 收包者:服务器 app:youle route:erqiwang rpc:tishi
闲家在出牌阶段向对家(另一闲家)发"踩/没分/有分"提示(design §11)。服务端仅在出牌阶段(step5)、且发起者为闲家(seat != banker)、tip 合法(1/2/3) 时受理;不校验提示真实性(玩家可主观发送);庄家无对家,不受理。不满足时按 0.2 回 tishi 失败包给发送者(庄家发 → RULE,非出牌阶段 → STEP,tip 非法或缺失 → PARAM)。成功时不给发送者回执,只转发给对家。
| 参数名 | 类型 | 说明 |
|---|---|---|
| agentid | 字符 | 代理id |
| playerid | 整数 | 玩家id |
| gameid | 字符 | 游戏id |
| roomcode | 整数 | 房间号 |
| seat | 整数 | 发出提示的闲家位置序号 |
| tip | 整数 | 提示类型:1=踩(我能大过庄家)、2=没分(我手上没分了)、3=有分(我手上有分) |
13.8 出牌提示(tishi,服务器→客户端)
发包者:服务器 收包者:游戏 app:youle route:erqiwang rpc:tishi (只转发给对家,即另一闲家 3 - banker - seat)
| 参数名 | 类型 | 说明 |
|---|---|---|
| seat | 整数 | 发出提示的闲家位置序号 |
| tip | 整数 | 提示类型:1=踩、2=没分、3=有分 |
14. 结算(jiesuan)
发包者:服务器 收包者:游戏 app:youle route:erqiwang rpc:jiesuan
结算包由以下几个子结构拼装而成。三种结算来源的组成不同:
- 正常出牌结算(
mod.chupai中最后一张牌出完,get_paiju_account(0, ...)):含chupai+bottom+aset(末局再加account)。 - 投降结算(
mod.touxiang,get_paiju_account(1, ...)):只含aset(末局再加account),无chupai、无bottom。 - 解散结算(
export.get_disbandRoom,get_paiju_account(2, ...)):只含aset+account,无chupai、无bottom。
chupai(出牌包,仅正常出牌结算存在)
| 参数名 | 类型 | 说明 |
|---|---|---|
| seat | 整数 | 出牌者的位置序号,投降和解散无此属性 |
| cards | 数组 | 出的牌id列表,投降和解散无此属性 |
| maxseat | 整数 | 本轮出牌谁最大,投降和解散无此属性 |
| grade | 整数 | 本轮闲家得分,投降和解散无此属性 |
| gradecards | 数组 | 本轮闲家得分分牌列表,投降和解散无此属性。注意:当前源码中赋值语句被注释(class.paiju.js/mod.js 中相关行均被注释掉),该字段实际永远不会出现在下发的包里,属于失效字段 |
bottom(抠底包,仅正常出牌结算存在;cards 恒有,其余仅闲家抠底时有)
| 参数名 | 类型 | 说明 |
|---|---|---|
| cards | 数组 | 底牌,投降和解散无此属性 |
| multiple | 整数 | 闲家抠底倍数,闲家没抠底无此属性,投降和解散无此属性 |
| grade1 | 整数 | 底牌分数,闲家没抠底无此属性,投降和解散无此属性 |
| grade2 | 整数 | 闲家抠底得分,闲家没抠底无此属性,投降和解散无此属性 |
aset(单局结算包)
| 参数名 | 类型 | 说明 |
|---|---|---|
| banker | 整数 | 庄家的位置序号,-1:无庄 |
| call | 整数 | 庄家叫分,-1:无叫分 |
| multiple | 整数 | 基础子数 get_base_bycall(call, climb)(design §7.1/§7.3.1):常规算子 65→2、60→3、55→4、50 及以下→6、70打牌→2;投降固定 1、解散 0;无叫分 0 |
| flower | 整数 | 主牌花色,-1:无主牌花色 |
| grade | 整数 | 闲家捡分(含抠底) |
| upgrade | 整数 | 判定倍率(带符号,design §7.2.0):3大光 / 2小光 / 1过庄 / -N升N级(倒庄)/ -99投降 / 0解散或无判定 |
| bangwang | 整数 | 本局是否启用傍王规则 0否 1是(roomtype 位2) |
| climb | 整数 | 本局是否启用爬坡规则 0否 1是(roomtype 位3) |
| seatlist | 数组 | 玩家列表,元素结构见下 |
seatlist 数组元素结构:
{
"cards": [], // 算奖相关牌(王/冲关牌)列表
"chongguan": 0, // 常规算奖奖数(只有庄家才计入自己的 N)
"wang": 0, // 手牌中的王数(傍王按此计奖)
"naward": 0, // 该家总奖数 N =(庄家?常规算奖:0)+(傍王?王数:0)
"grade_aw": 0, // 算奖得分 = X×(2Ni−Nj−Nk),X 为每对子子数
"grade_jf": 0, // 捡分子数得分
"grade": 0, // 本局总分 = grade_aw + grade_jf
"score": 0 // 累计得分
}
结算数值模型(design §7~§8):每「庄–闲」对子的基础金额
X = multiple × |upgrade|(投降 X=1、解散 X=0)。捡分子数:庄赢时两闲家各付庄家 X、庄家收 2X;闲赢(升级)时庄家各付两闲家 X。算奖:持有 N 奖的玩家从另外两人各多收X×N,三家两两独立叠加(含闲–闲),即grade_aw = X×(2Ni−Nj−Nk)。
account(大局结算包)
仅当打到最后一局(
o_paiju.idx >= o_room.asetcount)或房间中途解散(解散结算)时,jiesuan包才会带上此分组;普通的中间局结算包没有account字段(class.paiju.jsget_paiju_account)。
| 参数名 | 类型 | 说明 |
|---|---|---|
| account | 数组 | 玩家列表,第一位为累积得分,第二位为每局得分,结构见下 |
[
[0, []],
[0, []],
[0, []]
]
15. 准备(zhunbei,客户端→服务器)
发包者:游戏 收包者:服务器 app:youle route:erqiwang rpc:zhunbei
| 参数名 | 类型 | 说明 |
|---|---|---|
| agentid | 字符 | 代理id |
| playerid | 整数 | 玩家id |
| gameid | 字符 | 游戏id |
| roomcode | 整数 | 房间号 |
| seat | 整数 | 位置序号 |
16. 准备(zhunbei,服务器→客户端)
发包者:服务器 收包者:游戏 app:youle route:erqiwang rpc:zhunbei
| 参数名 | 类型 | 说明 |
|---|---|---|
| seat | 整数 | 位置序号 |
断线重连(deskinfo)
由平台在玩家进入房间/断线重连时回调
youle_erqiwang.export.get_deskinfo(o_room, seat)生成并下发(服务器→客户端);下发的 app/route/rpc 由平台的进房/重连流程决定,不在本子游戏代码内固定。平台把它挂在pack.data.deskinfo下,data.success由平台填写、子游戏不注入(见 0.3)。下列字段即该函数返回的deskinfo对象结构,按当前paiju.step只带对应阶段的分组。
| 参数名 | 类型 | 说明 |
|---|---|---|
| count | 整数 | 总局数 |
| idx | 整数 | 当前局数 |
| PlayerInfo | 数组 | 三个玩家目前的总积分 [0,0,0] |
| step | 整数 | 牌桌状态:1发完牌叫分 2选主/投降 3埋牌 5出牌 6结算(无独立投降阶段——投降在 step2 与选主互斥;埋牌后直接进入 step5 出牌) |
| MyCards | 数组 | 自己手上的牌 |
CallRun(不在叫分阶段无此属性)
| 参数名 | 类型 | 说明 |
|---|---|---|
| seat | 整数 | 当前叫分位置 |
| countdown | 整数 | 叫分倒计时 |
| nowcall | 整数 | 当前叫分 |
| multiple | 整数 | 叫分对应的基础子数 get_base_bycall(call, climb),随房间「爬坡」开关取值(roomtype 位3):常规算子 65→2 60→3 55→4 50及以下→6;爬坡 65→2 60→3 55→4 50→6 45→7 40→8 35→9 30→10 25→11 20→12 15→13 10→14 5→15;两种模式下 70→2;无叫分→0。与结算包 aset.multiple 同源同值(design §7.1/§7.3.1) |
| call | 数组 | 三家叫分 [null,0,65],null还未叫分,0不叫,>0叫了多少分 |
ChooseMain(step 2 选主/投降阶段,不在此阶段无此属性)
| 参数名 | 类型 | 说明 |
|---|---|---|
| banker | 整数 | 庄家 |
| call | 整数 | 叫分 |
| multiple | 整数 | 叫分对应的基础子数 get_base_bycall(call, climb),随房间「爬坡」开关取值(roomtype 位3):常规算子 65→2 60→3 55→4 50及以下→6;爬坡 65→2 60→3 55→4 50→6 45→7 40→8 35→9 30→10 25→11 20→12 15→13 10→14 5→15;两种模式下 70→2;无叫分→0。与结算包 aset.multiple 同源同值(design §7.1/§7.3.1) |
| countdown | 整数 | 选主倒计时 |
| bottomcards | 数组 | 8 张暗牌,只有庄家有此属性(暗牌仅庄家可见;70 分的 3 秒亮牌是上庄时的一次性事件,重连不重放) |
| touxiang | 整数 | 是否允许投降 0:不允许 1:允许(仅 70 分坐庄为 1)。投降与选主互斥、同一决策点,见 touxiang 包与 design §4 |
选主阶段前端需在每个花色按钮上显示"该花色在庄家手中的对子数"(design §4/§11)——庄家的完整手牌由
MyCards提供(庄家为 36 张),对子数由前端据此计算,服务端不额外下发。
BuryCards(step 3 埋牌阶段,不在此阶段无此属性)
| 参数名 | 类型 | 说明 |
|---|---|---|
| banker | 整数 | 庄家 |
| call | 整数 | 叫分 |
| multiple | 整数 | 叫分对应的基础子数 get_base_bycall(call, climb),随房间「爬坡」开关取值(roomtype 位3):常规算子 65→2 60→3 55→4 50及以下→6;爬坡 65→2 60→3 55→4 50→6 45→7 40→8 35→9 30→10 25→11 20→12 15→13 10→14 5→15;两种模式下 70→2;无叫分→0。与结算包 aset.multiple 同源同值(design §7.1/§7.3.1) |
| flower | 整数 | 主牌花色 |
| countdown | 整数 | 埋牌倒计时 |
| bottomcards | 数组 | 8 张暗牌,只有庄家有此属性(暗牌仅庄家可见;70 分的 3 秒亮牌是上庄时的一次性事件,重连不重放) |
埋牌阶段无投降(投降是 step2 与选主互斥的选择,选主后即不可再投降)。
PushCards(step 5 出牌阶段,不在此阶段无此属性)
| 参数名 | 类型 | 说明 |
|---|---|---|
| banker | 整数 | 庄家 |
| call | 整数 | 叫分 |
| multiple | 整数 | 叫分对应的基础子数 get_base_bycall(call, climb),随房间「爬坡」开关取值(roomtype 位3):常规算子 65→2 60→3 55→4 50及以下→6;爬坡 65→2 60→3 55→4 50→6 45→7 40→8 35→9 30→10 25→11 20→12 15→13 10→14 5→15;两种模式下 70→2;无叫分→0。与结算包 aset.multiple 同源同值(design §7.1/§7.3.1) |
| flower | 整数 | 主牌花色 |
| countdown | 整数 | 出牌倒计时 |
| bottomcards | 数组 | 埋的牌,只有庄家有此属性 |
| grade | 整数 | 当前的捡分分数 |
| gradecards | 数组 | 当前的捡分分牌,只有闲家有此属性 |
| playproc | json | 当前出牌情况 o_paiju.playproc:round 第几轮、start 本轮首出位置、currseat 当前出牌位置、startcount 首出张数、startflower 首出花色、starttype 首出牌型、maxseat 本轮最大者位置、maxcard 最大牌编码、cards 本轮三家各自出的牌(数组下标=位置序号)、shuai_demand 首家甩牌的分量需求 {tractors:[连对数...],pairs,singles}(非甩牌为 null,供跟牌逐分量强制匹配,design §5.4.4)。两种查牌模式下恒有此属性——cards 是当前这一轮桌面上的牌,不属于「查牌」,屏蔽了后出的人就无从跟牌(design §9 末尾) |
| seatlist | 数组 | 三家座位牌况,元素结构同上文 chupai 包的 info(每个玩家一个 5 元素数组:4 个花色的 [无该花色,无对] + 报副 [剩余主牌数,剩余主对数])。仅可查牌模式下有此属性(design §9) |
| liangpai | json | 庄家亮牌信息,结构同 maipai 包的 liangpai;仅可查牌模式、且请求者为闲家、且庄家达标时有(供闲家重连后仍能看到亮牌,design §8.2) |
| pushlist | 数组 | 出牌历史 [[[], [], []], [[], [], []], ...],外层下标=轮次(从第 1 轮起,含进行中的当前轮),内层恒为 3 个数组、按位置序号存该轮各家出的牌id,各自已按本局主牌花色从大到小排序。仅可查牌模式下有此属性——往轮打出、已被收走的牌属于「查牌」范畴,不查牌模式一律不下发(design §9)。注意当前这一轮桌面上的牌由 playproc.cards 恢复,两种模式下都有,否则后出的人无从跟牌 |
Balance(不在结算阶段无此属性)
| 参数名 | 类型 | 说明 |
|---|---|---|
| readystate | 数组 | 所有玩家的准备状态 |
| aset | json | 单局结算包,同上面结算包中的 aset,只有当自己的准备状态为0时才有此属性 |
战绩(大局列表)gameinfo1
非客户端收发包:大局结束/解散时由
class.desk.jsget_desk_account组装,经import.save_grade(o_room, o_gameinfo1, o_gameinfo2, 1)传给平台战绩服务持久化(服务器→平台)。
| 参数名 | 类型 | 说明 |
|---|---|---|
| roomcode | 整数 | 房号 |
| asetcount | 整数 | 实际局数 |
| createtime | 字符 | 开房时间 |
| makewartime | 字符 | 开战时间 |
| players | 数组 | 玩家列表,元素结构见下 |
players 数组元素结构:
{
"seat": 0, // 座位
"playerid": 100001, // 玩家ID
"name": "", // 昵称
"avatar": "", // 头像
"score": 0 // 成绩
}
战绩(大局)gameinfo2
非客户端收发包:与 gameinfo1 同批,由
import.save_grade的第 3 个参数传给平台战绩服务(服务器→平台)。
牌局列表,数组元素结构:
{
"starttime": "", // 开始时间
"endtime": "", // 结束时间
"seatlist": [6, -6, 0], // 玩家成绩
"callproc": [], // 叫分过程,详情见代码中的注释
"banker": 0, // 庄
"call": 0, // 叫分
"flower": 0, // 主牌花色
"result": 0, // 牌局结果
"cards": [] // 发牌出牌情况,详情见代码中的注释
}