AMG UI 标准 v2 · AMG UI STANDARD v2(深棕玻璃)

STANDARD.md · latest.json · pieces/ · CHANGELOG.md

本版取代 2026-10-20 v3;唯一来源＝线上深棕玻璃原件(零件取线上原件,附来源与 SHA,不重画、不 AI 生成)。
正本存放位置:(internal)(NAS 正本;工作副本 (internal))。版本固定 v2 一个正本。
Supersedes the 2026-10-20 v3. Single source = the live dark-brown glass originals. No piece is redrawn or AI-generated.

配套:PIECES.csv(零件清单+SHA256)· pieces/(原档)· AMG-UI-STANDARD-v2.pdf(同内容,一页一表)· DIFF-TO-ADOPT.md(5 款换件)· check-conformance(只读检查脚本)。

验收规则 Acceptance rule(Victor 2026-10-23)

改完后每款游戏的每个标准零件必须与 PIECES.csv 的 SHA256 完全相同(逐档比对,不是目视);以后每次改动都跑 ./check-conformance。细节见本文件第 23 节与下文。

P1 · 封面 · 元信息 · Cover · metadata ALL

每页左为线上实机截图(DPR3),右为 1 张表。色值/尺寸/字号均为 getBoundingClientRect/getComputedStyle 量测;croc、tower 的 DOM 在 828 宽设计舞台里再缩放 0.471 到 390,表内已换算成显示值(推的:computed×0.471)。

P2 · 色彩令牌 · 字体 · Colour tokens · fonts TOKENS · FONT-*

以上令牌是「线上多数版」,不是我新定;chicken(.88/.92)与 tower(.92/.5)要改到多数版才能「一模一样」(见 DIFF 与第 19 页)。

P3 · 顶栏 · 主页钮 Home · Top bar · Home TB-HOME

P4 · 顶栏 · 说明钮 Info (i) · Top bar · Info (i) TB-INFO

P5 · 顶栏 · 声音钮 Sound(开 / 静音) · Top bar · Sound (on / muted) TB-SOUND

P6 · 顶栏 · 记录钮 History(时钟 + 徽标) · Top bar · History (clock + badge) TB-HIST · FSBTN

P7 · 余额胶囊 Balance capsule · Balance capsule (DEMO / name + balance) BAL

P8 · 筹码 1K–500K + 选中环 · Chips 1K–500K + selected ring HUD-CHIP-* · HUD-RING · CHIPROW

P9 · PLAY 钮 · PLAY button HUD-PLAY

P10 · 清除 / HAPUS 钮 · Clear (HAPUS) button HUD-CLEAR

P11 · 总下注框 TOTAL TARUHAN · Total bet box TOTAL

P12 · 下注面板底 Bet panel base · Bet panel base (bottom sheet) PANEL-BOTTOM

P13 · 说明弹窗 Info (rules) popup · Info popup PANEL-INFO

P14 · 记录面板 History panel (RIWAYAT) · History panel PANEL-HIST

P15 · 结算卡 / 赢钱弹窗 · Result card / win popup WINPOP · WP-*

P16 · 错误卡 Error card V1 · Error card (V1: dark-brown) ERRCARD

P17 · 载入页 Loading screen · Loading screen LD-TRACK · LD-FILL · LD-KNOB · LOADBAR

P18 · 状态总表:按下 · 选中 · 禁用 · State table: pressed · selected · disabled STATES

本页数值读自线上 CSS/注入样式(grep 实读 + fit.ts 源码),并用真 mousedown 实测交叉验证(PLAY 在 wheel/tower 的 scale 与规则吻合;注意 wheel/tower 的 PLAY 在 pend 态有脉冲动画,mousedown 取样可能混入动画帧,所以以规则为准)。禁用态截图是把 disabled 属性强设后渲染线上规则(shots/<款>/disabled-forced-*.png),因 demo 下 PLAY/CLEAR 不会自然进入禁用态。

P19 · 差异裁决表 · Decision table DECISIONS

票述「5 项小差」在 1–5 行;6–15 行是本次实测另发现的差异,按同一规则处理(取最多款;并列/各异=未定,不擅定)。croc/tower 的显示值=computed×0.471(推的),其余为量的。原「未定」项(1、2、5、7、10、11、12、13 + P20 摆法参考)已由总监 #1650(Victor 授权)一律取 wheel 实测值定案,裁决正本 reports/amg-ui-decisions-1650-20261023.md;改完全部界面逐张给 Victor 过目、点头才上。

