- **多人协作**: 支持多用户同时在线，共同管理播放队列 - **网易云音乐**: 集成网易云音乐API，海量曲库随心搜索 - **实时同步**: 基于 Redis 的实时状态管理，所有用户同步收听 - **投票跳过**: 民主投票机制，过半数用户同意即可跳过当前歌曲 - **高音质支持**: 自动请求高品质音频，支持无损音质 - **用户在线状态**: 实时显示在线用户列表和心跳检测 - **队列管理**: 查看当前播放列表，了解即将播放的歌曲 #### 首次使用 1. **打开浏览器访问分配的域名** 2. **进入音乐房间** - 应用会自动为您分配一个用户 ID - 可在设置中修改昵称（可选） 3. **搜索音乐** - 点击右上角「搜索」按钮 - 输入歌曲名、歌手名或专辑名 - 从搜索结果中选择歌曲加入队列 4. **开始播放** - 添加歌曲后会自动开始播放 - 所有在线用户同步收听同一首歌 --- ### 功能说明 #### 1. 音乐播放 - **当前播放**: 显示正在播放的歌曲信息、歌手、专辑封面 - **进度条**: 实时同步播放进度 - **播放队列**: 查看即将播放的歌曲列表 #### 2. 协作功能 - **投票跳过**: 点击「跳过」按钮投票，超过半数用户同意即跳过当前歌曲 - **在线用户**: 实时显示当前在线用户数量 - **用户心跳**: 60 秒无活动自动下线，重新操作自动上线 #### 3. 搜索与添加 - **搜索类型**: 支持搜索歌曲、专辑、歌手 - **添加到队列**: 点击搜索结果中的「添加」按钮 - **队列管理**: 歌曲按添加顺序依次播放 #### 4. 高级功能（可选） - **网易云登录**: 通过二维码登录网易云账号，解锁高品质音频 - **音质选择**: 自动请求无损音质（需登录网易云会员账号） --- ### 常见问题 #### Q1: 歌曲无法播放，显示「加载中」 **原因**: 网易云音乐 API 可能返回了受限歌曲 **解决方案**: 1. 等待系统自动跳过（约 3 秒） 2. 或手动投票跳过当前歌曲 3. 尝试搜索并添加其他歌曲 --- #### Q2: 音频卡顿或延迟 **原因**: 网络带宽不足或高并发访问 **解决方案**: 1. 检查设备网络连接 2. 降低并发用户数量（建议不超过 10 人） 3. 如果自托管，确保服务器带宽 ≥ 10Mbps --- #### Q3: 无法搜索到某些歌曲 **原因**: - 网易云音乐 API 版权限制 - 歌曲名称拼写错误 **解决方案**: 1. 尝试使用歌手名或专辑名搜索 2. 使用更精确的关键词 3. 部分歌曲可能需要网易云会员，可尝试登录网易云账号 --- #### Q4: 如何登录网易云账号？ **步骤**: 1. 点击应用右上角「登录」按钮 2. 使用手机网易云音乐 APP 扫描二维码 3. 登录成功后可解锁更多歌曲和高品质音频