播放音乐

基本播放控制

底部播放栏提供完整的播放控制：

按钮	功能
⏮ 上一曲	播放上一首歌曲
⏯ 播放 / 暂停	控制播放和暂停
⏭ 下一曲	播放下一首歌曲

点击进度条可跳转到歌曲的任意位置。鼠标悬停在进度条上会显示预览时间点。

播放模式

在播放队列界面（点击播放栏右侧的列表图标）可以切换播放模式：

模式	说明
顺序播放	按列表顺序依次播放，播完最后一首停止（默认）
列表循环	播完最后一首后回到第一首，循环不止
单曲循环	重复播放当前歌曲
随机播放	乱序播放列表中的歌曲

播放队列

点击播放栏右侧的列表图标打开播放队列，可以：

• 查看当前待播放的歌曲列表
• 拖拽调整歌曲顺序
• 从列表中移除歌曲（点击歌曲右侧的 ×）
• 一键清空队列

向队列添加歌曲的几种方式：

• 在搜索结果或歌单中右键点击歌曲，选择 加到播放队列
• 选择 下一首播放 可以插队到当前歌曲之后
• 拖拽本地音频文件到主窗口

音质选择

在播放详情页可以切换当前歌曲的播放音质。瓜子音乐支持四档音质：

音质	码率	说明
标准音质	~128 kbps	普通压缩音质，节省流量，加载最快
高品音质	~320 kbps	较高码率，适合大多数场景（推荐）
无损音质	~1000 kbps	FLAC 压缩，接近原始音频，文件较大
Hi-Res	≥ 24bit/96kHz	高解析度音频（部分歌曲支持，Pro 权益）

音质可用性

实际可用的音质取决于各平台歌曲本身的资源。并非所有歌曲都有全部音质选项。Pro 用户可解锁无损与 Hi-Res 音质，详见 Pro 权益。

你可以在 设置 -> 播放 -> 默认播放音质 中设置全局默认音质，新播放的歌曲会自动使用该音质。

无缝切歌

瓜子音乐支持淡入淡出切歌模式：当前歌曲渐弱的同时，下一首歌渐强进入，过渡自然不突兀。

在 设置 -> 播放 -> 淡入淡出时间 中可以：

• 调整过渡时长（0.5s ~ 5s）
• 设为 0 则关闭此功能，立即切歌

技术实现上采用 Web Audio API 的 A/B 双缓冲，切换瞬间无静音断点。

蓝牙断开自动暂停

瓜子音乐会监测系统音频输出设备状态。当蓝牙耳机或音箱断开连接时，播放会自动暂停，避免音乐突然从电脑扬声器外放造成尴尬。

如不需要此功能，可在 设置 -> 播放 -> 蓝牙断开暂停 中关闭。

详情页

单击底部播放栏的封面或歌名区域，或按 Ctrl + D，即可切换播放详情页--大尺寸封面、逐字歌词、可视化动效的核心视听界面。

详情页功能完整介绍请参考 播放详情页。

常见问题

点击歌曲没有播放？

• 检查网络连接是否正常
• 可能是该平台的音源暂时不可用，尝试 换源
• 检查是否安装了在线播放插件（设置 -> 插件）
• 详见 常见问题 - 播放问题

播放中途自动暂停？

• 检查是否有其他应用占用音频输出设备
• 检查蓝牙耳机是否断连（瓜子音乐会检测蓝牙断开并暂停）
• 在线播放时网络不稳定可能导致缓冲暂停

音质选项是灰色不可选？

• 该平台对该歌曲不提供对应音质的资源
• 尝试换源到其他平台
• 无损 / Hi-Res 需要 Pro 权益，详见 Pro 权益

切歌时有短暂空白？

• 检查 淡入淡出时间 是否设为了 0
• 网络延迟较高时，新歌曲需要缓冲，可能产生短暂空白
• 启用淡入淡出可以遮盖缓冲延迟