二七王:倒计时与结算得分改用数字图精灵,收尾几处命名与文档订正

- CD_LEFT/CD_RIGHT/CD_SELF(1150-1152)由文字精灵改为多帧图数字精灵:
  资源 NUM_COUNTDOWN,纯秒数无后缀;对应布局节点 P_COUNTDOWN 的 h 改取
  NUM_STYLE.COUNTDOWN.charHeight,w 留到运行时注入。
- 结算得分 RESULT_SCORE_LEFT/RIGHT/SELF(1805-1807)同理由文字精灵改为
  数字图精灵(NUM_RESULT_WIN/NUM_RESULT_LOSE),与大局结算已有的
  ACC_TPL_SCORE_NUM 保持一致;布局节点随之调整,移除不再使用的
  TEXT_STYLE.SCORE_BIG。
- NUM_CALL_SCORE 第16帧由"待美术与规则确认"改为明确的"无后缀"(叫分档位
  面板只显示纯数字,"N子"角标是独立文字精灵);NUM_MAIN_SUIT_COUNT /
  NUM_RESULT_WIN / NUM_RESULT_LOSE 第16帧仍待确认,不改。
- Layout_Action.js 的 CALL_BTN_SCORE_TEXT、Layout_Result.js 的
  RESULT_SCORE_TEXT 改名为 CALL_BTN_SCORE_NUM / RESULT_SCORE_NUM:
  两者驱动的都是数字图精灵,_TEXT 后缀误导;同步测试引用。
- docs/client/development-guide/02:订正"SpriteManager 第1154行"这一失效
  行号引用(回退后该行号落在 setTextWithWidth 体内),改为不写死行号。
- docs_dev 清单同步:§2.4/§5.4/§5.6/§6.6/§6.9 倒计时与结算得分的精灵类型
  描述、§6.6/§6.9 对应布局参数。
- test_constants.js 的 NUM_STYLE 同源守卫表新增 COUNTDOWN、RESULT_WIN、
  RESULT_LOSE 三对(连同改名后的 CALL_BTN_SCORE_NUM),共 6 条新断言。

