🚀 快速上手:界面视觉密码与极客手势地图

欢迎使用 JuJu音乐 (JuJu Music)!这是一款专为极客与音乐发烧友打造的赛博朋克风格本地与私有云音乐播放器。

本文档将为你揭秘 App 中最核心的视觉指示器暗语、隐藏手势与高效操作,让你在 3 分钟内成为资深玩家。


🔍 一、读懂 App 的“视觉呼吸”:状态指示器暗语

JuJu音乐的界面元素融入了大量动态状态感知,无需繁琐的弹窗,界面自身就会“说话”:

界面元素 状态表现 隐藏含义 / 背后逻辑
顶部设置齿轮 ⚙️ 霓虹粉 + 匀速旋转 App 冷启动或手动刷新音乐库时,说明后台有异步任务正在运行(全盘扫描音频、云盘同步比对、音频标签写入等);赛博青且静止则代表空闲就绪。
工具箱图标 🔧(App 内为单色矢量图标,🔧 仅为文档代指) 霓虹粉 vs 赛博青 跟随语音助手状态:语音助手已开启(后台监听中)为霓虹粉,未开启为赛博青。注意这与 EQ、睡眠定时器无关。
播放界面 · 歌曲信息按钮 霓虹粉 vs 赛博青 同上,同样跟随语音助手的开启状态,与主界面工具箱图标联动。
黑胶唱片中心数字 数字值 + 数字颜色 数字就是用户的声能成长等级(0 ~ 7),随听歌量动态晋升:0 初启航 → 1 漫游者 → 2 调频师 → 3 引航员 → 4 声能家 → 5 聚变大师 → 6 赛博宗师 → 7 巅峰共鸣。完整进度与活力值在 Pro(含试用期)下见工具箱「用户等级与活力值」仪表盘;免费版工具箱只给一行入口,点开同样能看等级说明(等级与活力值对免费用户照常统计,升级后即刻点亮)。
这个数字的颜色指示有无歌词:赛博青=当前歌曲有歌词(内嵌或独立 .lrc 文件均可滚动),霓虹粉=无歌词。
注意区分:数字外圈那圈轴心圆环固定为赛博青,不随歌词状态变化,变色的是数字本身。
歌词界面 · 当前歌词行颜色 赛博青 vs 霓虹粉 赛博青:歌词来自音频文件内嵌;霓虹粉:歌词来自独立 .lrc 文件。一眼看出歌词来源,便于判断该改文件还是该换源。
标题动态流光 霓虹粉占比 + 流动速度 顶部 JuJu Music 标题中霓虹粉所占的比例实时映射你近 3 天的听歌活力值 (Vitality),速度同步反映活跃变化。此流光为 Pro(含试用期)专享;免费版保持经典纯青标题,但活力值仍在后台正常累计。

⚡ 二、隐藏极客手势:无需寻找按钮的盲操体验

为了追求极简沉浸的听歌体验,许多高频操作均可通过直觉手势直接触发:

1. 唱盘与全屏歌词瞬间切换

  • 双指双击任意空白区域:在播放详情页,使用双指同时双击屏幕,可在「动感黑胶唱盘」与「高发光全屏沉浸歌词」之间瞬间切换。
  • 从左往右滑动:在歌词界面,从屏幕左侧向右轻滑,即可平滑返回黑胶唱片主封面。
  • 点击顶部大标题:单击顶部 JuJu Music 标题,亦可快速切换唱盘与歌词。

2. 歌词时间轴精准定位

  • 双击任意歌词行:在滚动歌词界面中,双击任意一句歌词,播放进度将毫秒级精准 Seek 跳转至该句歌词的起始时间点。

3. 大标题双击快捷通道:手动唤醒

  • 双击标题(整条):双击顶部 JuJu Music 标题的任意位置即可手动唤醒语音助手,App 立即进入聆听与录音状态 —— 无论常驻唤醒是否已开启都能唤醒。
  • 常驻唤醒的开关只在工具箱:工具箱 →「AI 功能」→「启用语音唤醒」;开启时会提示耗电与误唤醒。

标题已不再区分左右半区(右半区的常驻开关手势已移除),避免误触把常驻服务关掉。


🎵 三、智能歌词打分与排序引擎

JuJu音乐聚合了各大音乐平台的在线歌词库,并首创了多维加权智能匹配打分引擎:

  1. 智能评分算法 (满分 100 分):
    • 歌名契合度 (45分):自动过滤 (Live)、[伴奏]、(Remix) 等修饰词噪声;
    • 歌手契合度 (30分):智能识别多歌手合唱与中英文别名;
    • 时长精准加权 (25分):与本地音频时长误差 <1s 给予满分,误差大则降权。
  2. 彩色匹配 Badge 徽章:
    • 在歌词候选列表中,系统会按匹配度从高到低自动排序,并在条目右侧展示 98% 匹配 等彩色徽章及歌曲时长对比。
  3. 手动换源:
    • 若自动匹配的歌词有偏差,长按播放页或在歌曲操作菜单中点击「重新匹配歌词」,即可自由挑选最契合的平台版本。

🎛️ 四、专业赛博 EQ 均衡器与防音爆保护

