feat(sdk): 新增咪咕/千千/JOOX/哔哩哔哩/5sing/Apple Music 六平台

平台注册表由 9 个扩到 15 个,同时补齐 sdk/types.ts 的类型与
OpenAPI 文档里的能力位声明。

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

为什么合并成一次提交:六平台共用同一份注册表与能力位声明,
拆开会产生互相引用、单独无法通过类型检查的中间态。
This commit is contained in:
snowy-yang committed 2026-10-03 00:26:32 +08:00
1 parent 47ce651f46
commit 33b96f92c4
54 files changed
+6161 -5

No files matched your search

+73
View File
@@ -0,0 +1,73 @@
// 千千音乐 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 }