跳转到内容
SingVerse

输入关键词搜索全部文档

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

播放与热门、缺歌心愿

最近播放和热门来自实际演唱,缺歌心愿保留原始反馈与处理结果。理解计次规则,才能区分排队、试听、实播和真正补齐。

基于当前源码 · 功能以部署版本为准

管理端“客厅 → 播放与热门”提供热门排行、播放明细及单曲历史;“客厅 → 缺歌心愿”处理想唱却找不到的歌。新版亲友 H5 还可以查看最近、热门并提交缺歌反馈。

播放记录来自 TV、手机本机播放和管理员试听的真实上报。亲友点歌由实际播放的电视上报,不再计一次。仅入队、预取、缓存命中或拖动到结尾都不算有效演唱。

情况 是否计入热门
非后台试听,实际播放至少 30 秒 计一次,即使之后切歌、失败或中断
已知时长不足 30 秒的歌曲 须自然结束,且实播达到歌曲总时长
未知时长、实播不足 30 秒 不能套用短曲完整播放规则
管理员后台试听 保留活动明细,但不计热门有效次数
暂停、缓冲、拖动进度 不增加实际播放时长
自然结束 只是结束结果,不代表每一秒都被完整听过

同一播放实例最多计一次。不同歌曲 ID 和不同文件版本分别统计,不按同名曲自动合并。榜单默认近 30 天,也可选近 7 天、全部;统计来自当前 NAS,不是平台全网热度。

明细保存当时的歌名、歌手、版本、来源、设备、点歌人、时间、实播时长与结果;歌曲后来改名或移除,仍保留历史快照。点歌人不等于演唱者。

结果 说明
播放中 实例仍在活动,暂停和缓冲不会另建结束记录
自然结束 媒体报告结束
已切歌 / 已停止 用户或遥控明确结束
播放失败 实际播放发生错误
已中断 异常退出或 120 秒没有活动心跳等中断情况

亲友“最近”按歌曲去重,排除后台试听与零实播;“热门”按有效次数排序。不可用历史歌曲保留标题并禁点。时间筛选按服务端滚动区间计算,页面按浏览器本地时区显示。

  1. 先搜索曲库,确认不是别名、版本或筛选条件导致找不到。
  2. 打开亲友端“反馈缺失歌曲”,填写必填歌名;歌手、版本、说明按需补充。
  3. 提交后等待明确结果。超时保留同一请求和内容,先核对再重试。
  4. 服务端记录 PARTY 来源与实际提交人,亲友不能伪造管理员身份。

登记只创建反馈,不会自动下载、扫描或修改歌曲。不同音源与版权授权仍由实际使用者处理。

状态 处理方式
待处理 核对原始歌名、歌手、版本、说明和提交者
处理中 开始查找或整理,可填写处理备注
已补齐 必须关联当前曲库内真实可用的一首歌
已关闭 本次不处理,可记录原因

反馈可重开,离开已补齐状态会清除原关联与补齐时间。原始反馈保持只读,处理只更新状态、备注和关联。已关联歌曲后来不可用时,反馈保留并显示实际可用情况。

多人处理同一反馈时会校验修订号,冲突后重新读取再决定,不能覆盖另一处刚保存的结果。

  1. 确认实际播放端连接的是当前 NAS,客户端支持真实活动上报。
  2. 区分“播放明细”和“热门”:不足有效阈值可能有明细却没有榜单次数。
  3. 检查是否为管理员试听、是否筛选了错误时间范围。
  4. 若发生离线、服务重启或旧客户端未上报,不能根据当前位置补造历史。
  5. 继续播放一首可用测试歌曲,观察实际时长及服务日志,勿直接修改数据库造数。

播放与反馈随业务数据库备份;当前没有任意创建、编辑或删除历史的管理入口。