在工具箱中点击「音效与均衡器」可呼出专业音频调节面板:

  • 流派自适应预设:内置流行、摇滚、爵士、古典、重低音、人声增强等多种专业预设,并支持根据歌曲流派自动匹配切换。
  • 回放增益 (ReplayGain):全曲库统一标准响度基准(-3.0dB),彻底解决切歌时“忽大忽小”的听觉痛点。
  • Smart Peak Guard 防破音:即使在低频重度增益下,内置的动态限幅器也会实时压制音频削顶失真,保护耳机与音响。

🔍 五、曲库分类与实时过滤搜索

  • 多级精准分类:支持按 全部歌曲、歌手、专辑、流派、文件夹 快速浏览。
  • 即时过滤搜索框:在分类列表底部内置常驻搜索栏,输入关键词即时过滤;匹配范围是歌曲名、歌手名与文件名(大小写不敏感的子串匹配)。
  • 默认扫描目录:首次安装后默认扫描本地存储的 Music 与 Download/JuJuDownload(云盘下载根目录,含在线播放缓存子目录 JuJuCache),P2P 接收目录 Download/JuJuReceived 也会自动纳入;其他目录需在 设置 →「本地存储」→「添加文件夹」中手动添加。
  • 曲目批量操作:在各歌手、专辑行点击加号 (+),可一键将该分类下的所有歌曲批量加入当前播放队列或指定歌单。

🔧 六、工具箱与系统设置速查

1. 工具箱入口一览

点击主界面右上角的工具箱图标 🔧(36dp 尺寸,颜色参见上文语音助手状态)展开:

入口 用途
用户等级与活力值 查看声能成长等级、近 3 天活力值、累计听歌量与成长进度(Pro 含试用期;免费版这一行是入口提示,点开可看等级说明)
接收歌曲分享 输入 6 位提取码,接收他人通过 P2P 分享的歌曲
云盘目录同步 管理云盘与本地目录之间的单向 / 双向增量同步任务
云盘在线播放 直接浏览云盘目录,点歌即播,无需下载(Pro 含试用期)
云盘歌曲下载 把云盘歌曲下载到本机目录,离线也能听(Pro 含试用期)
音效与均衡器 EQ 预设、ReplayGain 增益、Smart Peak Guard 防破音
歌曲排序 切换排序字段与升 / 降序
AI 功能 语音助手总开关、语音指令解析所用的大模型(点「配置」进 AI 配置页)、AI 文本标签补全、AI 封面补全
首页语录 自定义首页顶栏滚动的那句语录

三个云盘入口在工具箱里都带「云盘」前缀(原先「在线播放 / 歌曲下载」藏在「系统设置 → 云盘存储」页 底部,很难被找到);云盘存储页底部那三颗按钮仍在,进入的是同一套流程, 且那页不必再重复「云盘」二字,标题就是「目录同步 / 在线播放 / 歌曲下载」。

2. 系统设置里值得知道的几项

  • 本地存储:默认扫描 Music 与 Download/JuJuDownload(含在线播放缓存 JuJuCache),并自动纳入 P2P 接收目录 Download/JuJuReceived;其余目录需手动添加。
  • 云盘挂载:支持 FTP / FTPS、Samba (SMB/CIFS)、SFTP、WebDAV、Subsonic / Navidrome(只读,只能云端 → 本地)、S3(MinIO / Ceph / R2 / B2 / COS / OSS 等)、阿里云盘(添加表单里就是按这个顺序排的); 支持把云盘歌曲缓存到本地设备,也支持云盘与本地文件夹的单向或双向同步。
    • 端口怎么填:WebDAV / Subsonic / S3 的端口写在地址里(如 http://192.168.1.10:5005),所以表单里没有单独的端口框; FTP / SFTP / SMB 的地址是纯主机名 / IP,才有独立端口框(默认 21 / 22 / 445,一般留空)。
  • AI 配置:填入大模型 API 密钥后,可用于语音助手的语音识别、语音指令解析,以及 AI 歌曲标签补全。
  • 「下载」分类里每行只有一个垃圾桶图标,不会两个并排:🧹「清空目录内容」只出现在默认缓存目录 JuJuCache(它是云盘在线播放的边听边存目录、不能删除,要回收空间只有清空这条路); 自定义下载目录给的是 🗑「删除下载目录」——连目录一起删,想留名字就再新建一个同名的。 两者都会先弹确认。

📦 七、支持的格式与限制

当前支持 21 种主流音频后缀:MP3、FLAC(含 32-bit)、WAV、AAC、M4A(含 ALAC)、OGG、OGA、OPUS、APE、DSF、MKA、M4B、AIFF/AIF/AIFC、WavPack(.wv,含 DSD)、TTA、TAK、Musepack SV8(.mpc)、DFF、WMA。

同一后缀不等于同一编码,以下边界需要知道(筛选弹窗里的 ①②③④ 就是它们):

  • WMA:支持 7/8/9 标准版、WMA Pro、WMA Lossless;不支持 DRM 加密与 WMA Voice,且受采样率 / 声道 / 位深能力表限制。
  • MPC:仅支持 SV8,不含 SV7。
  • TTA:仅 8/16/24-bit,不含加密 TTA。
  • DFF:支持未压缩 DSD 与 DST ≤6 声道;未知 CMPR、缺 FRTE、DST >6 声道的异常文件会跳过。
  • 存储:Android 11+ 的 .wv / .tta / .tak / .mpc 本地文件需授予“所有文件访问权限”,或通过云盘 / 同步 / 接收分享播放;.wma 可正常进系统媒体库。

我们不写“支持所有格式”;具体以「筛选扫描 → 格式」列表和上述边界为准。