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

活跃播放器清除事件

Webhook

POST

player_clear

最后修改时间：2026-05-21 19:21:42

所有播放器都停止输出（全员 inert）时推送。仅根订阅者（/ws）收到此事件。
总是与 player_switch(to="") 一起发送（双重通知，向后兼容）。
若客户端连入 /ws 时当前已经没有活跃播放器，也会立即收到这个初始事件。
前端应清空歌词、封面、进度等所有显示内容。

请求参数

Body 参数application/json必填

示例

{
    "type": "player_clear",
    "player": "",
    "data": {}
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://your-api-server.com' \
--header 'Content-Type: application/json' \
--data '{
    "type": "player_clear",
    "player": "",
    "data": {}
}'

返回响应

🟢200

事件已接收

该响应没有 Body

播放器切换事件

HTTPResponse