Music Player
为 您的个人库 设计的音乐播放器。多年积累的 FLAC 收藏、从 CD 翻录的 MP3、下载的播客、现场录音。播放器内的一切都可在任何登录的设备上工作 — 手机、平板电脑、笔记本电脑、智能电视 — 带 从家庭硬盘的直接流式传输、后台播放（屏幕关闭继续播放）和真正的 频谱可视化器。
想象 Spotify，但使用您自己的文件且无月费。
亮点
播放列表
创建和组织自定义播放列表，带自动云同步。
网络流
从世界任何地方听家中硬盘的音乐。
后台播放
手机屏幕关闭后继续听。
可视化器
频率谱的实时动画。
添加音乐
📁 通过文件管理器
在 文件管理器 中找到音频文件 (.mp3、.wav、.ogg、.flac) 并 双击。Music Player 将自动打开并开始播放。
🔗 通过 URL
粘贴可通过 Internet 访问的音频文件的直接 URL。对托管或 CDN 的直接链接很有用。
📂 添加整个文件夹
一次将包含多个音频文件的整个文件夹导入您的库。
💾 从网络磁盘 服务器
浏览服务器的 映射磁盘 并从您的硬盘添加整个音乐文件夹。
网络磁盘流式传输
工作原理？
- 您的 MP3 文件位于 您的计算机或服务器的硬盘 上
- 这些文件 作为卷映射 在 RoqueOS Server 中
- Music Player 通过服务器通过 HTTP 流 访问
- 从任何连接到互联网的设备聆听
分步
1. 在 docker-compose.yml 中映射音乐文件夹:
services:
roqueos-server:
volumes:
- ./data:/app/data
- /var/run/docker.sock:/var/run/docker.sock
- /home/user/Music:/app/disks/Music # ← 您的音乐硬盘2. 重启服务器:
docker compose down && docker compose up -d3. 在 RoqueOS 中，打开 Music Player 并添加网络文件夹:
- 单击 添加文件夹 按钮
- 在网络选择器中导航到 Music 磁盘
- 选择所需的文件夹并确认
- 文件夹中的所有音乐都将导入您的库
4. 完成！从任何地方聆听。
如果您使用 Cloudflare Tunnels 进行外部访问，则流式传输可在具有互联网连接的世界任何地方工作。
后台播放
在手机上如何工作？
RoqueOS 使用浏览器的 Media Session API，允许:
- 屏幕关闭 — 音乐正常继续播放
- 锁定屏幕上的控件 — 播放、暂停、下一首和上一首出现在系统通知中
- 耳机上的控件 — 蓝牙耳机的按钮正常工作
- 切换应用 — 当您打开其他应用时，音乐不会停止
要求
- 通过 安装的 PWA 或 原生应用（iOS/Android）使用 RoqueOS
- 最新版本的 Chrome、Safari 或 Edge 浏览器
- 在 iOS 上，PWA 必须安装在主屏幕上，后台播放才能工作
提示
为了在手机上获得最佳流媒体体验，请将 RoqueOS 安装为 PWA 或从 App Store 或 Microsoft Store 下载原生应用。
播放列表管理
创建播放列表
- 在侧边面板的 播放列表 区域中，单击 + 新播放列表
- 为播放列表命名
- 将音乐从库中拖动到播放列表中，或使用音乐的上下文菜单
组织
- 重新排序 — 在播放列表中拖动音乐以更改顺序
- 删除 — 右键单击音乐并选择"从播放列表中删除"
- 重命名 — 单击播放列表名称以编辑
- 删除 — 通过上下文菜单删除整个播放列表
同步
所有播放列表和音乐库都 自动同步 在您的账户中。如果您在计算机上创建播放列表，下次在手机上打开 Music Player 时，它将出现。
音频可视化器
Music Player 具有一个对播放的音乐做出反应的实时 频谱可视化器。动画显示低音、中音和高音频率，以彩色条形随节奏跳舞。
关于 CROSS-ORIGIN 的注意事项
可视化器与本地文件和同源完美配合。对于不同域中的网络磁盘流（例如，应用程序在 localhost 中运行时访问 casa.roqueos.com），可视化器由于浏览器 CORS 限制使用备用脉冲模式 — 音乐继续正常播放。
桌面媒体小部件
当音乐正在播放时，迷你播放器 出现在 RoqueOS 任务栏上，允许快速控制而无需打开 Music Player 窗口:
- ⏯️ 播放 / 暂停
- ⏭️ 下一首
- ⏮️ 上一首
- 🔊 音量控制
支持的格式
| 格式 | 扩展名 | 支持 |
|---|---|---|
| MP3 | .mp3 | ✅ 所有浏览器 |
| WAV | .wav | ✅ 所有浏览器 |
| OGG Vorbis | .ogg | ✅ Chrome、Firefox、Edge |
| FLAC | .flac | ✅ Chrome、Edge、Safari 14.1+ |
| AAC | .aac、.m4a | ✅ 所有浏览器 |
| WebM Audio | .webm | ✅ Chrome、Firefox、Edge |
使用提示
快速提示
- 双击 库中的音乐立即播放
- 使用 上下文菜单（右键单击）将音乐添加到播放列表
- 重新打开应用时，播放器会记住 位置和队列
- 为了更好的远程流媒体质量，使用 MP3 或 AAC 等紧凑格式
- 使用 Cloudflare Tunnels，流式传输全球工作而无需公开端口