diff --git a/public/docs/home.md b/public/docs/home.md index f2570bd..eaaee4a 100644 --- a/public/docs/home.md +++ b/public/docs/home.md @@ -1502,13 +1502,14 @@ tags: 歌单标签 **必选参数 :** `id` : 音乐 id `level`: 播放音质等级, 分为 `standard` => `标准`,`higher` => `较高`, `exhigh`=>`极高`, -`lossless`=>`无损`, `hires`=>`Hi-Res`, `jyeffect` => `高清环绕声`, `sky` => `沉浸环绕声`, -`jymaster` => `超清母带` +`lossless`=>`无损`, `hires`=>`Hi-Res`, `jyeffect` => `高清环绕声`, `sky` => `沉浸环绕声`, `dolby` => `杜比全景声`, `jymaster` => `超清母带` **接口地址 :** `/song/url/v1` **调用例子 :** `/song/url/v1?id=33894312&level=exhigh` `/song/url/v1?id=405998841,33894312&level=lossless` +说明:`杜比全景声`音质需要设备支持,不同的设备可能会返回不同码率的url。cookie需要传入`os=pc`保证返回正常码率的url。 + ### 音乐是否可用 说明: 调用此接口,传入歌曲 id, 可获取音乐是否可用,返回 `{ success: true, message: 'ok' }` 或者 `{ success: false, message: '亲爱的,暂无版权' }` @@ -2293,7 +2294,9 @@ s_id: u64, 对于t == 2的歌曲,表示匹配到的公开版本歌曲ID mark: u64, 一些歌曲属性,用按位与操作获取对应位置的值 8192 立体声?(不是很确定) 131072 纯音乐 + 262144 支持 杜比全景声(Dolby Atmos) 1048576 脏标 🅴 + 17179869184 支持 Hi-Res 其他未知,理论上有从1到2^63共64种不同的信息 专辑信息的mark字段也同理 例子:id 1859245776 和 1859306637 为同一首歌,前者 mark & 1048576 == 1048576,后者 mark & 1048576 == 0,因此前者是脏版。 @@ -4692,16 +4695,15 @@ bitrate = Math.floor(br / 1000) ### 获取客户端歌曲下载链接 - 新版 -说明 : 使用 `/song/url/v1` 接口获取的是歌曲试听 url, 但存在部分歌曲在非 VIP 账号上可以下载无损音质而不能试听无损音质, 使用此接口可使非 VIP 账号获取这些歌曲的无损音频 +说明 : 使用 `/song/url/v1` 接口获取的是歌曲试听 url, 非 VIP 账号最高只能获取 `极高` 音质,但免费类型的歌曲(`fee == 0`)使用本接口可最高获取`Hi-Res`音质的url。 **必选参数 :** `id` : 音乐 id `level`: 播放音质等级, 分为 `standard` => `标准`,`higher` => `较高`, `exhigh`=>`极高`, -`lossless`=>`无损`, `hires`=>`Hi-Res`, `jyeffect` => `高清环绕声`, `sky` => `沉浸环绕声`, -`jymaster` => `超清母带` +`lossless`=>`无损`, `hires`=>`Hi-Res`, `jyeffect` => `高清环绕声`, `sky` => `沉浸环绕声`, `dolby` => `杜比全景声`, `jymaster` => `超清母带` **接口地址 :** `/song/download/url/v1` -**调用例子 :** `/song/download/url/v1?id=2058263032&level=lossless` +**调用例子 :** `/song/download/url/v1?id=2155423468&level=hires` ### 当前账号关注的用户/歌手