snowy-yang
33b96f92c4
平台注册表由 9 个扩到 15 个，同时补齐 sdk/types.ts 的类型与 OpenAPI 文档里的能力位声明。 - migu：命中 Z3D/I3D 加密候选时不返回直链，改由服务端解密代理出流， SDK 侧只负责登记票据，避免客户端拿到无法播放的密文 - apple：只提供 preview 试听片段（完整曲为 DRM），标 noAggregate 排除在跨平台精确匹配之外，防止用它顶掉其它平台的可播结果 - 其余平台按既有 PlatformModule 约定实现搜索/专辑/歌单/歌词 为什么合并成一次提交：六平台共用同一份注册表与能力位声明， 拆开会产生互相引用、单独无法通过类型检查的中间态。
51 lines
2.1 KiB
TypeScript
51 lines
2.1 KiB
TypeScript
// 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 }
|