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

+26
View File
@@ -0,0 +1,26 @@
// 千千音乐单曲信息(/v1/song/info)
// 接口返回 data[]:title/albumTitle/albumAssetCode/pic/duration/artist/lyric(歌词文本 URL)
import { APP_ID, apiGet, apiOk, mapTrack } from './util.ts'
/** 由 TSID 取单曲信息(归一为 Song 形状,并附 lyricUrl) */
export const getSongInfo = async(tsid: string) => {
const id = String(tsid ?? '').trim()
if (!id) throw new Error('千千歌曲 id(TSID)为空')
const body = await apiGet('/v1/song/info', { TSID: id, appid: APP_ID })
if (!apiOk(body) && !Array.isArray(body?.data)) {
throw new Error(body?.errmsg || `千千歌曲信息获取失败(errno ${body?.errno})`)
}
const item = Array.isArray(body?.data) ? body.data[0] : null
if (!item) throw new Error('千千歌曲不存在或已下架')
const song = mapTrack(item)
return {
...song,
// 以入参 id 兜底(song/info 的 TSID 字段缺失时仍可继续取流/歌词)
songmid: song.songmid || id,
lyricUrl: String(item?.lyric ?? '').trim(),
raw: item,
}
}
export default { getSongInfo }