QPlayer播放器最新版本

QPlayer 是一个开源、纯净且高度可定制的音乐播放器项目，具备插件化/可扩展音源机制：本体通常不内置或分发默认的在线音源，用户可通过安装/配置JavaScript等音源插件来实现聚合搜索、推荐、歌单、VIP歌曲自动换源等功能。

结构

QPlayer由一个播放器外壳和一套插件系统组成。

QPlayer它本体不包含在线音源，也不分发音源代码。安装JavaScript音源插件后，推荐、聚合搜索、歌单、登录、喜欢、最近播放、心动模式等页面才会出现；界面按插件的声明能力自动显着，与默认页面一致。未安装插件时，是一个本地播放器。

一条边界决定了后续设计：插件运行在隔离的RhinoRealm中，只有清单声明用户并经确认的权限才生效；插件返回的每个字段都要通过补充校验；插件不提供QML，只能对话框的内容，具体渲染由QPlayer使用自身组件完成。

特性

播放

本地媒体库、播放队列、透明播放模式（列表循环/随机/单曲循环）。在线统一使用provider:kind:id标志，避免多平台ID冲突。前端MediaSession服务接管锁屏、通知栏与蓝牙控制，处理自动续播、进度同步、来电暂停与失焦降音。歌曲信息和歌词在后台同步更新，返回前台后保留当前曲目状态。Android在线播放的后台存储完成后内容不会重新起播。缓冲或导出时，才从完整存储，并在跳转完成后从原图纸继续播放。

歌词页　由直接通过Skija直接关联，不经QML：逐字滚动、基于封面取色的流畅背景、罗马音与翻译、材质进度条。歌词内容来自当前音源插件或本地文件。安卓端对接词幕，把逐字歌词、翻译和罗马音推到状态栏。词幕的歌曲、歌词与进度由播放服务同步；退到后台、后台切歌或歌词延迟加载后仍会更新，不依赖渲染界面线程。

界面

整套UI使用MiuixQML（miuix.Core），在qml4j引擎上运行，通过内置StyleManager将封面颜色映射到Miuix莫奈结局（可关闭），支持深度/浅色/后续系统，以及简体中文与中文。布局由宽度驱动（断点600/840）：窄屏使用屏底部导航，宽屏切换为上游NavigationRail，歌单格栅列数字随宽度增减，因此安卓横屏与平板加载单独完成。设置始终使用单列分组，相关设置配置调整；歌曲、歌单、搜索结果和选择器采用窗口化虚拟列表。随包QML组件在构建期编译，终端运行时只加载页预编译类。Android启动画面与加载层覆盖首次界面加载，尚未暴露即将发生的GL黑帧。

界面迁移说明见Miuix界面。

桌面端

同一套QML与player-core运行在LWJGL3+GLFW上，由Skija渲染。OpenGL与Vulkan控制台可在启动时切换。MiniPlayer仅显示音量按钮，点击后在上方弹出层调节QPlayer音量，不改变系统音量；移动端入口位于页面顶部。任务栏图标与系统桌面菜单镜像播放控制；最小化到桌面时拓扑线程与GPU资源、恢复时重建，播放与界面状态保留。F11在当前显示器切换占全屏，进入后会短暂提示“按住Esc退出全屏”；持续按住Esc1.2秒会显示进度并退出，提前启动只取消操作。退出全屏会恢复原窗口尺寸或放大状态；DPI变化即使未触发窗口尺寸回调，可同步更新逻辑拓扑与渲染区域，避免界面裁切或留白。输出，紧接着默认系统输出设备；设备断连时保留当前轨迹和进度，恢复后从原位置继续，暂停状态不变。带有前置ID3v2标签的FLAC可正常播放、跳转及结束，不会误入MP3解码。

插件安全

签名.qplug包，内置源仓库与发布者预设固定在程序内，安装时首发权限供用户确认，按插件隔离的RhinoRealm、域名因此名单与命名空间库。插件对话框由插件声明、QPlayer渲染，接下来应用主题，且无法模仿取代的下一步界面。

QPlayer音乐播放器使用教程

1、配置音源与导入本地

首次打开软件后，进入设置页面配置所需的在线音源插件（如网易云、QQ音乐等）；同时授予存储权限，软件会自动扫描并导入手机内的本地音频文件。

2、在线搜索与播放

点击底部导航栏的“搜索”图标，在搜索框内输入歌名或歌手名称，即可快速精准检索在线曲目，点击即可开始播放。

3、浏览歌单与本地管理

在首页“推荐”板块可浏览各类精选歌单并一键播放；在“本地”页面则可以对已导入的音乐进行排序、重命名或添加至个人收藏列表。

4、个性化设置与同步

在“设置”中可自由切换深色/浅色模式、自定义字体及歌词页动画；通过扫码登录账号，即可将喜欢的歌曲同步至云端歌单，并开启锁屏后台播放。

QPlayer高频QA

1、QPlayer会有广告吗？

没有广告，软件本身是开源纯净版本。

2、可以添加多个音乐音源吗？

可以，支持自行添加QQ音乐、网易云等音源，音源失效还能自动替换。

3、本地音乐要怎么导入？

开启扫描权限，软件会自动识别整理手机里的本地音频。

4、歌单能不能跨设备同步？

支持扫码登录，登录后就能同步云端歌单。

5、锁屏状态下可以切歌吗？

可以，后台播放稳定，锁屏也能快捷切歌、切换循环模式。

更新日志

v1.9.3

新功能

桌面端改用GraalVMNativeImage，提供LinuxAppImage、WindowsZIP/安装程序、macOSAppleSiliconDMG，不再随包携带JRE。

Android与桌面端内置的QML组件在构建期预编译，直接启动加载，不再依赖运行时编译。

悬浮歌词支持屏幕旋转后按比例重定位，并提供锁定开关避免误触。

优化

文件选择器修改系统接口，删除Swing依赖。

WebView保留原有WebView2/WKWebView/WebKitGTK内核，改用独立轴承。

优化macOS菜单栏图标，支持从Dock唤回隐藏窗口。

修复

修复桌面端首次安装音源插件时，QML属性读取与渲染队列刷新竞争，触发「绑定求值检测到循环」导致退出的问题。

修复macOSCommand-Q与菜单退出失效、Retina下支架坐标偏移的问题。

修复搜索历史进入页面、点历史/热时搜被误写的问题，改为播放、下载或喜欢时记录，并大小写不去敏感重。

桌面原始版提示：Windows登录窗口需要WebView2Runtime；Linux需要WebKitGTK4.1或4.0；macOS产物面向AppleSilicon，未进行AppleDeveloperID签名与公证。