# microwave **Repository Path**: Apoptoxin-4869/microwave ## Basic Information - **Project Name**: microwave - **Description**: 简单apk中老年人使用 - **Primary Language**: Android - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-26 - **Last Updated**: 2026-11-08 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 微波炉助手(安卓原生版) 一个给不识字老人用的微波炉引导 App。大图标、全程语音、步骤倒计时。 **配置从码云实时获取,改菜谱只改云端 `mwc.json`,App 不用重发版。** ## 架构 ``` MainActivity.kt ──► WebView 加载 assets/index.html(界面 + 步骤 + 倒计时) │ ├─ OkHttp 拉取码云 mwc.json(原生请求,不受浏览器 CORS 限制) │ └─ 成功 → evaluateJavascript 注入 window.refreshConfig(json) 实时刷新 │ ├─ assets/mwc.json 作为兜底(无网/首次也能用) │ └─ 语音:安卓原生 TextToSpeech,JSBridge 暴露为 window.AndroidTTS.speak(text, rate) └─ 念完回调 window.__ttsDone(),配合逐条朗读安全须知 ``` ## 在线配置地址(改这里即可换仓库) `app/src/main/java/com/example/microwave/MainActivity.kt` 中的: ```kotlin private const val CONFIG_URL = "https://raw.giteeusercontent.com/Apoptoxin-4869/myTvBox/raw/master/microwave/mwc.json" ``` > 原生 OkHttp 不受浏览器 CORS 限制,所以可以直接读 giteeusercontent 的 raw 地址。 > ⚠️ 路径要和仓库里 `mwc.json` 的实际位置一致(现在在 `microwave/` 目录下),否则会 404。 ## 数据包(mwc.json)与更新机制 页面**最底部正中**显示版本号(很淡的灰色小字,不干扰老人使用)。 ### 1. 首次安装:引导下载 装好后第一次打开,App 发现本地没有数据包 → 弹一张卡片「欢迎使用微波炉助手 / 第一次使用,需要先下载菜谱数据」→ 点「立即下载」开始下载;点「以后再说」则先用内置配置,下次启动不再反复弹。 ### 2. 下载完成后:缓存到本地 + 重启启用 - 原生 OkHttp 拉码云 `mwc.json`(不受 CORS 限制) - **校验结构**(必须有 `tasks` 且每个菜谱有 `title`/`steps`),坏数据不会覆盖好数据 - 校验通过才写入 `filesDir/config.json`(App 私有目录,卸载才清) - 页面显示「✅ 下载完成,正在重启…」→ 约 1.2 秒后**自动重启 App**,重启后直接启用本地包 - 失败(无网 / 404 / 格式错)→ 卡片里显示具体原因 + 「重试」按钮,原数据不受影响 ### 3. 每 7 天自动检查更新 启动时判断距上次检查是否满 7 天(`last_check_ms` 存 SharedPreferences): - 未满 7 天 → 不联网,纯离线使用 - 满 7 天 → 后台静默拉一次,**内容有变化才**弹「有新的菜谱数据」,没变化就不打扰 - 检查失败(无网)→ 不提示,下次启动再试 ### 4. 手动更新 **连续点击底部版本号 5 次**(每次间隔 1.2 秒内算连续)→ 弹「更新菜谱数据」卡片,随时可强制拉最新。 ### 加载优先级 ``` filesDir/config.json(本地数据包,优先,离线可用) ↓ 没有才用 assets/mwc.json(内置兜底) ``` > 不再每次启动都联网刷新——日常纯离线,只有「满 7 天」或「连点 5 次」才访问码云。 > 版本号定义在 `app/build.gradle` 的 `versionName`(当前 `1.7.18`),每次发版递增。 ## 编译出 APK(两种方式) ### 方式 A:Android Studio(推荐) 1. Android Studio → `Open` → 选择本 `MicrowaveApp` 目录。 2. 首次打开若提示 Gradle wrapper 缺失,按提示让 Studio 自动下载(Gradle 8.2 / AGP 8.2.2)。 3. 等 Gradle Sync 完成 → 菜单 `Build → Build Bundle(s)/APK(s) → Build APK(s)`。 4. 产物在 `app/build/outputs/apk/debug/app-debug.apk`,拷到手机安装即可。 ### 方式 B:命令行(已装 Android SDK 时) ```bash ./gradlew assembleDebug ``` ## 打 Release 包(已内置签名) 工程已内置签名 keystore:`app/release.p12`(PKCS12,alias=`release`,密码=`microwave123`,有效期 100 年), 由 `app/keystore.properties` 自动读取,`release` 构建类型会自动使用它签名。 命令行打 release 包: ```bash gradle assembleRelease ``` 产物:`app/build/outputs/apk/release/app-release.apk` Android Studio:`Build → Generate Signed Bundle/APK → APK`,选 `app/release.p12`,alias `release`,密码 `microwave123`。 > 密码是自用签名口令,请自行记牢。**保留 `release.p12` 与 `keystore.properties`**,换了新 keystore 才能覆盖升级。 > 如需更换签名,用 keytool 重新生成后改 `keystore.properties` 即可。 ## 改菜谱(不用改代码、不用重装) 编辑码云仓库里的 `mwc.json`(当前在 `myTvBox/microwave/mwc.json`),提交后 App 下次启动/重进即拉取最新; 或按上面的「连点版本号 5 次」手动更新并重启。字段: | 字段 | 说明 | |---|---| | `appName` | 左上角标题文字(想叫什么都行) | | `appIcon` | 左上角图标:emoji(如 `📡`、`🍲`、`🍳`),也可以填图片地址(`https://...` 或 `assets/xxx.png`) | | `voice.rate` | 语速,老人建议 0.85 | | `safety[]` | 安全须知(点「安全须知」按顺序逐条念) | | `tasks[].title` / `emoji` / `color` | 菜名 / 大图标 / 按钮底色 | | `tasks[].steps[].say` | 这一步念出来的话 | | `tasks[].steps[].power` | 火候(高火/中火/解冻) | | `tasks[].steps[].minutes` / `seconds` | 加热时长(自动倒计时) | | `tasks[].finish` | 做完后的叮嘱 | `assets/mwc.json` 是内置兜底配置,与云端结构一致;云端拉不到时用它。 ### 底部 tab 与播报词(`nav.json`) 底部那几个 tab 的名字、图标、指向哪份 JSON 全在 `nav.json` 的 `tabs[]` 里: | 字段 | 说明 | |---|---| | `name` | 底部显示的字(如「米家」) | | `icon` | 底部图标(emoji) | | `say` | **点到这个 tab 时念出来的话**;不填就念 `name` | | `src` / `fallback` | 这个 tab 的内容从哪个地址下载 / 离线时用包里哪份 | > 以前「米家」那一格的 `say` 写的是「更多」,点了却念「更多」,跟底部字对不上。 > 现在已经改成「米家」;即使云端还是旧配置(`say` 为「更多」),App 也会按 tab 名念。 ### 底部悬浮玻璃 tab 的实现要点(`NativeTabBar.kt`) - **玻璃底**:`PixelCopy` 截底部栏正上方那一条画面 → 降采样 → 两次盒式模糊 → 贴成背景, 不依赖 RenderEffect / AGSL,Android 8 以上机型都能用;Android 8 以下自动退回 HTML 版 tab。 **默认关闭**(`MainActivity.kt` 的 `KEY_NATIVE_TAB` 默认 `false`),装好先用网页版玻璃 tab; 在配置中心点「开启」并重启后,才会换成这套原生磨砂玻璃。 - **选中胶囊**:一层上亮下暗的白玻璃渐变 + 顶部弧形高光 + 一圈 1.2dp 细边,宽度恒等于一格。 早期版本把「背后画面按倍率放大后画进胶囊」当放大镜,结果页面上的大标题被糊进胶囊、还盖掉图标文字, 已废弃。 - **放大效果**:做在 tab 自己身上 —— 选中的图标 1.26 倍、文字 1.08 倍,带轻微过冲的弹性动画, 未选中的图标半透明;长按拖动 / 松手时**整条栏保持稳定不再整体放大**,只有滑块(指示器)随手指滑动、选中项自身放大。 - **层级**:图标文字所在行 `elevation = 6dp`,永远压在胶囊之上(胶囊给过 elevation 就会盖住文字)。 ## 顶部喇叭:静音开关 左上角标题(`appName` + `appIcon`)右侧有一个圆形喇叭按钮: - **🔊 绿色** = 会朗读;**🔇 灰色** = 已静音,步骤、安全须知、时间到提醒全部不出声 - 点一下切换,屏幕中上会弹出悬浮提示(「已静音,不会再念了」/「已开启语音」),约 1.8 秒自动消失 - 静音状态存在手机本地,**关掉 App 再打开仍然是静音** - 静音时点到任何该出声的地方(底部 tab、菜谱步骤、再听、米家卡片、安全须知、下一步/上一步), 页面底部会弹一条「现在是静音,听不到声音」的提示条,**右边自带一个「🔊 打开声音」按钮**: 点一下就直接开声音,并把刚才想听的那句话补念出来,不用再跑回主页找喇叭 (同时主页右上角的喇叭按钮会闪两下,方便记住入口在哪) ## 语音没声音怎么排查(重要) App 里已经做了自检,语音出问题会在页面底部弹一条红条直接说明原因,不用连电脑看日志: | 屏幕提示 | 含义 | 怎么办 | |---|---|---| | 这台手机没有语音合成引擎 | ROM 把 TTS 精简掉了 | 应用商店装「语音合成 / TTS」,或在「设置 → 语音合成」里装一个引擎 | | 语音引擎初始化失败 | 有引擎但起不来 / 默认引擎坏了 | 点提示条上的「去设置」,在语音合成里换一个引擎 | | 本机没有中文语音包 | 引擎能用,但没下中文数据 | 「设置 → 语音合成 → 安装语音数据」里下中文 | **踩过的坑**:`AndroidManifest.xml` 里的 `` 声明是**必须**的。 ```xml ``` Android 11(API 30)起有「软件包可见性」限制,本工程 `targetSdk = 34`, 不声明这段就查不到系统 TTS 引擎,`TextToSpeech` 初始化直接返回 `-1`, 表现就是**能装能用但完全没声音**。删掉这段语音必然失效,别动它。 另外代码里还做了这些兜底: - 引擎未就绪时的朗读请求先入队,就绪后补念(否则开机第一次点菜名会没声) - 默认引擎初始化失败时,自动枚举本机引擎并换一个重试 - `setSpeechRate` 每次朗读前都设置(只设一次会不生效) - 朗读出错也会回调页面,避免「安全须知」逐条朗读卡在第一条 连电脑排查时:`adb logcat | grep MicrowaveTTS`,关键日志包括 `setLanguage(...) -> 结果码`、`speak[rate=...] result=...`、`TTS 初始化失败 status=...,本机引擎=[...]`。 ## 备注 - 最低支持 Android 5.0(minSdk 21),老机也能装。 - 语音依赖系统中文 TTS;个别老机若无中文语音包,需在「设置 → 语音合成」里下载中文。 - 应用图标由 Pillow 绘制的微波炉图形生成(mipmap 五档密度)。 ## 版本记录 ### v1.7.24(2026-10-28) - **修复页面闪屏**:闪屏有三个成因,这次一并解决。 1. **背景光斑不再持续漂移**:原来 5 个柔焦光斑一直在缓慢漂移(24~35 秒才走 36~48px,约 2.8px/s,肉眼基本看不出),但它会让底下十几块 `backdrop-filter` 玻璃层**每帧重新采样背景、重算模糊**,GPU 被打满 → 画面闪烁、滚动掉帧。背景固定后,玻璃层可以复用同一张背景快照,不闪了,也更省电。 2. **滚动时不再整页"关模糊变实色"**:v1.7.22 的滚动优化是把 `backdrop-filter` 直接设成 `none`,滚动一开始整页玻璃瞬间变实色(液态玻璃的饱和度/亮度一掉、照片背景一清晰),视觉上就是"滚一下闪一下"。现在改成**把模糊半径临时压到 25%**——观感只是"化开一点",不再整页突变;卷积半径只剩 1/4,滤镜开销大幅下降(保住流畅度收益);模糊仍在,照片背景不会露出锐利边缘。高速模糊版本来就只有一层 blur,滚动时保持满强度毛玻璃不变。 3. **原生玻璃底栏抓屏轮询放宽**:背景不再漂移后,原生侧每 480ms 追着光斑重截玻璃已无必要,放宽到 1s,减少 `PixelCopy` 抓屏引起的窗口重绘。 - 顺带清理了被覆盖的死规则(旧的 3 类 `glass-fast.is-scrolling` 规则)和 `prefers-reduced-motion` 里已无意义的 `.blob { animation: none }`。 - 无头 Chromium 实测:静止 / 滚动两组下,16 类玻璃元素的 `backdrop-filter` **全程没有出现过 `none` 硬切**——普通版 `blur(22px)→blur(5.5px)`,高速模糊版保持 `blur(22px)`,液态玻璃版滚动时丢掉 saturate/brightness 只留 `blur(5.5px)`;背景光斑 `animation-name` 已为 `none`。 ### v1.7.23(2026-10-28) - **模糊度调节入口改为「配置驱动」,不再写死在列表里**:`tab-quick.json` 里原本就有一条 `"模糊度设置"`(`action.type: "blur"`),但 `runAction` 没有 `blur` 类型处理器,点了没反应,之前只能在 `buildBgSection()` 里另写死一条 `bgRow('🌫️','模糊度调节',...)` 兜底。现已给 `runAction` 补上 `blur` 分支(打开模糊度弹窗),并删掉 `buildBgSection` 里那条写死的行——快捷操作页的模糊度入口现在完全由 `tab-quick.json` 决定(图标 / 标题 / 副标题都可云端改),不再有重复入口。 - `tab-quick.json` 里这条已对齐成「🌫️ 模糊度调节 / 背景·卡片·底栏清晰度」,作为唯一来源。 - 无头 Chromium 实测:`runAction({type:'blur'})` 能打开并关闭弹窗;`buildBgSection()` 不再含模糊度行;JSON 驱动的列表恰好渲染出 1 条 `data-act="blur"` 行。 ### v1.7.22(2026-10-28) - **流畅度优化(修 v1.7.19~1.7.21 引入的滚动掉帧)**:滚动流畅度优化规则原本只关掉 `.quick-row / .mj-card / .g` 三类玻璃的 `backdrop-filter`,而后续新增的按钮、步骤卡、安全项、底栏等玻璃元素没进关闭名单——默认普通版下滚动时它们每帧重算模糊,明显掉帧。现已把**全部 16 类玻璃元素**纳入滚动关闭名单(`is-scrolling` 期间统一 `backdrop-filter: none`,停下 160ms 再恢复),滚动只剩内容合成,掉帧消除;「高速模糊版」的滚动保持毛玻璃名单也同步补齐。 - **原生底栏截图节流放宽**:滚动中通知原生重截玻璃底栏的节流从 ~10fps(100ms)放宽到 ~6fps(160ms),减少 `PixelCopy` 回读对滚动 GPU 管线的争抢;停下后的 trailing 补截 + 480ms 低频轮询负责把玻璃补清晰,观感不变。 - 无头 Chromium 实测:静止时 16 类元素全部 blur 生效;`is-scrolling` 期间全部变 `none`;停止后恢复。 ### v1.7.21(2026-10-28) - **新增「操作按钮模糊度」滑条**:模糊度调节面板里补齐第五类——所有交互操作按钮的玻璃模糊统一由一个滑条控制,不再散落在「卡片 / 内容卡片」里、或干脆固定不可调。 - **覆盖范围**:菜谱里的圆形任务按钮 `.task-btn`、步骤页「开始 / 暂停 / 下一步」大按钮 `.big-btn`、完成页的圆形按钮 `.done-circle` 与完成按钮 `.done-btn`,以及顶栏的喇叭 `.mute-btn`、安全 `.safe-btn`、返回 `.back-btn`——全部从各自的 `--card-blur-px` / `--content-blur-px` 或固定的 `var(--blur)` 改挂到新的 `--btn-blur-px`(默认 12px)。 - **顶栏三个按钮现在也能调了**:之前它们硬写 `var(--blur)`(固定 22px、普通版下还是 `none`),等于不受任何滑条控制;现在随「操作按钮模糊度」实时可调,普通版下也能模糊。 - 存本机 `localStorage` 的 `mw_btnblur`,刷新 / 重启后还在。 ### v1.7.20(2026-10-28) - **修:普通版(默认档位)下「模糊度调节」滑条无效**:普通版以前把卡片 / 内容模糊半径硬写成 `0px`,等于把滑条关掉,所以默认进 App 拖模糊度没反应。现已放开——普通版只是不做颜色增强(saturate/brightness),模糊半径照样能调,依然最省电(卡片背景改回半透明渐变以透出毛玻璃)。 - **步骤页卡片改挂「卡片模糊度」**:步骤页的圆形玻璃图标、文字卡、计时卡,从「内容卡片模糊度」改到「卡片模糊度」滑条统一控制(安全须知 / 完成页等其它教程卡仍走内容卡片模糊度)。 ### v1.7.19(2026-10-28) - **「模糊度调节」独立入口**:在「快捷操作」页新增一行「🌫️ 模糊度调节」(背景·卡片·底栏清晰度),点开弹出一个调节面板。 - **四类磨砂强度各自独立可调**:面板里有四条滑条—— - **背景模糊度**(0–16):照片背景的柔焦,只换过照片时生效(原放在「配置中心 → 画面效果」下面,现挪到此处); - **卡片模糊度**(0–40):菜谱 / 快捷 / 米家等页面卡片,**以及步骤页的圆形玻璃图标、文字卡、计时卡**的玻璃模糊,调到 0 就是清爽实色; - **内容卡片模糊度**(0–40):安全须知 / 完成页等其他教程卡片的玻璃模糊; - **底栏模糊度**(0–40):底部玻璃导航条的磨砂强度(玻璃底部栏开启时生效,实时改不用重启)。 - **和「画面效果」三档解耦,且全档位都能调**:画面效果仍管「普通版 / 高速模糊版 / 液态玻璃版」的配色与是否做 vibrancy; 模糊半径改由上面的滑条单独微调。**普通版以前把模糊半径硬写成 0(等于关掉),现已放开**——普通版只是不做颜色增强(saturate/brightness),但模糊半径照样能调,依然最省电。 - 四条滑条全部存本机(`localStorage` 的 `mw_cardblur` / `mw_contentblur` / `mw_tabblur` + 原有的 `mw_bgfx`),刷新 / 重启后都还在;底栏模糊度透桥 `AndroidApp.setTabBlur`,由原生实时改 `PixelCopy` 模糊半径。 ### v1.7.18(2026-10-28) - **背景模糊度滑条挪到「配置中心 → 画面效果」下面**:不再放在快捷操作页的换背景区里, 跟三个玻璃档位(三列)排在同一块,滑条在最下方。 - **背景模糊度默认 4**:换过照片背景后照片默认带一点柔焦,不抢卡片上的字;调到 0 就是原图。 - **背景透明度固定 100,滑条移除**:照片背景不再能调半透明,这条滑条整条去掉 (老版本存过透明度的,升级后会自动恢复成不透明)。 ### v1.7.17(2026-10-28) - **页面内左右滑动可以切换 tab 了**:在首页(微波炉 / 米家 / 快捷操作)里手指左右滑一下,松手就切到相邻的页面, 和点底部 tab 一样会念出那一页的名字;原生玻璃底栏开着的时候,底栏指示器也跟着走。 - **防误触**:横向位移要达到 **90px** 才算切换(占屏宽约四分之一),而且必须明显大于纵向位移—— 上下滑动看菜谱不会误触;到头的那一页(第一页右滑 / 末页左滑)也不切。 - 滑完之后浏览器补发的那一下 click 会被挡掉,避免用力一划就误进菜谱;正常点击不受影响。 - 滑条、下拉框这类控件不参与手势,拖它们的时候不会误切页面。 ### v1.7.16(2026-10-28) - **快捷操作页的「更换背景图片」新增两条滑条**:在「换成我的照片」下面多了一个「🎚️ 背景调节」区块, - **背景模糊度**:0–16,照片越糊背景越柔(同时会轻微放大盖住模糊化开的边缘); - **背景透明度**:30%–100%,照片越透明越透出底色。 - 拖动即时生效,数值存在本机(`localStorage` 的 `mw_bgfx`),重启后还在。 - 两条滑条**只对照片背景生效**:没设照片时置灰并提示「先选一张照片,就能调模糊和透明度」; 换成纯色或点「恢复默认背景」时,滑条一并复位。 - 换背景后通知原生玻璃底栏重新截图的逻辑改成**防抖**,拖滑条时不会一路狂截。 ### v1.7.15(2026-10-28) - **画面效果在配置中心里换了位置**:从列表顶部挪到「快捷操作 · 内容」之后、「玻璃底部栏(磨砂玻璃)」之前,夹在这两行中间。 - **三个档位改成并排一行三列**(普通版 / 高速模糊版 / 液态玻璃版),不再是一条一条往下排;当前生效的那一档高亮并打勾。选完立刻生效,说明文字(当前档位 + 影响范围)挪到三个选项**下方**。 - **画面效果默认「普通版」**:App 初始化时不再用 `nav.json` 下发的 `glassMode`(云端那份可能是旧值,会把默认档带偏),固定用最省电、最流畅的普通版;老人在配置中心改过之后以本机选择为准。 - **玻璃底部栏默认关闭**:原生磨砂玻璃 tab 栏默认不启用(`MainActivity.kt` 里 `KEY_NATIVE_TAB` 默认值改为 `false`),先走网页版玻璃 tab,老机器更稳。想开可在配置中心点「开启」,重启后生效。 ### v1.7.14(2026-10-28) - **画面效果移入配置中心**:原在「快捷操作」页底部「换背景」区块里的「画面效果(页面玻璃三档:普通 / 高速模糊 / 液态玻璃)」入口,移动到「更新配置」打开的配置中心弹窗内,与下载配置并列展示;样式与弹窗内其它项一致(当前生效项打勾,选完即时生效)。同步清理了原 glassOverlay / openGlassPicker 等死代码。 - **底部 tab 栏滑动不再跳动**:去掉了底部 tab 栏在按下 / 长按拖动 / 松手时的整体缩放与回弹动画(`NativeTabBar.kt` 的整栏 scale 弹簧、`index.html` 的 `.press/.drag/.snap/.tap` 关键帧)。滑动时整条栏保持稳定,只保留滑块(指示器)滑动与选中项自身放大。 - **去除卡片周期扫光**:删掉了菜谱卡片上每隔约 9 秒扫过一道斜向高光的「湿润光泽」(`.task-btn::after` 的 sheen 动画 + `@keyframes sheen`),卡片本体样式不变。