二七王：UI 清单关闭 7 项待确认，补平台图层清单与验收检查表
从平台代码/编辑器数据查证后关闭： - T-2 解散投票：平台全包（Layer 420 CheckFree_Layer + GameUI.openCheck + Desk.self_apply_free_room 一族），子游戏只处理解散结算包，D-10 缩到 只剩结算面板。 - T-3 建房图层：Layer 27 CreateRoom_Layer；Layer 28 SeniorOptions_Layer 是代开房/抽水，与玩法规则选项无关，不走它。 按参考图算定 / 技术自决： - T-21 手牌间距：单排 spacingMin=-78（36 张露 32px，与实测 33px 吻合）， 双排 -65。 - T-27 埋牌分行：上排 floor(n/2)、下排 ceil(n/2)；参考图 17/19 按 mock 处理。 - T-25 line 增加可选 items 支持逐项不等宽，底栏功能钮组与埋牌/出牌操作条 改用它。 - T-17 倒计时归零停在 0 不隐藏（隐藏会被误读为已超时/已跳过）。 - T-28 EQW_Layout 为权威，配置区手工同步并列入验收。 另补： - §0.2 增列平台已占用的 14 个图层（创建房间/解散/帮助/设置/加载/重连/ 战绩/聊天语音等），凡列出者子游戏不必重建。 - 新增 §7.3 验收检查清单 12 条，逐条对应一处已知易错点。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Claude Opus 5
+67
-19
@@ -84,7 +84,27 @@ get_nextseat: function(seat){ return (seat + 1) % 3; }
|
||||
| Loading / Message / Confirm 全局弹窗 | 框架 `UIManager` 全局 UI | 由子游戏在 `UIManager.init` 注入精灵常量 | 若要用，需**另建**这三套弹窗精灵并注入；不用则跳过 |
|
||||
| 战绩列表 | 框架 `RecordView` 组件 + 平台入口精灵 `13` | `gameabc-framework/ui/RecordView.js` | 提供 `RecordView` 配置；战绩数据结构见协议「gameinfo1 / gameinfo2」 |
|
||||
| 帮助界面 | 平台 `GameUI.OpenHelp()`，入口精灵 `150` | —— | 提供二七王玩法说明文案 |
|
||||
| 创建房间界面**骨架** | 平台界面 + 约定精灵 `25`（确认/提交按钮） | 见 `01_SubGame_modify.js` 顶部注释 | **规则选项区要子游戏自建**（§1.1）：渲染 5 个开关行、拼 `roomtype` 串、注册 25 号点击后 `Net.Send_create_room` |
|
||||
| 创建房间界面**骨架** | 平台界面 **Layer 27 `CreateRoom_Layer`** + 约定精灵 `25`（确认/提交按钮） | 见 `01_SubGame_modify.js` 顶部注释 | **规则选项区要子游戏自建**（§1.1）：渲染选项、拼 `roomtype` 串、注册 25 号点击后 `Net.Send_create_room` |
|
||||
| **解散申请 / 投票 / 同意拒绝** | **平台全包**：`Layer 420 CheckFree_Layer` + `GameUI.openCheck/closeCheck` + `Desk.self_apply_free_room` / `other_apply_free_room` / `self_agree_free_room` / `self_refuse_free_room` / `agreefree` / `free_room` | —— | **无**。子游戏只需处理解散**结算包**（§1.10），投票界面不用做 |
|
||||
| 高级选项 / 代开房 | `Layer 28 SeniorOptions_Layer` + `GameUI.openSeniorOptions` | —— | 无。它管短号 / 抽水 / 房间列表，**与玩法规则选项无关**，二七王的规则选项不走这里 |
|
||||
|
||||
**平台已占用的图层一览**（读 `gameabc_Layer.json`，凡此列出者子游戏都不必重建）：
|
||||
|
||||
| 图层 | 名称 | 用途 |
|
||||
| --- | --- | --- |
|
||||
| 27 / 28 | `CreateRoom_Layer` / `SeniorOptions_Layer` | 创建房间 / 高级选项 |
|
||||
| 50 | `MainScene_Layer` | 牌桌主场景 |
|
||||
| 202 / 416 | `Player_Head_Score_Layer` / `MainScene_PlayerInfo_Layer` | 玩家头像与分数 |
|
||||
| 409 / 410 / 418 | `Chat_Voice_Layer` / `Chat_Text_Layer` / `ChatPannel_Layer` | 聊天与语音 |
|
||||
| 420 | `CheckFree_Layer` | **解散投票** |
|
||||
| 608 / 609 | `Help_Layer` / `Setting_Layer` | 帮助 / 设置 |
|
||||
| 612 | `Tips_Layer` | 通用提示 |
|
||||
| 613 | `updateRoomCard_Layer` | 房卡更新 |
|
||||
| 614 / 615 | `Loading_Layer` / `Reconnect_Layer` | 加载 / 断线重连 |
|
||||
| 616 / 619 | `Kick_Layer` / `BackHall_Layer` | 踢人 / 返回大厅 |
|
||||
| 620 | `recordLayer` | 战绩 |
|
||||
|
||||
> 这些都落在框架保留段（1–100 / 201–300 / 401–500 / 601–700），与子游戏段 101–200 / 301–400 不冲突。
|
||||
|
||||
> ⚠️ 参考图底栏左侧的「头像 + 玩家昵称 + 10 + 庄」一行里，**头像/昵称/分数是平台的**，只有 **`庄` 印章**是二七王专属、需子游戏新建。左上/右上玩家位同理：头像框是平台的，**`庄` 印章、`主N`、`对N` 角标、状态文字**是子游戏的。
|
||||
|
||||
@@ -665,7 +685,9 @@ EQW_RoomOptions = {
|
||||
- 解散局 `aset.multiple = 0`、`upgrade = 0`、各家 `grade = 0`，`account` 恒有；
|
||||
- **`data.deskfree` 可能缺失**（开战后、首局发牌前解散时 `get_disbandRoom` 返回 `null`）→ 前端必须容忍。
|
||||
|
||||
界面复用 §1.9 的大局总结算面板。解散**投票**界面是否由平台提供，见 T-2。
|
||||
界面复用 §1.9 的大局总结算面板。
|
||||
|
||||
> **解散的申请/投票/同意拒绝界面由平台全包**（`Layer 420 CheckFree_Layer` + `GameUI.openCheck` + `Desk.self_apply_free_room` / `other_apply_free_room` / `self_agree_free_room` / `self_refuse_free_room` / `agreefree`），子游戏**不做投票界面**，只处理上面这个结算包。
|
||||
|
||||
### 1.11 断线重连 `deskinfo`
|
||||
|
||||
@@ -751,7 +773,7 @@ EQW_RoomOptions = {
|
||||
|
||||
- 数据来源：各包的 `countdown`。
|
||||
- **只做展示，不触发任何操作**（design §11 / 协议 §0.3）：倒计时归零后**不自动叫分/选主/埋牌/出牌**，也不判负、不跳过。前端**不得**在归零时做任何乐观界面推进（不跳阶段、不清控制权），一切仍等服务端推送。
|
||||
- 归零后的表现【待确认 T-17】：显示 `0` 还是隐藏。
|
||||
- **归零后停在 `0` 继续显示，不隐藏**：协议 §0.3 明确归零不触发任何动作、牌局原地等待该玩家；隐藏会被误读为「已超时/已跳过」。
|
||||
- 精灵：群组 224，号段 1150–1159。
|
||||
|
||||
### 2.5 亮牌信息条 【图：多张】
|
||||
@@ -1183,6 +1205,15 @@ for (var i = 0; i < cards.length; i++) {
|
||||
|
||||
`count` 由运行时数据给出，不进配置。
|
||||
|
||||
**逐项不等宽**：给出可选的 `items` 时逐项取宽，`itemWidth` 失效——用于底栏功能钮组（74/87/93/78）与埋牌操作条（180/60/180）这类宽度不一的排：
|
||||
|
||||
```js
|
||||
{ kind: 'line', direction: 'horizontal',
|
||||
anchorX: 1250, anchorY: 672, itemHeight: 30, spacing: 15, anchor: 'right',
|
||||
items: [ {key:'BTN_MINGPAI', width:74}, {key:'BTN_HISTORY', width:87},
|
||||
{key:'BTN_LAST_ROUND', width:93}, {key:'BTN_BOTTOM_CARDS', width:78} ] }
|
||||
```
|
||||
|
||||
#### `fan` — 自适应压缩排
|
||||
|
||||
张数可变、**总宽受限**、需要动态压缩间距的牌排（手牌、出牌区、算奖牌）。
|
||||
@@ -1290,14 +1321,12 @@ CARD_SIZE: {
|
||||
| 亮牌信息条 | `point` | `x:35 y:400 w:210 h:35` |
|
||||
| 底栏条 | `point` | `x:0 y:648 w:1280 h:72` |
|
||||
| 底栏 · 局数文字 | `point` | `x:635 y:672 w:65 h:26`，`textStyle{fontSize:20, align:center}` |
|
||||
| 底栏 · 功能钮组（明牌/已出牌/上一轮/底牌） | `line` | `direction:horizontal, anchorY:672, itemHeight:30, spacing:15, anchor:right, anchorX:1250`；**各钮宽度不等**（74/87/93/78），故按 `anchor:right` 从右往左排，宽度逐项给 |
|
||||
| 底栏 · 功能钮组（明牌/已出牌/上一轮/底牌） | `line` + `items` | `direction:horizontal, anchorX:1250, anchorY:672, itemHeight:30, spacing:15, anchor:right`，`items:[74,87,93,78]`（逐项不等宽，见 §6.1） |
|
||||
| 底栏 · 庄标 | `point` | `x:338 y:668 w:32 h:34` |
|
||||
| 底栏 · 提示按钮组（踩/有分/没分） | `line` | `direction:horizontal, anchorX:335, anchorY:672, itemWidth:52, itemHeight:30, spacing:26, anchor:left` |
|
||||
| 右侧语音钮（平台） | `point` | `x:1210 y:310 w:56 h:56` |
|
||||
| 右侧聊天钮（平台） | `point` | `x:1210 y:385 w:56 h:56` |
|
||||
|
||||
> 底栏功能钮组是**宽度不等**的一排，`line` 的 `itemWidth` 不适用 → 该组用 `line` + 每项独立 `itemWidth` 的变体，或退化为 4 个 `point`【待确认 T-25：是否给 `line` 增加「逐项宽度」支持】。
|
||||
|
||||
### 6.6 玩家位配置（含气泡朝向）
|
||||
|
||||
平台负责头像/昵称/分数，子游戏的附加标记全部 `attach` 到平台头像框上——这样平台布局一调，标记自动跟随。
|
||||
@@ -1328,8 +1357,8 @@ CARD_SIZE: {
|
||||
|
||||
| 区域 | kind | 参数（实测估值） |
|
||||
| --- | --- | --- |
|
||||
| **自己手牌 · 单排** | `fan` | `anchorX:640 anchorY:455 maxWidth:1215 size:L spacingMax:0 spacingMin:-84 anchor:center overlapFrom:left` |
|
||||
| **自己手牌 · 双排（埋牌）** | `fan` ×2 | 上排 `anchorX:644 anchorY:285 maxWidth:928 size:L`；下排 `anchorX:644 anchorY:455 maxWidth:928 size:L`。**分行策略**：上排 `ceil(n/2)-1`、下排其余【待确认 T-27：17/19 的分法依据】 |
|
||||
| **自己手牌 · 单排** | `fan` | `anchorX:640 anchorY:455 maxWidth:1215 size:L spacingMax:0 spacingMin:-78 anchor:center overlapFrom:left`。36 张时算出 `spacing = 1215−110)/35 − 110 ≈ −78`，即每张露 32px，与参考图实测 33px 吻合 |
|
||||
| **自己手牌 · 双排（埋牌）** | `fan` ×2 | 上排 `anchorX:644 anchorY:285 maxWidth:928 size:L spacingMin:-65`；下排 `anchorX:644 anchorY:455 maxWidth:928 size:L spacingMin:-65`。**分行策略：上排 `floor(n/2)`、下排 `ceil(n/2)`**（36 张 = 18/18）。参考图的 17/19 无规则依据，按 mock 处理 |
|
||||
| 手牌 · 选中上浮 | —— | `selectedOffsetY: -40`（配置项，不写死） |
|
||||
| **暗牌区** | `line` | `anchorX:655 anchorY:110 size:L spacing:-36 anchor:center`（8 张） |
|
||||
| **底牌区（结算）** | `line` | `anchorX:640 anchorY:163 size:S spacing:2 anchor:center`（8 张） |
|
||||
@@ -1354,8 +1383,8 @@ CARD_SIZE: {
|
||||
| 选主 · 花色图标 | `attach` | `target:对应花色按钮, hAlign:left, vAlign:middle, offsetX:14` |
|
||||
| 选主 · 张数大字 | `attach` | `target:对应花色按钮, hAlign:center, vAlign:middle, offsetX:14` |
|
||||
| 选主 · 对数角标 | `attach` | `target:对应花色按钮, corner:topRight, offsetX:-36, offsetY:2` |
|
||||
| 埋牌 · 操作条 | `line` | `direction:horizontal anchorX:640 anchorY:165 itemHeight:63 spacing:45 anchor:center`（提示 180 / 倒计时 60 / 埋牌 180，宽度不等，同 T-25） |
|
||||
| 出牌 · 操作条 | `line` | `direction:horizontal anchorX:640 anchorY:345 itemHeight:55 spacing:35 anchor:center`（倒计时 75 / 出牌 157） |
|
||||
| 埋牌 · 操作条 | `line` + `items` | `direction:horizontal anchorX:640 anchorY:165 itemHeight:63 spacing:45 anchor:center`，`items:[180,60,180]`（提示 / 倒计时 / 埋牌） |
|
||||
| 出牌 · 操作条 | `line` + `items` | `direction:horizontal anchorX:640 anchorY:345 itemHeight:55 spacing:35 anchor:center`，`items:[75,157]`（倒计时 / 出牌） |
|
||||
| 捡分飘字 | `point` | `x:570 y:180 w:170 h:55`；另配 `floatRise:-60`、`floatDuration:800`（动画参数也进配置） |
|
||||
|
||||
### 6.9 结算区配置
|
||||
@@ -1446,7 +1475,7 @@ codes/config/
|
||||
| D-7 | 出牌历史面板 | §1.7 | 按轮次 × 3 家 |
|
||||
| D-8 | 判定结果文字（大光/小光/过庄/升N级/投降） | §1.8 | 结算时的判定展示 |
|
||||
| D-9 | 大局总结算 | §1.9 | 三家 × N 局成绩表 |
|
||||
| D-10 | 解散结算 / 解散投票 | §1.10 | 可能复用 D-9 + 平台投票界面 |
|
||||
| D-10 | 解散结算 | §1.10 | **投票界面平台全包**（Layer 420），只剩结算面板，可直接复用 D-9 |
|
||||
| D-11 | 准备标识 | §1.12 | 或复用平台准备标识；**`下一局` 按钮已有图**（§1.8），准备状态标识仍缺 |
|
||||
| ~~D-12~~ | ~~左上家已出牌区~~ | §2.3 | **已定**：与右上家左右镜像，无需单独设计稿 |
|
||||
|
||||
@@ -1455,8 +1484,8 @@ codes/config/
|
||||
| 编号 | 问题 | 影响 |
|
||||
| --- | --- | --- |
|
||||
| ~~T-1~~ | ~~逆时针方向：下家是 `(seat+1)%3` 还是 `(seat+2)%3`~~ | **已定论**，见 §0.1：`class.paiju.js:264` `get_nextseat = (seat+1)%3`，下家显示在右上 |
|
||||
| **T-2** | 解散投票界面是平台提供还是子游戏自建？ | 是否需要 D-10 的一半工作 |
|
||||
| **T-3** | 平台创建房间界面在哪个图层？子游戏选项精灵挂在哪？ | §5.8 的图层归属 |
|
||||
| ~~T-2~~ | ~~解散投票界面是平台提供还是子游戏自建？~~ | **已定论**：**平台全包**（`Layer 420 CheckFree_Layer` + `GameUI.openCheck` + `Desk.*_free_room` 一族），子游戏只处理解散结算包 |
|
||||
| ~~T-3~~ | ~~平台创建房间界面在哪个图层？~~ | **已定论**：**Layer 27 `CreateRoom_Layer`**（`Layer 28 SeniorOptions_Layer` 是代开房/抽水，与玩法规则无关） |
|
||||
| **T-4** | 是否需要发牌动画？ | 动画配置与工期 |
|
||||
| **T-5** | 手牌排序规则（主牌左/右、副牌花色顺序）；选主后重排的动画表现 | 布局算法 |
|
||||
| **T-6** | 叫分档位按钮第 3 帧（参考图第二行橙色）的含义 | `BTN_CALL_SCORE` 帧数 |
|
||||
@@ -1470,21 +1499,40 @@ codes/config/
|
||||
| ~~T-14~~ | ~~结算面板是否展示算奖明细~~ | **已定论**：走独立的**算奖牌型叠加层**（`算奖牌型` 按钮打开），见 `算奖牌型显示.png` |
|
||||
| **T-15** | 准备状态用平台标识还是自建？ | D-11 |
|
||||
| **T-16** | 顶部 `抓分` 列角标：早期图为 `1子`、三张新图均为 `1倍`。**推定为 `1倍`**，但语义待定：是 `aset.upgrade` 判定倍率，还是 `bottom.multiple` 扣底倍数？ | 精灵 1008 的数据源 |
|
||||
| **T-17** | 倒计时归零后显示 `0` 还是隐藏？ | 渲染规则 |
|
||||
| ~~T-17~~ | ~~倒计时归零后显示 `0` 还是隐藏？~~ | **已定**：**停在 `0` 继续显示**。协议 §0.3 明确归零不触发任何动作、牌局原地等待；隐藏会被误读为「已超时/已跳过」 |
|
||||
| **T-18** | 底栏 `底牌` 按钮：庄家点了看自己埋的 8 张？闲家点了看什么？未埋牌时呢？ | 交互定义 |
|
||||
| **T-19** | 数字用图片精灵（多帧）还是文字精灵（`setText`）？ | 是否需要资源 631–634 |
|
||||
| **T-20** | **整套音效**：清单、是否需要语音包、是否分男女声 | §4 全节 |
|
||||
| **T-21** | 手牌 `fan` 的 `spacingMin` / `spacingMax` 具体取值（36 张时最大重叠量） | §6.7 配置值 |
|
||||
| ~~T-21~~ | ~~手牌 `fan` 的 `spacingMin`/`spacingMax` 取值~~ | **已按参考图算定**：单排 `spacingMax:0, spacingMin:-78`（36 张时露 32px，与参考图实测 33px 吻合）；埋牌双排 `spacingMin:-65`。见 §6.7 |
|
||||
| **T-22** | 算奖牌型叠加层的关闭方式（再点按钮 / 点遮罩 / 独立关闭钮） | §1.8 交互 |
|
||||
| **T-23** | 算奖叠加层是否并列显示奖数（`chongguan` / `wang` / `naward`） | 精灵 1825–1827 是否需要 |
|
||||
| ~~T-24~~ | ~~算奖牌 `cards` 超过 8 张时怎么排~~ | **已定论**：改用**精灵复制**（§5.6a），张数不设上限，`fan` 自适应压缩 |
|
||||
| **T-25** | `line` 布局器是否需要支持「逐项不等宽」（底栏功能钮组、埋牌操作条） | §6.1 布局器参数 |
|
||||
| ~~T-25~~ | ~~`line` 是否支持「逐项不等宽」~~ | **已定**：支持。`line` 增加可选 `items:[{width},…]`，给出时逐项取宽、不给时用统一 `itemWidth`。见 §6.1 |
|
||||
| **T-26** | 自己发的提示是否需要本地回显气泡（协议不回执，默认看不到） | §6.6 SELF 气泡 |
|
||||
| **T-27** | 埋牌双排的分行策略（参考图 17/19，依据未知） | §6.7 配置值 |
|
||||
| **T-28** | `EQW_Layout` 与 `Game_Modify.PLAYER_INFO_LAYOUT` 的坐标一致性如何保障（转发壳不能引用 codes） | §6.11 同步机制 |
|
||||
| ~~T-27~~ | ~~埋牌双排分行策略~~ | **已定**：上排 `floor(n/2)`、下排 `ceil(n/2)`（36 张即 18/18）。参考图的 17/19 无规则依据，按 mock 处理 |
|
||||
| ~~T-28~~ | ~~两份布局配置的坐标一致性~~ | **已定**：`EQW_Layout` 为权威，`01_SubGame_modify.js` 配置区手工同步并加注释；一致性列入验收清单（§7.3 第 10 条） |
|
||||
| **T-29** | 建房界面的整体位置与可用尺寸（依赖平台创建房间界面，与 T-3 同源） | §6.9b 的 anchor 起点 |
|
||||
|
||||
### 7.3 开发前置条件
|
||||
### 7.3 验收检查清单
|
||||
|
||||
编码完成后必须逐条核对（每条都对应一处已知易错点）：
|
||||
|
||||
| # | 检查项 | 依据 |
|
||||
| --- | --- | --- |
|
||||
| 1 | `cardIdToFrame` 通过 §0.4 的 10 条校验样例 | 花色段与 id 段序相反，最易静默画错牌 |
|
||||
| 2 | 三家显示位映射正确：下家 `(mySeat+1)%3` 在右上 | §0.1 |
|
||||
| 3 | 提示按钮顺序（踩/有分/没分）与 `tip` 编号（1踩/2没分/3有分）的映射未按下标硬推 | §1.7 |
|
||||
| 4 | 气泡帧号 = `(箭头向右?3:0)+tip`，朝向按头像相对位置取 | §1.7 / §6.6 |
|
||||
| 5 | 不可查牌模式下：`明牌`/`已出牌`/`上一轮` 按钮不出现、亮牌条不出现、`主N`/`对N` 角标不出现 | design §9 |
|
||||
| 6 | 投降结算（无 `bottom`）与解散结算（无 `deskfree` 的情形）都不崩、不显示空框 | §1.8 / §1.10 |
|
||||
| 7 | 解散包从 `data.deskfree.data.aset` 取值，不是 `data.aset` | §1.10 |
|
||||
| 8 | 倒计时归零不做任何界面推进 | 协议 §0.3 |
|
||||
| 9 | 算奖牌型叠加层关闭时 `SpriteCopyUtils.removeRange` 已清理 | §5.6a |
|
||||
| 10 | `EQW_Layout` 与 `Game_Modify.PLAYER_INFO_LAYOUT` 的头像框坐标一致 | §6.11 |
|
||||
| 11 | 丢弃 `this.data`、仅凭最近一次服务端快照重画，界面完全一致 | 前端 05 §6.2 |
|
||||
| 12 | 所有布局参数都在配置文件里，业务代码无裸值 | §6 |
|
||||
|
||||
### 7.4 开发前置条件
|
||||
|
||||
在本清单的资源补齐前，前端**不具备开发条件**的部分：
|
||||
|
||||
|
||||
Reference in New Issue
Block a user