Qplayer

Qplayer原生不内置音源，依靠插件拓展曲库，插件运行在隔离环境，支持逐字滚动歌词展示，可加载翻译、罗马音歌词，还能根据专辑封面自动生成适配的动态主题配色，兼容FLAC、MP3、AAC等音频格式，且支持本地音乐扫描管理，可自建歌单、调整播放顺序，字幕可以加载外挂文件并手动同步时间轴。

一、Qplayer的使用教程

1、打开Qplayer，获取文件权限，即可进入主播放界面。

2、在搜索栏输入歌曲名称或者歌手名字快速查找对应曲目。

3、选中喜欢的音乐加入个人歌单方便后续快速收听。

4、在设置页面调整播放模式、音质以及界面显示相关参数。

二、Qplayer的常见问题

Q：Qplayer导入M3U直播源后频道列表是空的，或者点开某个频道一直加载，先查哪里？

A： M3U文件本身可能是链接而不是文件，直接粘贴链接比下载文件再导入更稳妥。频道加载失败通常是源本身失效或需要特定的网络环境，换一个频道试一下，如果只有部分频道失败，问题在源不在播放器。全部频道都失败的话，检查手机网络是否正常，部分直播源对网络类型有限制。

Q：Qplayer投屏到电视后画面比例不对，或者搜不到Chromecast设备，怎么处理？

A： 手机和电视必须连接同一个Wi-Fi网络，跨网段或访客网络会导致设备不可见。搜不到设备时先确认电视端Chromecast或投屏接收功能已经开启，然后重启QPlayer再试一次。画面比例异常通常是视频源本身的宽高比和电视输出不匹配，在电视端的显示设置里切换比例模式，比在播放器内调整更直接。

Q：Qplayer指纹锁设置了但进私人文件夹时没有提示验证，直接就能打开，是什么原因？

A： 先确认系统层面已经录入了指纹，并且QPlayer在系统权限中获得了指纹或生物识别相关的授权。部分安卓机型在系统设置中单独控制每个应用的生物识别权限，QPlayer没有拿到授权时，指纹验证环节会被跳过。另外检查是否在App设置中正确开启了私人文件夹的锁定开关，锁定状态关闭时文件夹会直接打开。

三、Qplayer的软件亮点

1、插件化音源

可选网易云、QQ音乐、酷我等音源插件，安装时权限相对透明。

2、锁屏与蓝牙控制

支持通知栏、锁屏和蓝牙耳机切歌，听歌时不用一直停留在应用内。

3、响应式布局

界面会随屏幕宽度自适应，手机横屏、平板和大屏手机上都能保持较好布局。

四、Qplayer的更新日志

v1.9.6版本

新功能

新增睡眠定时，可选择 15、30、45、60、90 或 120 分钟后暂停播放，支持重新计时和取消。

优化

统一界面、主歌词、翻译、罗马音及凝彩的 Unicode 换行，避免句末标点单独成行，并保留组合字符、emoji 和逐字时间轴。

升级 qml4j 至 0.2.35，构建依赖切换为 JitPack。

精简中英文 README，将平台运行库和打包细节整理至详细文档。

修复

修复账户页顶部资料与主音源登录状态不一致；账号查询失败时保留已确认资料并显示状态暂不可用，明确退出后清空旧资料。（#55）

修复歌词页关闭通知时误触下方歌词定位或拖动的问题。