From 32cbe2fe915c9f0fac976af9e856ff00e6a20101 Mon Sep 17 00:00:00 2001 From: Joywayer Date: Wed, 26 Aug 2026 08:14:51 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BA=8C=E4=B8=83=E7=8E=8B=EF=BC=9AT-33=20?= =?UTF-8?q?=E6=8F=90=E7=A4=BA=E6=9D=A1=E6=96=87=E6=A1=88=E5=AE=9A=E6=A1=88?= =?UTF-8?q?=EF=BC=8C=E4=BA=AE=E7=89=8C=E6=94=B9=E4=B8=BA=E7=BA=AF=E8=87=AA?= =?UTF-8?q?=E5=8A=A8=E5=85=B3=E9=97=AD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit T-33 定案，状态提示条全部 4 条： 底牌公示中 全场 70 分开底那 3 秒 等待庄家选主 闲家 shangzhuang → xuanzhu 等待庄家埋牌 闲家 xuanzhu → maipai 强甩失败 全场 收到 shuaicuo==1，自动淡出 明确不做四处并记下理由：叫分等待与出牌等待（倒计时就显示在当前操作者 位置旁，已指明在等谁；出牌一局约 84 次切换，弹条只会吵）、准备等待 （平台自带已准备/未准备标识）、掉线重连提示（平台 Layer 615 已覆盖）。 特别标注一处易绕回去的地方：「底牌公示中」是【界面文案】可以用，但 「底牌公示」作为【术语】已弃用（会与「亮牌＝公示牌力」混淆），规则术语 一律说「开底」。文案配合 8 张牌摊开的画面不会误读，故沿用。 T-34 补充：亮牌面板改为【仅自动时长关闭】，遮罩不注册点击。并列出三个 遮罩面板关闭方式的对照表——亮牌仅自动、冲关牌型点遮罩、明牌/出牌历史 点遮罩+按钮切换，三者不同，实现时最容易写混。 至此待确认 34 项只剩 T-20 音效（已明确后补）。 Co-Authored-By: Claude Opus 5 (1M context) --- docs_dev/二七王-UI资源与精灵清单.md | 59 +++++++++++++++++------------ 1 file changed, 34 insertions(+), 25 deletions(-) diff --git a/docs_dev/二七王-UI资源与精灵清单.md b/docs_dev/二七王-UI资源与精灵清单.md index 6cf84dc..df810c6 100644 --- a/docs_dev/二七王-UI资源与精灵清单.md +++ b/docs_dev/二七王-UI资源与精灵清单.md @@ -628,12 +628,20 @@ EQW_RoomOptions = { **展示形式**：与**明牌**同一套版式（半透黑遮罩 + 一排牌，照 `冲关牌型显示.png`），只是这里只有一排（庄家的）。可与 §5.7b 的明牌面板复用同一套精灵与渲染，仅数据源不同。 +> **三个遮罩面板的关闭方式各不相同，别写混**： +> +> | 面板 | 关闭方式 | 遮罩是否可点 | +> | --- | --- | --- | +> | **亮牌**（本节） | **仅自动时长**，到点自动收起 | ❌ 不注册点击 | +> | **冲关牌型**（§1.8） | **点遮罩关闭** | ✅ 是关闭热区 | +> | **明牌 / 出牌历史**（§1.7） | 点遮罩关闭；明牌另可再点按钮切换 | ✅ 是关闭热区 | + **数量前端自己数**——协议不再下发 `zhu`/`zhupair`/`wang`/`qi`/`er` 等统计，需要显示「x 张王」之类就从 `cards` 里算。 **展示时机（T-34 已定）**：**埋牌后、出牌前**——庄家埋牌完成、服务端下发 `maipai` 包（其中带 `liangpai`）时弹出，出牌开始前收起。 - 与 design §8.2「庄家埋牌后……出牌开始前」的规则时点一致。 -- 这是**一次性弹出**，不是常驻入口；关闭方式与冲关牌型叠加层一致（点遮罩关闭），另配一个自动关闭时长兜底，参数进配置（`liangpaiAutoClose`，默认值待定）。 +- 这是**一次性弹出**，不是常驻入口。**关闭方式：只按自动时长关闭，不做点击关闭**——遮罩不注册点击事件。时长进配置（`liangpaiAutoClose`，默认值待定）。 - 只有**闲家**会收到 `liangpai` 并弹出；庄家自己不弹（自己的牌自己看得见）。 - **不阻塞出牌**：面板关闭与否不影响服务端推进，出牌包照常到达；若面板还开着就收到了出牌推送，直接收起面板即可。 @@ -1038,32 +1046,32 @@ y≈648–720 深色条。左侧头像/昵称/分数由平台渲染（§0.2） - 两类**共用一套精灵**（`BAR_TOAST` + 文字精灵），位置由布局配置的两个预设切换。 - 文案表进配置，不在代码里写死字符串。 - 精灵：图层 105 群组 230，`1760` 条底 + `1761` 文字。 -#### 文案清单 +#### 文案清单（T-33 已定） -**即时反馈类**（自动淡出）： +**全部 4 条**。叫分 / 出牌 / 准备三处**不做**提示条——理由见下表。 -| 文案 | 触发 | -| --- | --- | -| `强甩失败` | 收到 `chupai1.shuaicuo == 1`（§1.7 D-3） | - -**等待类**（常驻到该状态结束）——【T-33 待你确认增删】： - -| # | 文案 | 谁看到 | 显示区间 | 依据 | +| # | 文案 | 类型 | 谁看到 | 显示区间 | | --- | --- | --- | --- | --- | -| W1 | `等待{昵称}叫分` | 除当前叫分者外的两家 | 收 `fapai` / `jiaofen` 后，`seat`(或 `nextseat`) ≠ 自己 | §1.3 | -| W2 | `等待庄家选主` | 两个闲家 | 收 `shangzhuang` 后 → 收 `xuanzhu` 前 | §1.5，**已有图** | -| W3 | `等待庄家埋牌` | 两个闲家 | 收 `xuanzhu` 后 → 收 `maipai` 前 | §1.6 | -| W4 | `等待{昵称}出牌` | 除当前出牌者外的两家 | 出牌阶段 `playproc.currseat` ≠ 自己 | §1.7；**是否需要待定**，见下 | -| W5 | `等待其他玩家准备` | 已点过 `下一局` 的人 | 自己 `zhunbei` 后 → 新一局 `fapai` 前 | §1.12 | -| W6 | 开底期间的提示 | 全场 | 70 分坐庄开底那 3 秒 | §1.4；**文案待定**，见下 | +| 1 | **`底牌公示中`** | 状态类 | **全场三人** | 70 分坐庄**开底**那 3 秒（§1.4） | +| 2 | **`等待庄家选主`** | 状态类 | 两个闲家 | 收 `shangzhuang` 后 → 收 `xuanzhu` 前（§1.5） | +| 3 | **`等待庄家埋牌`** | 状态类 | 两个闲家 | 收 `xuanzhu` 后 → 收 `maipai` 前（§1.6） | +| 4 | **`强甩失败`** | 即时反馈 | 全场 | 收到 `chupai1.shuaicuo == 1`，自动淡出（§1.7） | -**三处需要你定**： +> 前 3 条是「状态类」——常驻到该状态结束、由收包驱动收起；第 4 条是「即时反馈类」——自动淡出。 +> 两类**共用同一套精灵**（`BAR_TOAST` + 文字），只切位置预设与文案（见上表位置）。 -1. **W4 出牌等待要不要做**——出牌阶段一局有 28 轮 × 3 家 ≈ 84 次切换，每次都弹提示条会很吵；而且此时已有**倒计时**（在当前出牌者位置旁）和**已出牌区**两重指示，信息其实不缺。倾向**不做**。 -2. **W6 开底那 3 秒显示什么**——参考图 `等待庄家选主.png` 上写的是 `等待庄家选主`，但那张图把开底与选主两个状态叠画了（§0.5），不能直接采信。候选：`底牌公示中` / `等待庄家摸底` / 这 3 秒不显示提示条。 -3. **文案里要不要带昵称**（W1 / W4）。带昵称更明确，但昵称长度不定、提示条要能随文案变宽；不带则统一为 `等待其他玩家叫分` 之类。 +**明确不做的**（已确认）： -> 文案表进配置（§6.10 的 `Layout_Table.js` 或单独的文案配置），不在代码里写死字符串。 +| 不做 | 理由 | +| --- | --- | +| 叫分等待 | **倒计时已经指明在等谁**——它就显示在当前叫分者的位置旁（§2.4） | +| 出牌等待 | 同上；且一局约 84 次切换，弹条只会吵 | +| 准备等待 | **平台自带已准备 / 未准备标识**（§0.2），不重复造 | +| 玩家掉线 / 重连提示 | **平台已覆盖**（`Layer 615 Reconnect_Layer` 等），子游戏不实现 | + +> ⚠️ **`底牌公示中` 是界面文案，不是术语**。规则术语是「**开底**」（§0.0）；「底牌公示」作为**术语**已弃用（会与「亮牌＝公示牌力」混淆），但作为**文案**配合画面（8 张牌摊开）不会误读，故沿用。文档与代码里描述规则时一律说「开底」。 + +文案表进配置，不在代码里写死字符串。 > 原 §5.5 的 `BAR_SHUAICUO`（1754/1759）并入本部件——甩错只是这条通用提示条的一种文案，不必单独出图。 @@ -1771,7 +1779,7 @@ codes/config/ ## 7. 待补充清单 -> **状态汇总**（2026-08-26）：设计稿只剩 **D-8**（判定结果文字）。 +> **状态汇总**（2026-08-26）：待确认规格 34 项**只剩 T-20 音效**（已明确后补）；设计稿只剩 **D-8**（判定结果文字）。 > **§7.5 服务端待补项 7 条已全部处理完毕**（S-1/S-2/S-4/S-6 有代码改动，S-3/S-5/S-7 为定论或文档同步）。**服务端侧无遗留**。 ### 7.1 待出设计稿的界面 @@ -1797,14 +1805,14 @@ codes/config/ ### 7.2 待确认的规格问题 -**仍未决（2 项）** +**仍未决（1 项）** | 编号 | 问题 | 影响 | | --- | --- | --- | | **T-20** | **整套音效**：清单、是否需要语音包、是否分男女声、倒计时提示音从第几秒起 | §4 全节；已明确「等待后续补充」 | -| **T-33** | 「等待类」提示条文案：候选清单 W1–W6 已列在 §2.8，需你**增删并定三处**——W4 出牌等待要不要做、W6 开底 3 秒显示什么、文案是否带昵称 | §2.8 | -**已定论（32 项）** + +**已定论（33 项）** | 编号 | 结论 | | --- | --- | @@ -1840,6 +1848,7 @@ codes/config/ | ~~T-31~~ | ~~大局结算「基础分」与「总得分」两行的对应~~ | **已定**：参考图数值是填充假数据、不作依据（§0.5）。取 `grade_jf_total`（基础分）与 `score`（总分），见 S-6 | | ~~T-32~~ | ~~`等待庄家选主.png` 里底牌仍摊着与 design §4 顺序不符~~ | **已定**：叠画示意（§0.5）。实际按 design §4 的先后：开底 3 秒 → 摸底入手 → 选主 | | ~~T-34~~ | ~~亮牌的展示时机~~ | **已定**：**埋牌后、出牌前**一次性弹出（收 `maipai` 包时），点遮罩关闭 + 自动关闭时长兜底。见 §1.6 | +| ~~T-33~~ | ~~等待提示条文案~~ | **已定**：全部 4 条（`底牌公示中` / `等待庄家选主` / `等待庄家埋牌` / `强甩失败`）。叫分·出牌·准备·掉线四处不做——倒计时与平台标识已覆盖。见 §2.8 | #### T-5 手牌排序（已定）