diff --git a/README.MD b/README.MD index 4acf1b6..d77306c 100644 --- a/README.MD +++ b/README.MD @@ -449,6 +449,10 @@ banner({ type: 0 }).then((res) => { 303. 歌单导入 - 任务状态 304. 副歌时间 305. 相关歌单推荐 +306. 歌词摘录 - 歌词摘录信息 +307. 歌词摘录 - 我的歌词本 +308. 歌词摘录 - 添加/修改摘录歌词 +309. 歌词摘录 - 删除摘录歌词 ## 单元测试 diff --git a/module/playlist_track_all.js b/module/playlist_track_all.js index 9e56134..06758f5 100644 --- a/module/playlist_track_all.js +++ b/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( diff --git a/module/song_detail.js b/module/song_detail.js index ed96470..adcd947 100644 --- a/module/song_detail.js +++ b/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(',') + ']', diff --git a/module/song_lyrics_mark.js b/module/song_lyrics_mark.js new file mode 100644 index 0000000..74f2000 --- /dev/null +++ b/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)) +} diff --git a/module/song_lyrics_mark_add.js b/module/song_lyrics_mark_add.js new file mode 100644 index 0000000..7fc6a09 --- /dev/null +++ b/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)) +} diff --git a/module/song_lyrics_mark_del.js b/module/song_lyrics_mark_del.js new file mode 100644 index 0000000..cada747 --- /dev/null +++ b/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)) +} diff --git a/module/song_lyrics_mark_user_page.js b/module/song_lyrics_mark_user_page.js new file mode 100644 index 0000000..2182dd8 --- /dev/null +++ b/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), + ) +} diff --git a/public/docs/home.md b/public/docs/home.md index a562fab..bc7cee9 100644 --- a/public/docs/home.md +++ b/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, 可离线访问