歌曲管理
流式播放歌曲
按 song.ID 流式返回音频。内部根据 song.type 分发到本地文件 / 缓存下载 / 直链下载 / 电台 302。
get/songs/{id}/play
Path parameters
idinteger required
歌曲 ID
Query parameters
formatstring
目标转码格式（如 mp3、ogg），用于平台兼容性转码
qualitystring
目标音质码率（128/192/320），不传或不合法值表示原始音质。指定后默认转码为 mp3（除非同时指定了 format）
prefetchstring
传 1 时异步预热缓存/转码，立即返回 202
mediastring
传 video 时按视频播放：直出原容器（忽略 format/quality 转码，避免 -vn 丢画面），并按容器真实类型返回 Content-Type（如 video/mp4）。用于应用内视频画面渲染与 DLNA 视频投屏
hlsstring
仅电台(HLS)有效。传 direct 时强制 302 直连源站、绕过本机 HLS 反代（即使 /settings/hls-proxy 已开）。原生 player 无 CORS 限制，直连可避免直播切片经反代往返后过期(404)；浏览器不传此参数以继续走反代解决 CORS
Response
音频文件