MoeFurina/NeteaseCloudMusicApiEnhanced
1
0
Fork 0
mirror of https://github.com/NeteaseCloudMusicApiEnhanced/api-enhanced.git synced 2026-08-12 08:50:38 +00:00
Code Issues Packages Projects Releases Activity

feat(song/url-v1): 新增immerseType参数支持并更新文档

Browse Source 
补充sky音质下immerseType参数的处理逻辑，更新文档说明与调用示例，注明参数仅在level为sky时生效
This commit is contained in:
Suxiaoqinx 2026-07-19 09:54:55 +08:00
parent 35d1c61cb4
commit fbd2e06419
3 changed files with 9558 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
module/song_url_v1.js
View File

@ -2,6 +2,7 @@
// 此版本不再采用 br 作为音质区分的标准 // 此版本不再采用 br 作为音质区分的标准
// 而是采用 standard, exhigh, lossless, hires, jyeffect(高清环绕声), sky(沉浸环绕声), jymaster(超清母带) 进行音质判断 // 而是采用 standard, exhigh, lossless, hires, jyeffect(高清环绕声), sky(沉浸环绕声), jymaster(超清母带) 进行音质判断
// 当unblock为true时, 会尝试使用unblockmusic-utils进行解锁, 同时音质设置不会生效, 但仍然为必须传入参数 // 当unblock为true时, 会尝试使用unblockmusic-utils进行解锁, 同时音质设置不会生效, 但仍然为必须传入参数
// 当level为sky时, 可通过 immerseType 选择沉浸声类型, 支持 c51(c51类型)、ste(环绕立体声类型)、aac(aac类型), 默认为 c51
const logger = require('../util/logger.js') const logger = require('../util/logger.js')
const createOption = require('../util/option.js') const createOption = require('../util/option.js')
@ -51,7 +52,9 @@ module.exports = async (query, request) => {
} }
} }
if (data.level == 'sky') { if (data.level == 'sky') {
data.immerseType = 'c51' data.immerseType = query.immerseType || 'c51'
} else if (query.immerseType) {
data.immerseType = query.immerseType
} }
return request( return request(
`/api/song/enhance/player/url/v1`, `/api/song/enhance/player/url/v1`,

9551
package-lock.json generated Normal file
View File

File diff suppressed because it is too large Load Diff

4
public/docs/home.md
View File

@ -1259,9 +1259,11 @@ tags: 歌单标签
`lossless`=>`无损`, `hires`=>`Hi-Res`, `jyeffect` => `高清环绕声`, `sky` => `沉浸环绕声`, `dolby` => `杜比全景声`, `jymaster` => `超清母带` `lossless`=>`无损`, `hires`=>`Hi-Res`, `jyeffect` => `高清环绕声`, `sky` => `沉浸环绕声`, `dolby` => `杜比全景声`, `jymaster` => `超清母带`
`unblock`: 是否使用使用歌曲解锁, 分为`true`和`false` `unblock`: 是否使用使用歌曲解锁, 分为`true`和`false`
**可选参数 :** `immerseType`: 沉浸声环绕声类型, 分为 `c51` => `c51类型`, `ste` => `环绕立体声类型`, `aac` => `aac类型`, 仅在 `level=sky` 时生效, 默认为 `c51`
**接口地址 :** `/song/url/v1` **接口地址 :** `/song/url/v1`
**调用例子 :** `/song/url/v1?id=1969519579&level=exhigh` `/song/url/v1?id=1969519579,33894312&level=lossless` **调用例子 :** `/song/url/v1?id=1969519579&level=exhigh` `/song/url/v1?id=1969519579,33894312&level=lossless` `/song/url/v1?id=1969519579&level=sky&immerseType=ste`
说明：`杜比全景声`音质需要设备支持，不同的设备可能会返回不同码率的 url。cookie 需要传入`os=pc`保证返回正常码率的 url。 说明：`杜比全景声`音质需要设备支持，不同的设备可能会返回不同码率的 url。cookie 需要传入`os=pc`保证返回正常码率的 url。