播放控制——切歌 暂停 进度 循环模式
播放控制区位置
控制区在播放器底部常驻(移动端)或窗口底部/侧边(桌面端),包含:
- 播放/暂停按钮:中央大按钮,点一下暂停再点一下继续。
- 上一首 / 下一首:左右两侧按钮,在歌单或搜索列表中切换。
- 进度条:点击或拖拽跳转到歌曲任意位置。
- 播放模式:循环模式按钮,点击在顺序播放、单曲循环、列表循环、随机播放之间切换。

进度拖拽
进度条支持精确拖拽定位。需要注意:进度显示的是播放器端累计的播放时长,底层音频流的实际缓冲位置由系统媒体播放器决定。在网络状况差时,拖拽到未缓冲的位置可能会短暂卡顿。
循环模式
四种模式:
- 顺序播放:按当前列表从上到下依次播放,播完列表末尾停止。
- 列表循环:按列表顺序播完最后一首后回到第一首继续循环。
- 单曲循环:当前歌曲播完后自动重播。
- 随机播放:每次从列表中随机选一首播放,不重复直到全部播过一轮。
后台播放
移动端:Android 系统需要允许 MusicFree 后台运行权限,否则息屏或切换应用后系统可能杀掉播放进程。如果遇到"播完一首歌就停了",先检查后台权限设置。
桌面版:系统级播放控制(Windows 媒体中心、macOS Touch Bar 等)可以操作播放暂停和切歌,即使 MusicFree 窗口不在前台。
播放失败时的行为
宿主有一个设置项:「播放失败时自动暂停」。如果打开后遇到某首歌无法播放(音源链接过期、死链、VIP 内容被过滤等),播放器会自动暂停,不会自动跳下一首。
这是为了让你注意到播放失败这个情况(而不是在不知情的情况下跳过一堆坏链接)。如果你更想让播放器继续往下走,可以关掉这个选项。
歌词滚动
播放时歌词页会随歌曲进度自动滚动。歌词由插件 GetLyrics 接口返回 LRC 格式文本,宿主解析并按时间轴定位。如果某首歌没有歌词或歌词时间轴不准确,考虑用 歌词关联 功能关联到歌词正确的版本。