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

+50
View File
@@ -0,0 +1,50 @@
// Apple Music 歌词(上游 apple.go GetLyrics)
// 通道:amp-api /v1/catalog/<sf>/songs/<id>?include=lyrics&extend=extendedAssetUrls
// → data[0].relationships.lyrics.data[*].attributes.ttml
// 上游取到的是 TTML(Apple 逐字歌词格式,非 LRC),原样放入 lyric 字段返回;没有则忠实返回空串。
// 注意(2026-10 实测):匿名 developer token 请求时 Apple 不返回 lyrics relationship
// (即使 attributes.hasLyrics=true,歌单/搜索接口也一样),歌词接口需要 media-user-token(订阅态)才能拿到;
// 本实现保持上游行为:拿不到就返回 { lyric: '', tlyric: '' },不抛错。
// 统一接口约定:{ promise, cancelHttp };promise resolve → { lyric, tlyric }
import { appleAmpGetTracked, extractAppleID, getAppleConfig } from './util.ts'
export const getLyric = (songInfo: any, ..._rest: any[]) => {
const requestObj: { promise: any, cancelHttp: () => void } = { promise: null, cancelHttp() {} }
const tracker = { current: null as any }
requestObj.cancelHttp = () => {
try {
tracker.current?.cancelHttp?.()
} catch {
// ignore
}
tracker.current = null
}
const songId = extractAppleID(String(songInfo?.songmid ?? songInfo?.id ?? ''), 'song')
requestObj.promise = (async() => {
if (!songId) throw new Error('apple 歌曲 id 无效')
const cfg = getAppleConfig()
const body: any = await appleAmpGetTracked(
`/v1/catalog/${cfg.storefront}/songs/${songId}`,
{ include: 'lyrics', extend: 'extendedAssetUrls' },
tracker,
)
const lyrics = body?.data?.[0]?.relationships?.lyrics?.data ?? []
for (const rel of lyrics) {
const text = String(rel?.attributes?.ttml ?? '')
if (text) return { lyric: text, tlyric: '' }
}
return { lyric: '', tlyric: '' }
})()
return requestObj
}
/** 非取消句柄版:直接返回歌词文本(内部/测试用) */
export const getLyricsText = async(songId: string): Promise<string> => {
const result = await getLyric({ songmid: songId }).promise
return result?.lyric || ''
}
export default { getLyric }