跳转到内容
SingVerse

输入关键词搜索全部文档

↑ ↓ 选择Enter 打开Esc 关闭
GitHub开始部署

家庭收藏与歌单

把常唱的歌收进家庭收藏,把聚会主题整理成共享歌单。后台、手机、电视和新版亲友端围绕同一份 NAS 曲库协作。

基于当前源码 · 功能以部署版本为准
集合 用途 保存位置
家庭收藏 长期标记经常唱或喜欢的歌,所有家庭设备共用 当前 NAS 的业务数据库
共享歌单 按主题组织一组有顺序的歌曲 当前 NAS 的业务数据库
聚会待唱队列 决定本场接下来播放什么、谁点的、谁先唱 当前聚会,由 Go 维护
手机练唱历史与作品 本机练习、回听与录音成品 当前 Android 手机

家庭收藏:所有设备看到同一份

Section titled “家庭收藏:所有设备看到同一份”

后台“曲库 → 收藏”、手机“常唱 → NAS 共享收藏”、电视“收藏”,以及新版亲友 H5“家庭收藏”,读取同一 NAS 集合。收藏不是个人账号的私密清单,不同 NAS 的收藏互不合并。

  1. 在歌曲列表、详情或播放器点击收藏,等待服务端确认。
  2. 在收藏页搜索、筛选、排序,后台可从曲库多选添加。
  3. 取消单首或后台当前页批量取消前,核对范围;操作只删除收藏关系。
  4. 其他设备进入页面、恢复前台或自动刷新后读取变化;后台、手机和电视前台约 30 秒刷新。

新版亲友加入本场后也可增删家庭收藏,但不能因此访问管理员收藏接口或系统设置。所有写入仍由服务端核验身份。

  • 读取失败时保留上次成功内容并显示错误,不把未知状态当成空收藏。
  • 收藏写入失败保持原值,不建立离线待提交副本。
  • 已移除歌曲会保留可辨认信息,但不可播放;仍可取消收藏。
  • 切换 NAS、退出或认证失效会清理客户端当前集合,拒绝旧请求的迟到响应。
  • 旧版本保存在客户端的本地收藏不会自动导入 NAS,也不作为新接口失败时的回退来源。
  1. 进入“曲库 → 歌单”,新建歌单,填写名称与简介。
  2. 从当前曲库选择歌曲,调整保存顺序;每份最多 500 首且不重复。
  3. 检查缺失或不可用引用,保存前按提示处理。
  4. 点击保存;电视“歌单”入口读取这份数据,并按保存顺序浏览。

歌单列表可搜索名称与简介,按最近更新、名称、可用歌曲数排序,每页 12 项。封面取第一张可用的真实歌曲封面,无图显示中性占位。

歌单顺序用于浏览,实际点歌进入 FAIR 聚会后仍按每人轮唱规则排队。编辑或删除歌单不重排当前聚会,也不删除媒体文件。

编辑器可选择已配置且启用的模型,输入场景、氛围或歌手,并以关键词缩小候选。每次最多发送 500 首候选的 ID、歌名、歌手和正式分类名称,不发送文件路径或媒体内容。

  1. 选择模型与候选范围,设置推荐数量,默认 20 首,可选 1~50 首。
  2. 生成后核对建议预览,曲库外 ID 和非法结果不会被直接采用。
  3. 明确“采用”才替换编辑草稿;仍要点击保存才成为正式歌单。
  4. 失败、限流或放弃会保留原草稿,不自动重复付费请求。

没有模型时直接手动创建;模型建议不保证音乐审美、年代或版本判断准确。

歌单保存、编辑和删除会校验修订号,旧窗口不能静默覆盖新修改。存在未保存草稿时离开页面会提示;版本冲突后先读取当前歌单,再重新核对选曲。

共享内容随业务数据库备份。手机本机录音作品不包含在 NAS 收藏或歌单里,重装手机前需单独导出。继续阅读:公平队列、作品保存与导出。