Merge branch 'main' into 'main'

Main

See merge request Binaryify/neteasecloudmusicapi!36

README.MD

@@ -449,6 +449,10 @@ banner({ type: 0 }).then((res) => {
 303. 歌单导入 - 任务状态
 304. 副歌时间
 305. 相关歌单推荐
+306. 歌词摘录 - 歌词摘录信息
+307. 歌词摘录 - 我的歌词本
+308. 歌词摘录 - 添加/修改摘录歌词
+309. 歌词摘录 - 删除摘录歌词
 
 ## 单元测试
 

module/playlist_track_all.js

@@ -9,7 +9,7 @@ module.exports = (query, request) => {
     s: query.s || 8,
   }
   //不放在data里面避免请求带上无用的数据
-  let limit = parseInt(query.limit) || Infinity
+  let limit = parseInt(query.limit) || 1000
   let offset = parseInt(query.offset) || 0
 
   return request(`/api/v6/playlist/detail`, data, createOption(query)).then(

module/song_detail.js

@@ -2,6 +2,7 @@
 
 const createOption = require('../util/option.js')
 module.exports = (query, request) => {
+  // 歌曲数量不要超过1000
   query.ids = query.ids.split(/\s*,\s*/)
   const data = {
     c: '[' + query.ids.map((id) => '{"id":' + id + '}').join(',') + ']',

module/song_lyrics_mark.js

@@ -0,0 +1,9 @@
+// 歌词摘录 - 歌词摘录信息
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    songId: query.id,
+  }
+  return request(`/api/song/play/lyrics/mark/song`, data, createOption(query))
+}

module/song_lyrics_mark_add.js

@@ -0,0 +1,12 @@
+// 歌词摘录 - 添加/修改摘录歌词
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    songId: query.id,
+    markId: query.markId || '',
+    data: query.data || '[]',
+    // "[{\"translateType\":1,\"startTimeStamp\":800,\"translateLyricsText\":\"让我逃走吧、声音已经枯萎\",\"originalLyricsText\":\"逃がしてくれって声を枯らした\"},{\"translateType\":1,\"startTimeStamp\":4040,\"translateLyricsText\":\"我的愿望究竟会实现吗\",\"originalLyricsText\":\"あたしの願いなど叶うでしょうか\"}]"
+  }
+  return request(`/api/song/play/lyrics/mark/add`, data, createOption(query))
+}

module/song_lyrics_mark_del.js

@@ -0,0 +1,9 @@
+// 歌词摘录 - 删除摘录歌词
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    markIds: query.id,
+  }
+  return request(`/api/song/play/lyrics/mark/del`, data, createOption(query))
+}

module/song_lyrics_mark_user_page.js

@@ -0,0 +1,14 @@
+// 歌词摘录 - 我的歌词本
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    limit: query.limit || 10,
+    offset: query.offset || 0,
+  }
+  return request(
+    `/api/song/play/lyrics/mark/user/page`,
+    data,
+    createOption(query),
+  )
+}

public/docs/home.md

@@ -321,6 +321,10 @@
 303. 歌单导入 - 任务状态
 304. 副歌时间
 305. 相关歌单推荐
+306. 歌词摘录 - 歌词摘录信息
+307. 歌词摘录 - 我的歌词本
+308. 歌词摘录 - 添加/修改摘录歌词
+309. 歌词摘录 - 删除摘录歌词
 
 ## 安装
 
@@ -4579,7 +4583,7 @@ qrCodeStatus:20,detailReason:0  验证成功qrCodeStatus:21,detailReason:0 二
 **调用例子:** `/ugc/user/devote`
 
 ### 年度听歌报告
-说明: 登录后调用此接口,使用此接口,可获取当前登录用户年度听歌报告，目前支持2017-2023年的报告
+说明: 登录后调用此接口,使用此接口,可获取当前登录用户年度听歌报告，目前支持2017-2024年的报告
 
 **必选参数：**  
 
@@ -4587,7 +4591,7 @@ qrCodeStatus:20,detailReason:0  验证成功qrCodeStatus:21,detailReason:0 二
 
 **接口地址:** `/summary/annual`
 
-**调用例子:** `/summary/annual?year=2023`
+**调用例子:** `/summary/annual?year=2024`
 
 ### 本地歌曲文件匹配网易云歌曲信息
 
@@ -5018,6 +5022,70 @@ let link = encodeURIComponent(
 
 **调用例子:** `/playlist/detail/rcmd/get?id=8039587836`
 
+### 歌词摘录 - 歌词摘录信息
+
+说明: 登录后调用此接口, 传入歌曲id, 获取歌词摘录信息
+
+**必选参数：**
+
+`id`: 歌曲id
+
+**接口地址:** `/song/lyrics/mark`
+
+**调用例子:** `/song/lyrics/mark?id=2058263032`
+
+### 歌词摘录 - 我的歌词本
+
+说明: 登录后调用此接口, 获取我的歌词本
+
+**可选参数 :**
+
+`limit` : 返回数量 , 默认为 20
+
+`offset` : 偏移数量，用于分页 ,如 :( 页数 -1)\*30, 其中 30 为 limit 的值 , 默认为 0
+
+**接口地址:** `/song/lyrics/mark/user/page`
+
+**调用例子:** `/song/lyrics/mark/user/page`
+
+### 歌词摘录 - 添加/修改摘录歌词
+
+说明: 登录后调用此接口, 传入歌曲id, 可以添加/修改摘录歌词
+
+**必选参数：**
+
+`id`: 歌曲id
+
+`data`: 存储歌词摘录信息的对象数组的字符串，如: 
+```javascript
+let data = encodeURIComponent(
+  JSON.stringify([
+  {
+    "translateType": 1,
+    "startTimeStamp": 800,
+    "translateLyricsText": "让我逃走吧、声音已经枯萎",
+    "originalLyricsText": "逃がし てくれって声を枯らした"
+  }
+]),
+)
+```
+
+若需要修改摘录信息, 则需要填入参数```markId```, 修改对应的摘录信息
+
+**接口地址:** `/song/lyrics/mark/add`
+
+### 歌词摘录 - 删除摘录歌词
+
+说明: 登录后调用此接口, 传入摘录歌词id, 删除摘录歌词
+
+**必选参数：**
+
+`id`: 摘录歌词id
+
+**接口地址:** `/song/lyrics/mark/del`
+
+**调用例子:** `/song/lyrics/mark?id=2083850`
+
 ## 离线访问此文档
 
 此文档同时也是 Progressive Web Apps(PWA), 加入了 serviceWorker, 可离线访问