v56

latestSwagger 2.0Apache 2.0raw.githubusercontent.com2026-08-0616186383.8 KB
歌曲管理

获取歌曲音频流列表

用 ffprobe 探测该歌曲文件的音频流,返回每条流的 audio-relative index(对应 ffmpeg -map 0:a:N)、title、language、codec、default。主要用于 Web 端双音轨(原唱/伴奏 mka)切换:前端据 tracks 数量决定是否显示切轨入口,并用 index 调 /songs/{id}/play?track=N 抽轨播放。仅本地歌曲(或已落地缓存的网络歌曲)有文件可探测;无可探测文件或音频流 < 2 条时也正常返回(前端据此不显示切轨)。运行时按需探测,不落库。

get/songs/{id}/audio-tracks

Path parameters

idinteger required

歌曲 ID

Response

音频流列表