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
1 parent
47ce651f46
commit
33b96f92c4
54 files changed
+6161
-5
No files matched your search
@@ -0,0 +1,158 @@
|
||||
// 千千音乐歌单
|
||||
// 详情：/v1/tracklist/info?id=&type=0&pageNo=&pageSize=（支持分页，默认 pageSize=20）
|
||||
// 分类：/v1/tracklist/category（group.categoryName + subCate[]）
|
||||
// 分类歌单：/v1/tracklist/list?subCateId=&pageNo=&pageSize=（不传 subCateId 为全部）
|
||||
// 搜索：上游用 /v1/search?type=6，但 2026-10 实测服务端已下线该搜索类型
|
||||
// （errno 23001 "不被支持的搜索类型(10000)"），官网搜索页也只有 单曲/歌手/专辑 三个 tab；
|
||||
// 上游在 !state 时静默返回空列表，本实现保持一致并保留 typeSonglist 解析以备恢复。
|
||||
import { APP_ID, apiGet, apiOk, firstNonEmpty, mapTrack, playlistLink } from './util.ts'
|
||||
|
||||
const mapPlaylistSummary = (item: any) => {
|
||||
const id = item?.id == null ? '' : String(item.id)
|
||||
const rawDesc = String(item?.desc ?? '').trim()
|
||||
const tagList = Array.isArray(item?.tagList) ? item.tagList : []
|
||||
return {
|
||||
id,
|
||||
name: String(item?.title ?? '').trim(),
|
||||
cover: String(item?.pic ?? '').trim(),
|
||||
trackCount: Number(item?.trackCount ?? 0) || 0,
|
||||
creator: firstNonEmpty(item?.creator, item?.author, item?.userName, item?.nickName, item?.ownerName),
|
||||
description: rawDesc || tagList.join('、'),
|
||||
link: id ? playlistLink(id) : '',
|
||||
source: 'qian' as const,
|
||||
}
|
||||
}
|
||||
|
||||
/** 上游 SearchPlaylist（type=6 歌单搜索；服务端已停用，返回空列表） */
|
||||
export const searchPlaylist = async(keyword: string, page = 1, limit = 10) => {
|
||||
const word = String(keyword ?? '').trim()
|
||||
const empty = { source: 'qian' as const, list: [] as any[], total: 0, page, limit }
|
||||
if (!word) return empty
|
||||
|
||||
const body = await apiGet('/v1/search', {
|
||||
word,
|
||||
type: '6',
|
||||
pageNo: String(page),
|
||||
pageSize: String(limit),
|
||||
appid: APP_ID,
|
||||
})
|
||||
if (!body?.state) return empty
|
||||
|
||||
const items = Array.isArray(body?.data?.typeSonglist) ? body.data.typeSonglist : []
|
||||
const list = items.map(mapPlaylistSummary).filter((item: any) => item.id)
|
||||
return { source: 'qian' as const, list, total: Number(body?.data?.total) || list.length, page, limit }
|
||||
}
|
||||
|
||||
/** 歌单详情（含曲目；tracklist/info 支持 pageNo/pageSize） */
|
||||
export const getPlaylistDetail = async(id: string, page = 1, limit = 50) => {
|
||||
const playlistId = String(id ?? '').trim()
|
||||
if (!playlistId) throw new Error('千千歌单 id 为空')
|
||||
|
||||
const body = await apiGet('/v1/tracklist/info', {
|
||||
id: playlistId,
|
||||
type: '0',
|
||||
pageNo: String(Math.max(1, page)),
|
||||
pageSize: String(Math.max(1, limit)),
|
||||
appid: APP_ID,
|
||||
})
|
||||
if (!apiOk(body)) throw new Error(body?.errmsg || `千千歌单获取失败（errno ${body?.errno}）`)
|
||||
|
||||
const data = body?.data ?? {}
|
||||
const rawTracks = Array.isArray(data?.trackList) ? data.trackList : []
|
||||
const list = rawTracks.map((item: any) => mapTrack(item)).filter((song: any) => song.songmid)
|
||||
|
||||
const title = firstNonEmpty(data?.title, playlistId)
|
||||
const tagList = Array.isArray(data?.tagList) ? data.tagList : []
|
||||
const cover = firstNonEmpty(data?.pic, list[0]?.img)
|
||||
const creator = firstNonEmpty(data?.creator, data?.author, data?.userName, data?.nickName, data?.ownerName)
|
||||
const description = firstNonEmpty(data?.desc, data?.description) || tagList.join('、')
|
||||
const total = Number(data?.trackCount) || list.length
|
||||
|
||||
return {
|
||||
source: 'qian' as const,
|
||||
info: { id: playlistId, name: title, img: cover, desc: description, author: creator, link: playlistLink(playlistId) },
|
||||
list,
|
||||
page,
|
||||
limit,
|
||||
total,
|
||||
allPage: Math.ceil(total / Math.max(1, limit)) || 1,
|
||||
}
|
||||
}
|
||||
|
||||
/** 上游 GetPlaylistSongs：只取曲目列表 */
|
||||
export const getPlaylistSongs = async(id: string) => {
|
||||
const { list } = await getPlaylistDetail(id, 1, 1000)
|
||||
return list
|
||||
}
|
||||
|
||||
/**
|
||||
* 上游 GetPlaylistCategories
|
||||
* 返回 { source, list: [{ id, name, group, count }] }，首项为 "全部"（id=''）。
|
||||
*/
|
||||
export const getCategories = async() => {
|
||||
const body = await apiGet('/v1/tracklist/category', { appid: APP_ID })
|
||||
if (!apiOk(body)) throw new Error(body?.errmsg || `千千歌单分类获取失败（errno ${body?.errno}）`)
|
||||
|
||||
const list: Array<{ id: string; name: string; group: string; count?: number }> = [
|
||||
{ id: '', name: '全部', group: '全部' },
|
||||
]
|
||||
for (const group of Array.isArray(body?.data) ? body.data : []) {
|
||||
const groupName = String(group?.categoryName ?? '').trim()
|
||||
for (const item of Array.isArray(group?.subCate) ? group.subCate : []) {
|
||||
const id = String(item?.id ?? '').trim()
|
||||
const name = String(item?.categoryName ?? '').trim()
|
||||
if (!id || !name) continue
|
||||
list.push({ id, name, group: groupName, count: Number(item?.count ?? 0) || 0 })
|
||||
}
|
||||
}
|
||||
return { source: 'qian' as const, list }
|
||||
}
|
||||
|
||||
/** 上游 GetCategoryPlaylists（page >= 1，limit 1..100） */
|
||||
export const getCategoryPlaylists = async(categoryId: string | number, page = 1, limit = 30) => {
|
||||
const cateId = String(categoryId ?? '').trim()
|
||||
const pageNo = Math.max(1, Number(page) || 1)
|
||||
const pageSize = Math.min(100, Math.max(1, Number(limit) || 30))
|
||||
|
||||
const params: Record<string, any> = { appid: APP_ID, pageNo: String(pageNo), pageSize: String(pageSize) }
|
||||
if (cateId) params.subCateId = cateId
|
||||
|
||||
const body = await apiGet('/v1/tracklist/list', params)
|
||||
if (!apiOk(body)) throw new Error(body?.errmsg || `千千分类歌单获取失败（errno ${body?.errno}）`)
|
||||
|
||||
const result = Array.isArray(body?.data?.result) ? body.data.result : []
|
||||
const list = result
|
||||
.map((item: any) => ({ ...mapPlaylistSummary(item), categoryId: cateId }))
|
||||
.filter((item: any) => item.id)
|
||||
return {
|
||||
source: 'qian' as const,
|
||||
list,
|
||||
total: Number(body?.data?.total) || list.length,
|
||||
page: pageNo,
|
||||
limit: pageSize,
|
||||
}
|
||||
}
|
||||
|
||||
/** 上游 ParsePlaylist：songlist/tracklist/playlist 链接、*id= 参数、或裸歌单 id */
|
||||
export const parsePlaylistLink = async(link: string) => {
|
||||
const raw = String(link ?? '').trim()
|
||||
const patterns = [
|
||||
/music\.91q\.com\/(?:songlist|tracklist|playlist)\/([A-Za-z0-9]+)/,
|
||||
/(?:songlistid|tracklistid|playlistid|id)=([A-Za-z0-9]+)/,
|
||||
]
|
||||
for (const pattern of patterns) {
|
||||
const match = pattern.exec(raw)
|
||||
if (match) return getPlaylistDetail(match[1])
|
||||
}
|
||||
if (raw && !raw.includes('/')) return getPlaylistDetail(raw)
|
||||
throw new Error('无效的千千歌单链接')
|
||||
}
|
||||
|
||||
export default {
|
||||
searchPlaylist,
|
||||
getPlaylistDetail,
|
||||
getPlaylistSongs,
|
||||
getCategories,
|
||||
getCategoryPlaylists,
|
||||
parsePlaylistLink,
|
||||
}
|
||||
Reference in new issue
Block a user