Merge branch 'main' into 'main'

docs: 增加 杜比全景声 音质的说明。补充客户端下载链接新版接口的说明

See merge request Binaryify/neteasecloudmusicapi!23

public/docs/home.md

@@ -1516,13 +1516,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: '亲爱的,暂无版权' }`
@@ -2307,7 +2308,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，因此前者是脏版。
@@ -4706,16 +4709,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`
 
 ### 当前账号关注的用户/歌手