精灵总数、布局节点总数均未变(378 / 61),只改类型与命名,不增删。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-08-27 00:54:42 +08:00
co-authored by Claude Opus 5
parent 857bc955bb
commit 0c58ae67db
10 changed files with 46 additions and 21 deletions
@@ -977,6 +977,7 @@ EQW_RoomOptions = {
- **只做展示,不触发任何操作**(design §11 / 协议 §0.3):倒计时归零后**不自动叫分/选主/埋牌/出牌**,也不判负、不跳过。前端**不得**在归零时做任何乐观界面推进(不跳阶段、不清控制权),一切仍等服务端推送。
- **归零后停在 `0` 继续显示,不隐藏**:协议 §0.3 明确归零不触发任何动作、牌局原地等待该玩家;隐藏会被误读为「已超时/已跳过」。
- 精灵:群组 224,号段 1150–1159。
- **精灵类型(2026-08-27 订正)**:3 个倒计时精灵均为**多帧图数字精灵**(非文字精灵)——玩家视线焦点、视觉权重最高的数字,参考图是带描边/渐变的美术字,文字精灵做不出这个效果。显示走 `SpriteManager.setNumberImage`,资源 `NUM_COUNTDOWN`(§3.6),纯秒数无后缀。见 §5.4 / §6.8。
### 2.5 自己的主牌统计 + 余主公示(他家)【图:多张】
@@ -1347,9 +1348,9 @@ design 与协议均**未定义任何音效**。以下是按牌类游戏常规推
| | 1711 | `PLAY_BTN_SUBMIT_TEXT` | 文字 | —— | —— |
| | 1712 | `PLAY_BTN_TIP` | 图片 | `提示`(出牌阶段必备) | `BTN_TIP` |
| | 1713 | `PLAY_BTN_TIP_TEXT` | 文字 | 按钮文案 | —— |
| **224** 倒计时 | 1150 | `CD_LEFT` | 文字 | 左上家位倒计时 | —— |
| | 1151 | `CD_RIGHT` | 文字 | 右上家位倒计时 | —— |
| | 1152 | `CD_SELF` | 文字 | 自己操作区倒计时 | —— |
| **224** 倒计时(2026-08-27 订正:由文字精灵改为多帧图数字精灵,见 §2.4/§6.8) | 1150 | `CD_LEFT` | **多帧图数字精灵** | 左上家位倒计时 | `NUM_COUNTDOWN`(16 帧)+ `NUM_STYLE.COUNTDOWN.charWidth` |
| | 1151 | `CD_RIGHT` | **多帧图数字精灵** | 右上家位倒计时 | `NUM_COUNTDOWN`(16 帧)+ `NUM_STYLE.COUNTDOWN.charWidth` |
| | 1152 | `CD_SELF` | **多帧图数字精灵** | 自己操作区倒计时 | `NUM_COUNTDOWN`(16 帧)+ `NUM_STYLE.COUNTDOWN.charWidth` |
### 5.5 Layer 105 · 桌面浮层(群组 230)
@@ -1371,7 +1372,7 @@ design 与协议均**未定义任何音效**。以下是按牌类游戏常规推
| 1800 | `RESULT_BOTTOM_PANEL` | 图片 | 底牌区面板底 | `PANEL_BOTTOM_CARDS` |
| 1801 | `RESULT_BOTTOM_TEXT` | 文字 | `叫分{multiple}子 底牌 {grade1}x{bottom.multiple}` | —— |
| 1802–1804 | `RESULT_GLOW_LEFT/RIGHT/SELF` | 图片 ×3 | 三家分数光晕 | `GLOW_RESULT` 帧1赢/帧2输 |
| 1805–1807 | `RESULT_SCORE_LEFT/RIGHT/SELF` | 文字 ×3 | 三家总分(`aset.seatlist[i].grade`) | —— |
| 1805–1807 | `RESULT_SCORE_LEFT/RIGHT/SELF` | **多帧图数字精灵** ×3(2026-08-27 由文字精灵改,见 §1.9/§6.9) | 三家总分(`aset.seatlist[i].grade`),正分橙带 `+`/负分蓝带 `-`,与 `ACC_TPL_SCORE_NUM`(1914)同一套资源与用法 | `NUM_RESULT_WIN`(赢)/ `NUM_RESULT_LOSE`(输)+ `NUM_STYLE.RESULT_WIN/RESULT_LOSE.charWidth` |
| 1808–1810 | `RESULT_JF_LEFT/RIGHT/SELF` | 文字 ×3 | 捡分子数得分 `grade_jf`【T-13】 | —— |
| 1811–1813 | `RESULT_AW_LEFT/RIGHT/SELF` | 文字 ×3 | 算奖得分 `grade_aw`【T-13】 | —— |
| ~~1814~~ | ~~`RESULT_JUDGE_TEXT`~~ | —— | **不需要**:结算面板不显示判定文字,改由动画呈现(§1.8) | —— |
@@ -1690,7 +1691,7 @@ CARD_SIZE: {
| `主N` 角标 | `attach` | `target:头像框, corner:bottomLeft, offsetX:0, offsetY:6, w:40 h:19` |
| `对N` 角标 | `attach` | `target:主N角标, hAlign:right, vAlign:middle, offsetX:44, offsetY:0` |
| 状态文字(`60分`/`不叫`) | `point` | `bySeat{ LEFT:{x:170,y:165}, RIGHT:{x:980,y:165} }`,`w:130 h:70`,`textStyle{fontSize:46, align:center}` |
| 倒计时 | `point` | `bySeat{ LEFT:{x:195,y:165}, RIGHT:{x:1010,y:165}, SELF:{x:445,y:345} }`,`w:75 h:70` |
| 倒计时(多帧图数字精灵,2026-08-27 订正) | `point` | `bySeat{ LEFT:{x:195,y:165}, RIGHT:{x:1010,y:165}, SELF:{x:445,y:345} }`,`h:NUM_STYLE.COUNTDOWN.charHeight(60)`;`w` 运行时注入(1–2 位数字,`setNumberImage` 按字符数 × `charWidth` 自动改宽) |
**提示气泡的朝向与位置**(资源 `BUBBLE_TISHI` 6 帧,§3.7):
@@ -1766,7 +1767,7 @@ CARD_SIZE: {
| 底牌面板底 | `point` | `x:430 y:140 w:420 h:148` |
| 底牌说明文字 | `attach` | `target:底牌面板底, hAlign:center, vAlign:bottom, offsetY:-14` |
| **三家分数光晕** | `point` | `bySeat{ LEFT:{x:175,y:150}, RIGHT:{x:865,y:150}, SELF:{x:490,y:340} }`,`w:225 h:100` |
| 三家总分大字 | `attach` | `target:对应光晕, hAlign:center, vAlign:middle`,`textStyle{fontSize:56, align:center}` |
| 三家总分大字(多帧图数字精灵,2026-08-27 由文字精灵改,见 §1.9/§5.6) | `attach` | `target:对应光晕, hAlign:center, vAlign:middle`,`h:NUM_STYLE.RESULT_WIN.charHeight(62)`(与 `RESULT_LOSE` 相同);`w` 运行时注入 |
| 三家 `牌局分` | `attach` | `target:对应光晕, hAlign:left, vAlign:bottom, offsetX:-15, offsetY:24` |
| 三家 `冲关分` | `attach` | `target:对应光晕, hAlign:right, vAlign:bottom, offsetX:15, offsetY:24` |
| `冲关牌型` 按钮 | `point` | `x:535 y:515 w:183 h:63` |