Mineradio 2.2.0 更新指南沉浸式音乐播放器的登录修复、换源稳定与手势操控【免费下载链接】Mineradio-paused一款以电影镜头、粒子视觉和歌词舞台为核心的沉浸式音乐播放器。项目地址: https://gitcode.com/gh_mirrors/mi/Mineradio-pausedMineradio 2.2.0 是这款沉浸式音乐播放器的历史稳定版登录态不再悄悄失效、播放中断会尝试自动换源、搜索分页按平台各自续载还带来 4 款高级粒子预设与摄像头手势控制。本文带你看懂这次版本的下载校验、功能更新与装完自检。更新速览改动改动前你能感知到的变化下载入口更换旧网盘收藏已失效夸克/百度云新线路装前可核对 SHA-256登录与账号识别登录态悄悄过期后播歌直接失败且原因不明登录、会员、网络问题分别给出不同指引播放稳定性主接口挂了就没声音没有下文备用域名重试无源时自动换源或降音质重试搜索分页任一平台翻到底整个列表就停各平台游标独立推进加载更多持续可用断网恢复重启后队列和进度全丢快照还原上一轮的歌单与播放位置预设与手势视觉只有固定档位操作全靠鼠标4 款高级预设置顶摄像头可切歌、暂停、调音量先拿到新版本从 发布说明 与 README 登记的网盘入口下载Mineradio-2.2.0-Setup.exe百度云提取码SJHP并更新你的旧收藏——旧地址不再作为本版入口。下载完成后在 PowerShell 里核对一次指纹Get-FileHash .\Mineradio-2.2.0-Setup.exe -Algorithm SHA256输出应为8fd318283bab2fe98190f7b879ede423dd8274a0aeec8d321570b8d022d4f989。直接运行安装包即可覆盖旧版它会自动创建桌面快捷方式.blockmap、latest.yml、win-unpacked都不是安装包latest.yml只是更新检测用的元数据见 更新交付文档。浏览器或 SmartScreen 拦截时选保留 / 仍要运行若杀毒软件明确报木马删掉文件从官方入口重下别强行运行。旧客户端没弹出更新箭头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为 640msquick最灵敏。装完后的自检清单用 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考