Files
MusicServer/sdk/joox/song.ts
T
snowy-yang e1357dd412 refactor(api)!: 平台 id 回退——joox/5sing/bili/apple 恢复全名,目录对齐 bd/mg
- 撤销 3381e9b/1b972ec 中 jx/5s/bl/ap 四个短码,恢复 joox/5sing/bili/apple;
  qian→bd、migu→mg 保留
- 目录与文件对齐保留的新 id:sdk/qian/→sdk/bd/、sdk/migu/→sdk/mg/、
  sdk/apis/qian.ts→bd.ts、migu.ts→mg.ts、src/http/migu-stream.ts→mg-stream.ts
  (规则改为「目录=对外 id」,聚合入口的模块变量同步更名;music.migu.cn 等域名、
  上游 music-lib 对照注释、miguGet 等功能标识符不动)
- 对外 id 全表:kw kg tx wy qs xm me qt lr mg bd joox 5sing bili apple

**破坏性变更**:joox/5sing/bili/apple 四平台的 URL、/sources 返回与
data/auth.json 凭据键恢复全名,已存短码键的登录态需重新登录。

验证:typecheck ✓、pnpm test 112/112 ✓
2026-10-03 21:04:55 +08:00

74 lines
2.5 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.
// JOOX 歌曲形状映射(统一 Song 形状,见 tmp/port-spec.md)
// 兼容来源:openjoox2 track/album/playlist 条目、openjoox v3 search 的 song_info、
// 以及 SSR 页面上的 track 条目(字段有 snake/camel 两套命名,上游 Go 也两套都兜底)。
import { formatPlayTime } from '../common/utils.ts'
import {
normalizeJooxID,
pickJooxImage,
jooxArtists,
firstNonEmpty,
firstNonZero,
} from './util.ts'
/** 详情/列表 track 条目 → 统一 Song 形状 */
export const jooxSongFromTrack = (
item: any,
fallbackAlbum = '',
fallbackCover = '',
fallbackAlbumId = '',
): any | null => {
const songmid = normalizeJooxID(item?.id)
if (!songmid) return null
const artists = Array.isArray(item?.artist_list) && item.artist_list.length
? item.artist_list
: item?.artistList
const albumId = normalizeJooxID(firstNonEmpty(item?.album_id, item?.albumId, fallbackAlbumId))
return {
songmid,
name: String(firstNonEmpty(item?.name, item?.title, 'Unknown')),
singer: String(firstNonEmpty(jooxArtists(artists), 'Unknown')),
albumId: String(albumId || ''),
albumName: String(firstNonEmpty(item?.album_name, item?.albumName, fallbackAlbum)),
interval: formatPlayTime(firstNonZero(item?.play_duration, item?.playDuration, item?.duration)),
img: String(firstNonEmpty(
pickJooxImage(item?.images),
item?.imgSrc,
item?.cover,
item?.image,
item?.pic,
fallbackCover,
)) || null,
lrc: null,
vip: Number(item?.vip_flag ?? 0) === 1,
types: [],
_types: {},
source: 'joox' as const,
}
}
/** openjoox v3 搜索歌曲条目(song_info)→ 统一 Song 形状 */
export const jooxSongFromSearch = (info: any): any | null => jooxSongFromTrack(info)
/** 详情接口返回的整曲信息(parse 用,含可播放地址)→ 统一 Song 形状 */
export const jooxSongFromDetail = (detail: any, playUrl = ''): any => {
const song = jooxSongFromTrack(detail) ?? {
songmid: normalizeJooxID(detail?.id),
name: String(detail?.name ?? ''),
singer: String(jooxArtists(detail?.artist_list)),
albumId: String(normalizeJooxID(detail?.album_id)),
albumName: String(detail?.album_name ?? ''),
interval: formatPlayTime(firstNonZero(detail?.play_duration)),
img: String(pickJooxImage(detail?.images)) || null,
lrc: null,
types: [],
_types: {},
source: 'joox' as const,
}
if (playUrl) song.url = playUrl
song.vip = Number(detail?.vip_flag ?? 0) === 1
return song
}