update: 听歌识曲接口完善, 补充demo页面

Author: Binaryify

.eslintrc.js

@@ -1,5 +1,6 @@
 module.exports = {
   root: true,
+  ignorePatterns: ['public/'],
   parserOptions: {
     parser: 'babel-eslint',
     ecmaVersion: 2018,

CHANGELOG.MD

@@ -1,4 +1,12 @@
 # 更新日志
+
+### 4.12.0 | 2023.09.10
+- 听歌识曲接口完善, 补充demo页面
+
+- NMTID 动态添加 #1792
+
+- weapi ua 固定
+
 ### 4.11.3 | 2023.09.09
 - 返回内容的`code`统一处理
 

docs/README.md

@@ -274,6 +274,7 @@
 256. 播客声音上传
 257. 验证接口-二维码生成
 258. 验证接口-二维码检测
+259. 听歌识曲
 
 ## 安装
 
@@ -4245,6 +4246,19 @@ qrCodeStatus:10,detailReason:0  二维码已扫描,并且手机号相同
 
 qrCodeStatus:20,detailReason:0  验证成功qrCodeStatus:21,detailReason:0 二维码已失效
 
+### 听歌识曲
+说明: 使用此接口,上传音频文件或者麦克风采集声音可识别对应歌曲信息,具体调用例子参考 `/audio_match_demo/index.html` (项目文件: `public/audio_match_demo/index.html`)
+
+**接口地址:** `/audio/match`
+
+**必选参数：**     
+
+`duration`: 音频时长,单位秒
+
+`audioFP`: 音频指纹,参考项目调用例子获取
+
+
+
 ## 离线访问此文档
 
 此文档同时也是 Progressive Web Apps(PWA), 加入了 serviceWorker, 可离线访问

interface.d.ts

@@ -244,6 +244,13 @@ export function artists(
   params: { id: string | number } & RequestBaseConfig,
 ): Promise<Response>
 
+export function audio_match(
+  params: {
+    duration: string | number
+    audioFP: string | number
+  } & RequestBaseConfig,
+): Promise<Response>
+
 export function avatar_upload(
   params: ImageUploadConfig & RequestBaseConfig,
 ): Promise<Response>

module/audio_match.js

@@ -1,14 +1,20 @@
-const realData =
-  'eJx10mtIU2EcBvDtnCwNMfO2klUSmSQ5ZugKW/v/0TIjJVdhDStbXpqXrhY5Kwhtrcwiut9VSqMUMxX6IFqsD92sD1YgWGHRBcowKrpnPa/v+drg4flt572ds2PQ6XQut7MwJ940w2TOyS0pzF+/BV/MJrNO+3TVLOHUzKx5iw3/H5uZ7yxegct3tTl7Cr6QEa0gZ/dZOFsvfe5YHe1D+yFZxpncqEj/cCdwoirdVxHNnZrX3xygU5g7Eh6I9uOx8Ch4y9FQjlKkDz1pYrFXIJLUOovFGcYivqJgXqaXDqu7Rzc0XzmZxG81B/fF8wRVusn2jN5rDnwca8tFhyAJP4L4qiI9vX8cWzEmVKzT/46qxNpIdZOZz2HNcHhSkZ3D4AjYFpfGFkX6+dB+FvcSBe/SWbkLPVnEOJ1DFelXxVVci/Wj4TsBLhrQ/LGoaU4HxsTA28L76Cc8Dfau/U6F6FgkyBDDJar0g8tesmOvOHioWeXXmme6l3MLbIIre6wciU5E2t/k8WVxHfHvuUWXsH4SPCv1NW1Cz0aivgYO34vw1AEvi3MlIw0xHl6JNVPEGW41UJsqPaXYYTuEnotMdHwYfv7CFR/i+aXmrY5wrlSkEwr+0EJ0GvLmdw4/RS9Amj93UAbGZMIF40ezE3PtcG/yBWrT3L6oh66hFyMXK4xsUKT7aufzapxnFTwiNc3Wis5Bdm+OYCvmOuHj/ZeoQPOI00PUrUjXpG+kMFU61tFFDvQaZOn5DH4mzoLw4Hsaj14rzu/K4jF66fSWTnJinW3wBvcveqjZN3iFjKp0qKuF1mi21keST3NtTcbwu1eG3Dussr9eemljLIco0tVH7HwA493wOr+FlIjfy+GvkR4uwfjt4v/6G8K3NX8K38lt6B1ISa+Bv2O8Fy69foZOovci2S4Lr1aku4P9OEWVTt9wgMQ7exgJ8JXyI0W694WFyuBjcH75XyrEXsfhg+ZSvqZIf/Lct8Wp0md2tJN4PifEfjcm8gu02Ptbj459eum8eg8bFWlLXTb/A+uo9bM='
+function createRandomString(len) {
+  const str = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'
+  let result = ''
+  for (let i = len; i > 0; --i)
+    result += str[Math.floor(Math.random() * str.length)]
+  return result
+}
 module.exports = (query, request) => {
   query.cookie.os = 'pc'
   const data = {
     algorithmCode: 'shazam_v2',
     times: 1,
-    sessionId: 'C999431ACDC84EDBB984763654E6F8D7',
-    duration: 3.3066249999999995,
+    sessionId: createRandomString(16),
+    duration: Number(query.duration),
     from: 'recognize-song',
-    rawdata: realData,
+    decrypt: '1',
+    rawdata: query.audioFP,
   }
   return request('POST', `https://music.163.com/api/music/audio/match`, data, {
     crypto: 'weapi',

package.json

@@ -1,6 +1,6 @@
 {
   "name": "NeteaseCloudMusicApi",
-  "version": "4.11.3",
+  "version": "4.12.0",
   "description": "网易云音乐 NodeJS 版 API",
   "scripts": {
     "start": "node app.js",