当前歌词（最新一条）

返回当前活跃播放器正在播放的最新一行歌词。

index - 歌词行号；-1 表示平台未返回可用歌词数据（见下方说明）

text - 主歌词文本

sub_text - 翻译歌词文本；cloudmusicv3、qqmusic、kugou、sodamusic 提供，wesing 恒为空字符串。kugou 的翻译取自 KRC 内嵌的中文译轨、按行号对齐，回落行级 LRC、或该行无译文时为空；sodamusic 的翻译是平台单独下发的 tlyric LRC（translations.cn）、按绝对时间戳对齐，该曲无译轨或该行未被译轨覆盖（间奏等）时为空

timestamp - 歌词时间戳（秒）

play_time - 本行歌词的上屏时间（秒）。基准为 timestamp - offset；若本行逐字首字早于行时间戳（典型是 cloudmusicv3 的 YRC 长引子行；kugou 与 sodamusic 的 KRC 字级偏移相对行首、首字即行首，不会提前），取首字时刻，此时 play_time 小于该基准。index 为 -1（无可显示歌词）时为 0

position - 整曲实时播放位置（秒），= progress × duration，每条都带、与 index 无关；与 play_time（本行播出时间）是两个量

progress - 整曲播放进度（0-1），= position / 歌曲总时长；与 play_time（本行歌词的播出时间）无换算关系

text_detailed - 逐字/细粒度歌词扩展（含 timestamp、play_time、duration、words[]）；无逐字数据时为空对象 {}

index: -1 纯音乐说明：
当平台未返回任何歌词数据时，发送 index: -1 而非空对象 {}。此时 timestamp 为 0，sub_text 为空字符串，text_detailed 为 {}；progress 照常反映整曲播放进度，不为 0（歌没有歌词，但它还在播）。
text 不保证为空：cloudmusicv3 与 kugou 对纯音乐返回一行「纯音乐，请欣赏」，服务端已把 index 归一为 -1，但该提示语原样保留在 text 里；qqmusic 的 API 返回零行、以及 sodamusic 的平台未给出 KRC（lyrics.type 非 krc 或内容为空）时，text 为 ""。提示语归一逻辑对五家统一生效，只是尚未观测到汽水发出这一行。
判断有无歌词一律用 index !== -1，不要看 text。
与此同时会发送一条 all_lyrics（count: 0，lyrics: []）。
客户端利用 msg.data.index === -1 识别纯音乐，而非依赖 msg.data.text。

application/json

200 成功

Bodyapplication/json

示例

播放中（wesing，此行无逐字）。wesing 的逐字来自进程内存的卡拉OK字级时间、逐行判定，时间轴不合法的行退回行级、text_detailed 为 {}（如本例）；wesing 无翻译，sub播放中（cloudmusicv3，YRC 逐字 + 翻译，真实录音）。words 已裁剪至 2 个，实际 9 个——只删元素不改值。本行逐字首字（156.96）早于行时间戳（157.22），故 pla播放中（sodamusic，真实录音）。words 已裁剪至 3 个，实际 14 个——只删元素不改值。KRC 的字级偏移相对行首、首字即行首，故 text_detailed.timestamp 恒等服务端还没有该播放器的歌词数据（播放器未启动，或启动后尚未播放）。这不是「本曲无歌词」——那种情况 data 是下面两例的完整对象。平台返回零行歌词时 text 为空字符串。timestamp 为 0、play_time 为 0（无行可播出），而 position / progress 照常反映整曲播放位置（此例为中途接入，故非这两家对纯音乐返回一行「纯音乐，请欣赏」，服务端把 index 归一为 -1，但该提示语原样保留在 text 里——所以 index 为 -1 并不蕴含 text 为空。

{
    "code": 0,
    "msg": "success",
    "player": "wesing",
    "data": {
        "index": 1,
        "text": "往事就像流星刹那划过心房",
        "sub_text": "",
        "timestamp": 31.483,
        "play_time": 31.282999,
        "position": 31.282999,
        "progress": 0.105743244,
        "text_detailed": {}
    }
}

请求参数

请求示例代码

返回响应