update:歌曲详情文档增加字段说明

This commit is contained in:
binaryify 2022-02-11 17:34:40 +08:00
parent 530d331eb2
commit da88795b86

View File

@ -2036,6 +2036,75 @@ mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具
**调用例子 :** `/song/detail?ids=347230`,`/song/detail?ids=347230,347231`
返回字段说明:
```
name: String, 歌曲标题
id: u64, 歌曲ID
pst: 0功能未知
t: enum,
0: 一般类型
1: 通过云盘上传的音乐,网易云不存在公开对应
如果没有权限将不可用除了歌曲长度以外大部分信息都为null。
可以通过 `/api/v1/playlist/manipulate/tracks` 接口添加到播放列表。
如果添加到“我喜欢的音乐”,则仅自己可见,除了长度意外各种信息均为未知,且无法播放。
如果添加到一般播放列表虽然返回code 200但是并没有效果。
网页端打开会看到404画面。
属于这种歌曲的例子: https://music.163.com/song/1345937107
2: 通过云盘上传的音乐,网易云存在公开对应
如果没有权限则只能看到信息,但无法直接获取到文件。
可以通过 `/api/v1/playlist/manipulate/tracks` 接口添加到播放列表。
如果添加到“我喜欢的音乐”,则仅自己可见,且无法播放。
如果添加到一般播放列表,则自己会看到显示“云盘文件”,且云盘会多出其对应的网易云公开歌曲。其他人看到的是其对应的网易云公开歌曲。
网页端打开会看到404画面。
属于这种歌曲的例子: https://music.163.com/song/435005015
ar: Vec<Artist>, 歌手列表
alia: Vec<String>,
别名列表,第一个别名会被显示作副标题
例子: https://music.163.com/song/536623501
pop: 小数,常取[0.0, 100.0]中离散的几个数值, 表示歌曲热度
st: 0: 功能未知
rt: Option<String>, None、空白字串、或者类似`600902000007902089`的字符串,功能未知
fee: enum,
0: 免费
1: 2元购买单曲
4: 购买专辑
8: 低音质免费
v: u64, 常为[1, ?]任意数字, 功能未知
crbt: Option<String>, None或字符串表示的十六进制功能未知
cf: Option<String>, 空白字串或者None功能未知
al: Album, 专辑如果是DJ节目(dj_type != 0)或者无专辑信息(single == 1)则专辑id为0
dt: u64, 功能未知
h: Option<Quality>, 高质量文件信息
m: Option<Quality>, 中质量文件信息
l: Option<Quality>, 低质量文件信息
a: Option<?>, 常为None, 功能未知
cd: Option<String>, None或如"04", "1/2", "3", "null"的字符串表示歌曲属于专辑中第几张CD对应音频文件的Tag
no: u32, 表示歌曲属于CD中第几曲0表示没有这个字段对应音频文件的Tag
rtUrl: Option<String(?)>, 常为None, 功能未知
rtUrls: Vec<String(?)>, 常为空列表, 功能未知
dj_id: u64,
0: 不是DJ节目
其他是DJ节目表示DJ ID
copyright: u32, 0, 1, 2: 功能未知
s_id: u64, 对于t == 2的歌曲表示匹配到的公开版本歌曲ID
mark: u64, 功能未知
originCoverType: enum
0: 未知
1: 原曲
2: 翻唱
originSongSimpleData: Option<SongSimpleData>, 对于翻唱曲,可选提供原曲简单格式的信息
single: enum,
0: 有专辑信息或者是DJ节目
1: 未知专辑
noCopyrightRcmd: Option<NoCopyrightRcmd>, None表示可以播非空表示无版权
mv: u64, 非零表示有MV ID
rtype: 常为0功能未知
rurl: Option<String(?)>, 常为None功能未知
mst: u32, 偶尔为0, 常为9功能未知
cp: u64, 功能未知
publish_time: i64, 毫秒为单位的Unix时间戳
```
### 获取专辑内容
说明 : 调用此接口 , 传入专辑 id, 可获得专辑内容