From 83cc9a7566fc416776d91dee9fe49e3b1b43d0cd Mon Sep 17 00:00:00 2001
From: overwriter <9856mmm@gmail.com>
Date: Sat, 13 Jul 2024 16:32:11 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E5=A2=9E=E5=8A=A0=E6=8E=A5=E5=8F=A3?=
 =?UTF-8?q?=EF=BC=9A=20=E8=8E=B7=E5=8F=96=E5=AE=A2=E6=88=B7=E7=AB=AF?=
 =?UTF-8?q?=E6=AD=8C=E6=9B=B2=E4=B8=8B=E8=BD=BD=E9=93=BE=E6=8E=A5=20-=20?=
 =?UTF-8?q?=E6=96=B0=E7=89=88=E3=80=81=E5=BD=93=E5=89=8D=E8=B4=A6=E5=8F=B7?=
 =?UTF-8?q?=E5=85=B3=E6=B3=A8=E7=9A=84=E7=94=A8=E6=88=B7/=E6=AD=8C?=
 =?UTF-8?q?=E6=89=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.MD                      |  3 +++
 module/song_download_url_v1.js | 18 ++++++++++++++++++
 module/user_follow_mixed.js    | 24 ++++++++++++++++++++++++
 public/docs/home.md            | 29 +++++++++++++++++++++++++++++
 4 files changed, 74 insertions(+)
 create mode 100644 module/song_download_url_v1.js
 create mode 100644 module/user_follow_mixed.js

diff --git a/README.MD b/README.MD
index a0768c0..6135715 100644
--- a/README.MD
+++ b/README.MD
@@ -426,6 +426,9 @@ banner({ type: 0 }).then((res) => {
 280. 获取专辑歌曲的音质
 281. 歌手动态信息
 282. 最近听歌列表
+283. 云盘导入歌曲
+284. 获取客户端歌曲下载链接 - 新版
+285. 当前账号关注的用户/歌手
 
 ## 单元测试
 
diff --git a/module/song_download_url_v1.js b/module/song_download_url_v1.js
new file mode 100644
index 0000000..00bbaaf
--- /dev/null
+++ b/module/song_download_url_v1.js
@@ -0,0 +1,18 @@
+// 获取客户端歌曲下载链接 - v1
+// 此版本不再采用 br 作为音质区分的标准
+// 而是采用 standard, exhigh, lossless, hires, jyeffect(高清环绕声), sky(沉浸环绕声), jymaster(超清母带) 进行音质判断
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    id: query.id,
+    immerseType: 'c51',
+    level: query.level,
+  }
+  return request(
+    'POST',
+    `/api/song/enhance/download/url/v1`,
+    data,
+    createOption(query),
+  )
+}
diff --git a/module/user_follow_mixed.js b/module/user_follow_mixed.js
new file mode 100644
index 0000000..eac883e
--- /dev/null
+++ b/module/user_follow_mixed.js
@@ -0,0 +1,24 @@
+// 当前账号关注的用户/歌手
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const size = query.size || 30
+  const cursor = query.cursor || 0
+  const scene = query.scene || 0 // 0: 所有关注 1: 关注的歌手 2: 关注的用户
+  const data = {
+    authority: 'false',
+    page: JSON.stringify({
+      size: size,
+      cursor: cursor,
+    }),
+    scene: scene,
+    size: size,
+    sortType: '0',
+  }
+  return request(
+    'POST',
+    `/api/user/follow/users/mixed/get/v2`,
+    data,
+    createOption(query),
+  )
+}
diff --git a/public/docs/home.md b/public/docs/home.md
index 6677ace..ad2b56e 100644
--- a/public/docs/home.md
+++ b/public/docs/home.md
@@ -299,6 +299,8 @@
 281. 歌手动态信息
 282. 最近听歌列表
 283. 云盘导入歌曲
+284. 获取客户端歌曲下载链接 - 新版
+285. 当前账号关注的用户/歌手
 
 ## 安装
 
@@ -4685,6 +4687,33 @@ bitrate = Math.floor(br / 1000)
 ```
 导入后的文件名后缀均为 `.mp3` 。但用 `获取音乐url` 获取到的文件格式仍然是正确的。
 
+### 获取客户端歌曲下载链接 - 新版
+
+说明 : 使用 `/song/url/v1` 接口获取的是歌曲试听 url, 但存在部分歌曲在非 VIP 账号上可以下载无损音质而不能试听无损音质, 使用此接口可使非 VIP 账号获取这些歌曲的无损音频
+
+**必选参数 :** `id` : 音乐 id
+ `level`: 播放音质等级, 分为 `standard` => `标准`,`higher` => `较高`, `exhigh`=>`极高`, 
+`lossless`=>`无损`, `hires`=>`Hi-Res`, `jyeffect` => `高清环绕声`, `sky` => `沉浸环绕声`,
+`jymaster` => `超清母带`
+
+**接口地址 :** `/song/download/url/v1`
+
+**调用例子 :** `/song/download/url/v1?id=2058263032&level=lossless`
+
+### 当前账号关注的用户/歌手
+
+说明 : 调用此接口, 可获得当前账号关注的用户/歌手
+
+**可选参数 :** `size` : 返回数量 , 默认为 30
+
+`cursor` : 返回数据的 cursor, 默认为 0 , 传入上一次返回结果的 cursor,将会返回下一页的数据
+
+`scene` : 场景, 0 表示所有关注, 1 表示关注的歌手, 2 表示关注的用户, 默认为 0
+
+**接口地址 :** `/user/follow/mixed`
+
+**调用例子 :** `/user/follow/mixed?scene=1`
+
 ## 离线访问此文档
 
 此文档同时也是 Progressive Web Apps(PWA), 加入了 serviceWorker, 可离线访问