Files
MusicServer/sdk/qian/index.ts
T
snowy-yang 33b96f92c4 feat(sdk): 新增咪咕/千千/JOOX/哔哩哔哩/5sing/Apple Music 六平台
平台注册表由 9 个扩到 15 个,同时补齐 sdk/types.ts 的类型与
OpenAPI 文档里的能力位声明。

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

为什么合并成一次提交:六平台共用同一份注册表与能力位声明,
拆开会产生互相引用、单独无法通过类型检查的中间态。
2026-10-03 00:26:32 +08:00

87 lines
3.0 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// 千千音乐(music.91q.com)平台模块
// 上游 music-lib/qianqian 的 Node/TS 移植。匿名可用面(2026-10-02 实测):
// 搜索(type=1)/ 专辑搜索+详情(type=3、album/info)/ 歌单详情+分类+分类歌单 /
// 歌词(song/info 返回 txt URL)/ 免费曲目 128k/320k/flac 明文直链(tracklink 签名通道)。
// 限制:
// - VIP/版权曲目 tracklink 无 path(需登录态会员 cookie),搜索保留但标记 payPlay;
// - 歌单关键词搜索(/v1/search?type=6)服务端已下线(errno 23001),searchPlaylist 返回空列表;
// - 上游 GetUserPlaylists 明确 Unsupported,本移植不提供 userPlaylist。
// 凭据:上游 New(cookie) 的 cookie 从 sdk/auth/store.ts 的 getCredentials('qian') 读取(可选)。
import qianApi from '../apis/qian.ts'
import musicSearch from './musicSearch.ts'
import lyric from './lyric.ts'
import { getSongInfo } from './musicInfo.ts'
import album from './album.ts'
import playlist from './playlist.ts'
import parse from './parse.ts'
import { getQianCookie } from './util.ts'
const qian = {
musicSearch,
getMusicUrl(songInfo, type) {
return qianApi.getMusicUrl(songInfo, type)
},
getLyric(songInfo) {
return lyric.getLyric(songInfo)
},
// 千千无独立封面接口;搜索结果/专辑/歌单均自带 pic,缺失时回退 song/info
async getPic(songInfo) {
if (songInfo?.img) return songInfo.img
try {
const info = await getSongInfo(String(songInfo?.songmid ?? ''))
return info?.img || null
} catch {
return null
}
},
getMusicInfo(songInfo) {
return getSongInfo(String(songInfo?.songmid ?? ''))
},
getMusicDetailPageUrl(songInfo) {
const tsid = String(songInfo?.songmid ?? '').trim()
return tsid ? `https://music.91q.com/song/${tsid}` : 'https://music.91q.com/'
},
album: {
getAlbumDetail: album.getAlbumDetail,
searchAlbum: album.searchAlbum,
parseAlbumLink: album.parseAlbumLink,
},
// MusicServer 的 songList 契约:getList(sortId, tagId, page) / getTags()
// 千千无“榜单”概念,这里以歌单分类作为标签体系(tagId 为 /v1/tracklist/category 的 subCate id)
songList: {
getList(sortId, tagId, page = 1) {
const cate = String(tagId || sortId || '').trim()
return playlist.getCategoryPlaylists(/^\d+$/.test(cate) ? cate : '', page, 30)
},
getTags() {
return playlist.getCategories()
},
},
playlist: {
searchPlaylist: playlist.searchPlaylist,
getPlaylistDetail: playlist.getPlaylistDetail,
getPlaylistSongs: playlist.getPlaylistSongs,
getCategories: playlist.getCategories,
getCategoryPlaylists: playlist.getCategoryPlaylists,
parsePlaylistLink: playlist.parsePlaylistLink,
},
parse,
}
/** 凭据存在性(cookie 仅用于 VIP/登录态资源,匿名不影响搜索与免费取流) */
export const status = () => {
const cookie = getQianCookie()
return cookie ? { logged: true } : { logged: false }
}
export default qian