Files
MusicServer/sdk/apis/qian.ts
T
snowy-yang 33b96f92c4 feat(sdk): 新增咪咕/千千/JOOX/哔哩哔哩/5sing/Apple Music 六平台
平台注册表由 9 个扩到 15 个,同时补齐 sdk/types.ts 的类型与
OpenAPI 文档里的能力位声明。

- migu:命中 Z3D/I3D 加密候选时不返回直链,改由服务端解密代理出流,
  SDK 侧只负责登记票据,避免客户端拿到无法播放的密文
- apple:只提供 preview 试听片段(完整曲为 DRM),标 noAggregate
  排除在跨平台精确匹配之外,防止用它顶掉其它平台的可播结果
- 其余平台按既有 PlatformModule 约定实现搜索/专辑/歌单/歌词

为什么合并成一次提交:六平台共用同一份注册表与能力位声明,
拆开会产生互相引用、单独无法通过类型检查的中间态。
2026-10-03 00:26:32 +08:00

74 lines
3.3 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// 千千音乐 URL 获取(/v1/song/tracklink,签名通道)
// 档位:3000=flac / 320 / 128 / 64(aac)。实测(2026-10-02):
// - 免费曲目(搜索 isVip=0,如 SSR Beats 特辑)各档位均返回明文直链 data.path(audio0x.dmhmusic.com,CDN 签名 URL)
// - VIP/版权曲目返回 200/errno 22000 但 data 无 path、无 trail_audio_info,需登录态带会员 cookie 才可能有直链
// 契约:getMusicUrl(songInfo, type) → { promise, cancelHttp },promise resolve { type, url }(type 为实际命中档位)
import { apiOk, firstNonEmpty, trackLink } from '../qian/util.ts'
// 请求档位 → tracklink rate 尝试链(优先请求档,逐级降级;与上游 3000→320→128→64 的探测顺序一致)
const QUALITY_RATES: Record<string, string[]> = {
'64k': ['64'],
'128k': ['128', '64'],
'320k': ['320', '128', '64'],
'flac': ['3000', '320', '128', '64'],
'flac24bit': ['3000', '320', '128', '64'],
}
const DEFAULT_RATES = ['3000', '320', '128', '64']
export const supportQualitys = ['64k', '128k', '320k', 'flac']
/** 命中档位判定:以响应 format/rate/bits 为准(可能低于请求档位) */
const typeOfHit = (requestRate: string, data: any): string => {
const format = String(data?.format ?? '').toLowerCase()
const rate = Number(data?.rate ?? 0)
const bits = Number(data?.bits ?? 0)
if (format === 'flac' || rate >= 1000) return bits === 24 ? 'flac24bit' : 'flac'
if (rate >= 320 || requestRate === '320') return '320k'
if (rate >= 128 || requestRate === '128') return '128k'
return '64k'
}
/** 逐档请求 tracklink,取首个带 path 的档位;register 用于取流对象取消当前请求 */
export const getDownloadUrl = async(tsid: string, type?: string, register?: (req: any) => void) => {
const id = String(tsid ?? '').trim()
if (!id) throw new Error('千千歌曲 id(TSID)为空')
const rates = QUALITY_RATES[String(type ?? '')] ?? DEFAULT_RATES
let lastErr: any = null
for (const rate of rates) {
try {
const body = await trackLink(id, rate, register)
if (!apiOk(body)) {
lastErr = new Error(body?.errmsg || `千千取流失败(errno ${body?.errno})`)
continue
}
const data = body?.data ?? {}
const url = firstNonEmpty(data?.path, data?.trail_audio_info?.path)
if (url) return { type: typeOfHit(rate, data), url }
lastErr = new Error('千千该歌曲无可用直链(VIP/版权曲目需登录态,免费曲目可直接取流)')
} catch (err) {
lastErr = err
}
}
throw lastErr ?? new Error('千千未找到可用音频直链')
}
export const getMusicUrl = (songInfo: any, type?: string) => {
const requestObj: any = { promise: null, cancelHttp() {} }
let current: any = null
requestObj.cancelHttp = () => {
current?.cancelHttp?.()
current = null
}
requestObj.promise = (async() => {
// 上游 GetDownloadURL:Song.URL 已有直链时直接复用(Parse 场景)
if (songInfo?.url) return { type: type || '128k', url: String(songInfo.url) }
const tsid = firstNonEmpty(songInfo?.songmid, songInfo?.TSID)
if (!tsid) throw new Error('千千歌曲 id(TSID)为空')
return getDownloadUrl(tsid, type, (req) => { current = req })
})()
return requestObj
}
export default { getMusicUrl, getDownloadUrl, supportQualitys }