Mineradio 2.2.0 更新指南：沉浸式音乐播放器的登录修复、换源稳定与手势操控

Mineradio 2.2.0 更新指南：沉浸式音乐播放器的登录修复、换源稳定与手势操控

【免费下载链接】Mineradio-paused一款以电影镜头、粒子视觉和歌词舞台为核心的沉浸式音乐播放器。项目地址: https://gitcode.com/gh_mirrors/mi/Mineradio-paused

Mineradio 2.2.0 是这款沉浸式音乐播放器的历史稳定版：登录态不再悄悄失效、播放中断会尝试自动换源、搜索分页按平台各自续载，还带来 4 款高级粒子预设与摄像头手势控制。本文带你看懂这次版本的下载校验、功能更新与装完自检。

更新速览

先拿到新版本

1. 从 发布说明 与 README 登记的网盘入口下载Mineradio-2.2.0-Setup.exe（百度云提取码SJHP），并更新你的旧收藏——旧地址不再作为本版入口。

2. 下载完成后在 PowerShell 里核对一次指纹：

   Get-FileHash .\Mineradio-2.2.0-Setup.exe -Algorithm SHA256

   输出应为8fd318283bab2fe98190f7b879ede423dd8274a0aeec8d321570b8d022d4f989。

3. 直接运行安装包即可覆盖旧版，它会自动创建桌面快捷方式；.blockmap、latest.yml、win-unpacked都不是安装包（latest.yml只是更新检测用的元数据，见 更新交付文档）。

4. 浏览器或 SmartScreen 拦截时选"保留 / 仍要运行"；若杀毒软件明确报木马，删掉文件从官方入口重下，别强行运行。

5. 旧客户端没弹出更新箭头？2.1.0 在启动约 9 秒后只检查一次且失败不重试。从托盘彻底退出重开、切回普通窗口、等约 30 秒再看右上角；没有就按上面直接装。

功能深读

🔐 登录态悄悄失效？先分清是登录、会员还是网络的事

痛点：酷狗 Cookie 过期或 token 字段名一变，登录态就无声丢失，播放请求直接报错，你分不清该去登录还是开会员。

机制：kugou-api.js 把 Cookie 拆成键值对后，从多种可能的键名里取userid和token，两者齐全才算"可播放"：

const playbackReady = !!(userid && userid !== '0' && token);

取播放地址失败时，原始报错会被正则归类：命中"登录/token/会话/凭证"归为login_required；未命中时若登录态就绪则归为vip_required，否则同样按登录问题处理。

感知：提示从此分流——重新打开官方登录窗口、提示会员/付费权限、或提示换源，不再是一句笼统的"播放失败"。确认方式：登录后分别播一首普通歌和一首会员歌，观察两类提示文案是否如上述分流。

📡 播放断了：备用域名接住请求，换源兜住版权

痛点：主接口抽风或被版权、地区限制卡住时，播放直接中断，没有任何补救。

机制：接口层在wwwapi.kugou.com主线路之外定义了wwwapiretry.kugou.com/play/songinfo重试线路，主请求失败后带着签名重发。源层则由 11-provider-fallback.js 统一接住"没有可播放地址"的场景：按版权、会员、付费、网络等类别给出对应文案与动作（升级权限 / 自动换源），QQ 音乐路径还会把失败音质从候选池剔除后用兼容音质重试，并保留断点位置。

感知：版权受限的歌会看到"正在自动换源"之类的 toast 并尝试其它平台版本；换源成功后从原位置附近继续。确认方式：播一首当前平台不可用的歌，留意是否自动切源并出现对应提示。

搜歌翻不动了？每个平台都有自己的翻页进度

痛点：以前只要某个平台的结果翻完，整个搜索结果就停住，想找下一批只能换个关键词重来。

机制：07-search.js 为每个平台在providerPages里维护独立游标与单页上限（网易云 18 条，QQ/酷狗/汽水 12 条，Spotify 10 条），翻页是否结束按这条规则判定：

