为了确保您的开发体验，建议您使用Apifox浏览器插件或客户端进行调试。

实时歌曲信息推送（指定播放器）

正式环境

localhost:8765

GET

/{player}/song_info-SSE

Server-Sent Events 实时歌曲信息推送（指定播放器）。
Per-player 端点始终推送指定播放器的歌曲信息事件，不受路由切换影响。

连接建立时： 始终立即发送一条当前歌曲信息状态。

事件格式：

data: {"type":"song_info_update","player":"wesing","data":{"name":"告白","singer":"花澤香菜","title":"告白 - 花澤香菜","cover":"http://...","cover_base64":"data:image/jpeg;base64,..."}}

歌曲结束/窗口关闭时：

data: {"type":"song_info_update","player":"wesing","data":{}}

直接切歌（A→B）时，不会先发送空再发送 B，而是直接发送 B 的信息

特性：

完全支持 UTF-8 编码

连接时始终立即发送当前状态

实时推送，延迟极低

支持跨域（CORS）

请求参数

Path 参数

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

text/event-stream

SSE 事件流

Body

示例

有歌曲信息时无歌曲信息时

data: {"type":"song_info_update","player":"wesing","data":{"name":"告白","singer":"花澤香菜","title":"告白 - 花澤香菜","cover":"http://imgcache.qq.com/music/photo/mid_album_500/a/b/001aBcDe23FgHi.jpg","cover_base64":"data:image/jpeg;base64,..."}}

修改于 2026-04-08 19:17:25

实时歌词推送（指定播放器）

WebSocket 连接（根端点，跟随活跃播放器）