P20 · 摆法图 · 直立 390×844 · Placement · portrait LAYOUT

线上 wheel 实机渲染(隐藏玩法控件、中性灰底),零件是线上原件,非重画。参考由 croc 改 wheel(总监 #1650 定 2026-10-23)。

P21 · 摆法图 · 横屏 844×390 · Placement · landscape LAYOUT

同上;横屏。

P22 · 缺件 · 未核实 · 不取 · Missing · unverified · not taken MISSING

P23 · 验收规则 + check-conformance · Acceptance rule + check-conformance RULE

变更记录:v2 · 2026-10-23 · 总监 #1650(Victor 授权)定:原 P19「未定/并列」项(1 余额胶囊 140×56、2 关闭钮 Tutup、5 PLAY 距底 36、7 阴影 0 2 10 #00000080、10 PLAY 216×56、11 PLAY 按下 scale(.93)+brightness(1.2)、12 面板底有且直角、13 总下注框 140×56)与 P20/P21 摆法参考一律取 wheel 实测;r2(同日总监补裁):余额数字 20px、PLAY pend 脉冲、赢后结果条同取 wheel;check-conformance 阈值与 DIFF-TO-ADOPT 件数同步;版本仍 v2。

P24 · 动画必备五类 · Required animation set ANIM(Victor 2026-10-25 22:15 令)

Victor:「不是要一模一样的动画,但是都要有这些动画。」每款 AMG 游戏五类都要有,做法各款自定;缺任一类不算过标准。参考做法与节拍 = Mines AMG 包 (internal) + preview-amg-mines-anim.mp4(Victor 10-25「动画做得很好」)。

变更记录:P24 · 2026-10-25 22:17 · 总监依 Victor 令新增;v2 版本号不变(追加页)。

10-26 10:0x Victor 追加三条(P25–P27,必备)

• P25 iPhone Duo 适配:AMG 全款必须在 iPhone Duo 内屏(≈669×951 pt 直/横)、外屏(≈610×850 直/横)四态正常:游戏主体居中、遮罩全屏、壳不重叠、字可读;goalshoot 10-24 已过,其余 9 款逐款补。
• P26 声音钮首按即响:第一次点击声音钮必须立刻出声(用那一次手势 resume AudioContext + 已解码件即播;未解码件先播最短 UI 音再补载),钮态即时切换;不准出现「按多次才响」(Victor 10-26 实测)。
• P27 home/返回钮必须有动作:优先 returnUrl/lobby 查询参数(AMG 启动时带),其次 history.back()(有来源页),再其次 https://amglobby.pages.dev/;点了 300 ms 内要有可见反应(按钮按下态/转场)。
• P26 补注(10-26 10:0x 总监裁):进页为「有声」态但 AudioContext 仍 suspended 时,页面上首个任意手势要 resume 并起 BGM;此时 ♪ 第一下视为「开声」(resume+播),不是关声;只有实际出声中按 ♪ 才是关声。钮态=实际可听状态。
• P26 补注二(Victor 10-26 11:4x):所有音效/BGM 在 loading 画面阶段就全部加载并解码完(decodeAudioData 不需要手势),loading 条走完 = 声音已就绪;♪ 第一下只做 resume + 出声(确认音用真实音效,不是因为没解码而合成 blip);不准等到点声音钮才去加载。

补注四(总监 10-26 11:3x,Sol r3 三款同型 FAIL 后定:「开声状态机」,所有款照这个做,不准各自猜)

Sol r3 把 mines/tower/wheel 的 v2 全退回,三款败在同一件事:「实际可听状态」没有一个唯一、随真实播放结果更新的状态源。以下是唯一正确模型,实作与测试都照它:

状态 soundState ∈ {locked, opening, audible, muted},唯一来源(一个模块持有,壳/按钮/BGM/预载全部订阅它,不准各自再存一份 isMuted/opened/heard 当判断依据):

• locked:AudioContext suspended 或从未真正出过声(页面刚进、resume 没成功过)。用户偏好 prefMuted(localStorage)只是偏好,不是状态。
• opening:某个手势已在同步栈内调了 ctx.resume() + 已排入确认音/BGM,但 resume 的 promise 还没落定。
• audible:resume 已 resolve 且 ctx.state==='running',且确认音或 BGM 已 start()。
• muted:用户在 audible 下按 ♪ 关掉(gain=0 / BGM 停),prefMuted=true。

转移(全部要有测试,每条一个 case):

1. 任意元素的首个手势(pointerdown/click/touchend,页面级一次性监听)在 locked → 同步栈内 resume() + 若 prefMuted=false 则起 BGM → 进 opening;resume resolve → audible;resume reject 或 1.5 s 内 ctx 仍非 running → 回 locked(清掉任何「已开」标记,允许下次手势重试),不准停在 opening,更不准算 audible。
2. ♪ 在 locked / opening → 视为「开声」:同步 resume() + 播已解码的确认音(ui.sound_on 类)+ 若有 BGM 起 BGM + prefMuted=false → opening(落定规则同 1)。不是翻 prefMuted。
3. ♪ 在 audible → muted(gain 0 / BGM pause,prefMuted=true)。
4. ♪ 在 muted → audible(gain 恢复 / BGM 续播,prefMuted=false;若 ctx 期间被系统挂起,则走 2 的 resume 路径)。
5. audible 下 ctx 被系统挂起(statechange → suspended,iOS 切后台/来电)→ 回 locked,保留 prefMuted 不变;回前台的首个手势按 1 处理(prefMuted=true 时 resume 但不起 BGM)。
6. 按钮图示 = f(soundState):locked/opening/muted 画「静音」样式(可加小点表示待开),audible 画「有声」;不准用 prefMuted 画图示。
7. loading 放行条件(补注二):清单内全部 cue decodeAudioData 完成(断言 decoded === manifest.length);解码不需手势;放行前不准播任何东西;合成 blip 只在某 cue 解码失败时作该 cue 的替身。
8. 转移 1/2 的 resume() 与 start() 必须在手势事件的同步栈内调用(不在 .then()、不在 await 之后、不在 setTimeout);测试用「resume 返回挂起的 promise」验证:handler 返回时 resume 已被调 1 次、start 已被调 ≥1 次,而 promise 尚未落定。

测试最少覆盖(每款):①锁态首按 ♪ → opening → resolve → audible,第二按 → muted;②锁态首按 ♪,resume reject → 回 locked,再按一次又会 resume(重试);③任意元素(非 ♪)首按 → opening → resolve → audible,随后按 ♪ → muted(不是再播确认音);④ audible 时 statechange→suspended → locked,图示变静音;⑤图示在上述每个状态的断言;⑥loading 放行时 decoded===manifest.length;⑦退回验红(去掉状态更新那行测试要红)。 Home 钮(P27):按钮元素必须真的带 id="home"(或接线处用的选择器真能选到它),进场 loading 期间可点,点了 300 ms 内有按下态;用真实 click 事件测导航函数被调 1 次(mines v2 的 press('home') 取到 null 抛错 = onBack 从没跑,就是这种假接线)。

P26 补注五 v2(10-26 12:3x 总监裁,Sol 砍过一次 12 条已并入):开声状态机只准有一份实作,放在 common/engine,各款只接线

Sol 四轮(b1/r2/r3/r4a)退回的阻断项是同一件事反复出现:每款各写一套 soundState,各自漏掉一种事件顺序。从本补注起:

1. 共用模块(唯一实作)

common/engine/src/audio/sound-state.ts 导出 createSoundState(opts)。各款壳/页面不准再自己持有 muted/opened/audible/hostMuted 任何旗,不准自己调 ctx.resume()/source.start(),不准有自动开声分支。模块拥有:ctx、输出总闸(一个 master GainNode,所有声音都经它)、state ∈ {locked, opening, audible, muted}、userMuted(静音偏好,独立于 state)、subscribe(fn)、prepare(manifest, onProgress, {deadlineMs})、bindGestures(root, {exclude})、press()、play(cue, opts) → handle|null、startLoop(cue, {loopStart, loopEnd, syncWith?}) → handle|null、setParam(handle, …)、stopAll()、dispose()。

2. 硬规则

1. 可信激活事件:bindGestures 只认 pointerup/touchend/click 与 keydown(仅 Enter/Space,过滤 repeat);同一次操作(pointer→click 链)只算一次尝试(用 attempt token 去重)。♪ 钮经 exclude 排除在通用开声之外,它的一次完整操作只跑一次 press()。
2. audible 的定义 = 播放就绪并已证明:本次尝试的 resume() 已 resolve 且 ctx.state==='running' 且 在该手势同步栈内提交的内建确认音(模块自带 ~60 ms 已解码非静音 click,base64 内联,不走网络、不会失败)start() 成功且 source 已连到输出闸。BGM/替身/静音帧都不是证据。opening 期只准起这一个确认音。
3. 事件顺序无关 + 尝试代号:每次尝试带 token;resolve/running 任一顺序都行;resolve 了但 ctx 仍 suspended → 等 statechange 或 timeoutMs(默认 1500,可配)→ 超时/reject/中断:停掉该尝试的 source、关输出闸、作废其回调,回 locked;迟到的旧 token 结果一律忽略;下一手势可再试。
4. loading 闸:prepare() 对清单逐件下载+解码,失败件重试 1 次,再失败建替身(按清单声明的 durationMs/循环点建静音 buffer,带 failed 标记,只用于不崩、不作证据、BGM 替身不循环播放);每件互斥计一次(decoded 或 failed);整体 deadlineMs(默认 20000)到期把未完成件都记 failed 并 resolve。prepare() resolve 前:play/startLoop 丢弃不积压;开声手势也不提交任何声音(只 resume,状态最高到 opening),ready 后不补播,等下一手势。入口核 decoded + failed === manifest.length 才算 loading 完成。
5. 播放许可唯一:play/startLoop 只在 audible 放行,否则返回 null(调用方据此维护自己的循环状态,不得假设已播);stopAll() 停模块拥有的全部 source。
6. 生命周期:同时监听 ctx statechange 与 visibilitychange/pagehide/freeze;离开 running(suspended/interrupted/closed)或页面离开前台 → 立即关输出闸、停循环、作废当前尝试、state→locked(userMuted 不变);系统自行恢复 running 不开闸、不改 state;回前台等下一手势。pageshow(persisted)(BFCache)视同重挂:重新绑定、state=locked。
7. 静音偏好:userMuted 由 localStorage 初始化、只由 press() 翻转;通用手势永不清除它。press() 语义:locked/opening → 开声尝试(若 userMuted=true 则同时清偏好);audible → userMuted=true + 关闸 → muted;muted → 开闸 →(ctx 仍 running)audible 否则重走开声。图示 = f(state),壳只 subscribe。
8. 壳不准有第二套决策:壳里 ctx.resume、muted = !muted、hostMuted、自动开声分支一律删除。
9. 销毁契约:dispose() 幂等:解绑所有监听/订阅/定时器,作废全部异步结果,停并释放拥有的音频资源。

3. 测试(共用模块自带,各款不重写)

sound-state.test.ts 用假 AudioContext 可控触发 resolve/reject/statechange 顺序与时序,至少覆盖:①–⑦(补注四)+ ⑧ running 先到 reject 后到 → locked;⑨ resolve 先到仍 suspended → 超时 locked 且该尝试 source 被 stop;⑩ 旧 token 迟到 resolve 被忽略;⑪ loading 中手势 → 不提交声音、不 audible、ready 后不补播;⑫ 解码失败件替身计数正确、替身不作证据、BGM 替身不循环;⑬ pagehide/interrupted → 关闸停循环 locked,系统恢复 running 不开闸;⑭ userMuted 下通用手势不出声不清偏好,press 才取消;⑮ ♪ 的 pointer→click 链只算一次 press;⑯ locked 下 play 返回 null、恢复后无积压 start;⑰ dispose 后无监听无 source。 各款只做接线测试:挂载真实壳 DOM,派发 pointerdown/pointerup/click 链(合成事件可以,但不准自己造 dispatch() 直接调回调)真点 ♪ 两次(开声→muted)与 #home 一次(导航函数调 1 次,进场期可点、按下态可见);以及 play() 返回 null 时本款循环状态不被标成已播。 真机验收(每款必做,合成事件不算):iOS Safari 与 Chrome Android 各一段录屏,页面加 ?snddebug=1 时右上角显示 state / ctx.state / 最近 start 的 cue 名 / attempt#;录:首按 ♪、第二按、快速连按两下、进场期点 Home、切后台再回来后首手势、loading 中点 ♪。录屏是交付物。

4. 过渡

以 fishshoot v2 的 director.ts 为底搬进 sound-state.ts;director.ts 旧 API(unmuteBlip/primeBlip/build/onCtxState/prepare/press)只保留转发适配层,一律委托新模块;以下旧行为废除(不是保留):build() 回前台自动 resume、prepare() 完成后补起 BGM、onCtxState() running 自动回 audible、FishSound.loopOn 把被丢弃的启动记成已播。API 要补齐 crash 的双层同步循环(syncWith)与动态混音(setParam)、fishshoot 的循环点,否则各款做不到「只换接线」。各款接线单在共用模块 Sol PASS 之后才派;接线单只准删本款自写状态机、换成模块调用。

P28 · 手机全屏 · Mobile full screen(Victor 2026-10-28 13:2x/13:3x 令,必备)FULLSCREEN

• iOS:直/横屏往上滑要能进全屏(Safari 收起网址栏/标签栏:页面可滚 ≥1px、scrollTo(0,1) 法),首次进场出提示卡「Swipe up for full screen / Geser ke atas」。
• Android:右上角一颗放大钮(.mg-fs-btn 44×44,图标=放大),点了 requestFullscreen;全屏中变成缩小钮。
• 唯一实作 common/fullscreen 的 mount()(含 P29 zoomLock + A2HS 提示),每款 app 入口挂一次,不自己写;页面根不准 position:fixed/overflow:hidden 把可滚高度锁死。
• 验收(量的):iPhone 模拟器 Safari 直屏载入 → 上滑 → window.innerHeight 增加(写前/后 px)且提示卡出现过一次,横屏同测;Android(Chrome 模拟或真机)放大钮可见、点后 document.fullscreenElement 非空;线上包 grep requestFullscreen、Swipe up for full screen、mg-fs-btn 各 ≥1。2026-10-28 线上扫描:crash/tower/wheel/catfish/plinko/kancilroad/fishshoot/komodo/mines/topo 有模块,dice、goalshoot 没有(待补)。

P29 · 禁缩放 · No zoom(Victor 2026-10-28 13:0x 问「double tap 有挡吗」→ 定为必备)ZOOMLOCK

• 双击放大、双指缩放一律挡掉;唯一实作 common/fullscreen 的 installZoomLock(随 P28 mount() 自动挂):viewport maximum-scale=1, user-scalable=no + html/body/root touch-action: manipulation + iOS gesturestart/gesturechange/gestureend 与双指 touchmove preventDefault + 300 ms 内第二下 tap 吞掉再补一个 click(连点仍算点击)。
• 验收(量的):线上包 grep gesturestart ≥1、manipulation ≥1;模拟器双击游戏区 3 次视口 scale 仍 1(截图尺寸不变)。

P30 · 演出逻辑关 · Animation causality gate(Victor 2026-10-28 11:5x 批、#1849 定)LOGIC

• 任何演出/结算动画:每个结果有看得见的原因、原因先于结果、没有东西无缘无故动/偏/变;放好的东西不动,除非外力。
• 上游:GDD 演出段必含四栏「演出因果表」(结果 | 原因 | 铺垫在第几步/帧可见 | 结果在第几步/帧);下游:落地录制过 bin/look-logic 盲述审(总监机跑)+ look-weird,两关都过才给 Victor。正本 (internal) 末节。

P31 · HAPUS 钮位置 · Clear-button placement(Victor 2026-10-29 02:4x 定,Croc Bite Duo 外横图)LAYOUT

• HAPUS(清除)圆钮贴最右:右缘与右侧难度卡 / PLAY 同一条右缘对齐;与上方难度卡底缘留 ≥12px(外屏)/ ≥16px(内屏)的间距;不得盖到难度卡、PLAY 或筹码。
• 直向(外直/内直)同理:HAPUS 右缘 = 面板右缘,与上一行元素留同样间距。全款适用;Duo 四态各截一张核。

开工规则(Victor 2026-10-28 13:3x):做任何新游戏,工单第一行写「照本 STANDARD P1–P31 全部做完」,不挑页;缺一页 = 不过。