var hasMore = value.hasMore === true; if (value.hasMore == null) hasMore = songs.length >= requestedLimit; if (!songs.length || nextOffset <= offset) hasMore = false;

聚合层只在所有平台都结束时才关闭"加载更多"；某平台拉取失败则标记failed: true，不拖垮其它平台。

感知：一个平台没货了，列表仍在滚动，直到全部平台见底。确认方式：搜一个热门关键词连续点加载更多，观察中途某个平台停止后列表是否还在前进。

断网之后怎么接着听

痛点：断电或网络中断后再打开软件，上一轮的歌单和播到一半的进度全得重新找。

机制：09-queue-snapshot-autoplay.js 会持续持久化最近一次播放快照（当前歌、队列、索引、进度）。启动时readLastPlaybackSnapshot读回快照，先还原自定义封面等对象引用，再算出恢复点写入pendingPlaybackResumeAt；即便实际恢复失败，也会先把 UI 进度条摆回快照位置，让你看到"上次播到这里"。

感知：重开后队列与进度指针都停在上次附近。确认方式：播一首歌到两三分钟处退出软件再启动，进度条应停在原位置附近而非 0。

✋ 粒子和手势：4 款高级预设，摄像头也能切歌

痛点：视觉只有写死的几个固定档位，想调好一套参数也存不下来；操控方式则完全依赖鼠标。

机制分两层。视觉侧，00-preset-archive-data.js 共 13 款预设：免费档覆盖封面粒子、滚筒隧道、星球、唱片、星河等；4 款高级档（月蚀圣环、雨幕霓虹、折光蝶群、深海绽放）带独立强调色并排在面板最前排。参数不再一次性的——用户可保存多份本地存档，导出分享码以MR2前缀开头并带校验；旧存档里"虚空"档若 schema 对不上会自动落到"星河"，避免白屏。

操控侧，00-gesture-control.js 基于 MediaPipe Hands 的 21 个手部关键点，把摄像头画面同时映射成两套动作：

• 视觉类：手掌悬停推开粒子、捏合拖动旋转封面并保留惯性、握拳触发粒子爆发收束；
• 控制类：V 手势播放/暂停、拇指上翘点赞/取消、三指显隐歌词、单指保持后移动调音量、张开手掌左右快滑切歌。

每套动作都有保持时长与冷却防抖，推理频率随性能档位限流（高画质档约 42ms 一帧，低档 72ms）；窗口隐藏、弹框打开或输入框聚焦时，播放器手势自动暂停，只留粒子交互。

感知：Fx 面板顶部出现 4 款新预设，点选即生效并带专属配色；开启摄像头手势后，V 手势真的能暂停音乐。确认方式：在普通窗口下开启手势功能，对着摄像头比出 V 和捏合各一次；再打开 Fx 面板核对高级预设顺序。嫌误触多，就把灵敏度切到steady档（触发需保持约 820ms，默认balanced为 640ms，quick最灵敏）。

装完后的自检清单

• 用 SHA-256 摘要核对安装包与发布值一致
• 播放一首普通歌与一首会员歌，确认提示分别是"可播"与"会员/付费权限"两类文案
• 搜索热门关键词连续加载更多，确认某平台翻完后列表仍继续
• 播放到中途退出并重启，确认队列与进度条恢复到上次附近
• 播一首版权受限的歌，观察是否出现"正在自动换源"提示
• 打开 Fx 面板，确认 4 款高级预设位于前排并各带强调色
• 开启摄像头手势，测试 V 手势暂停与捏合旋转，并把灵敏度调到顺手档位

Mineradio 目前处于长期停更状态，2.2.0 即仓库保留的稳定版本，后续变更请以仓库实际代码为准。 更多细节见 发布说明、更新机制 与 README；相关实现集中在 kugou-api.js 与 public/js/modules/05-playback/ 目录。

【免费下载链接】Mineradio-paused一款以电影镜头、粒子视觉和歌词舞台为核心的沉浸式音乐播放器。项目地址: https://gitcode.com/gh_mirrors/mi/Mineradio-paused