mirror of
https://github.com/jxxghp/MoviePilot-Frontend.git
synced 2026-08-16 02:54:36 +08:00
112 lines
4.1 KiB
TypeScript
112 lines
4.1 KiB
TypeScript
import type { MediaInfo, MusicAlbumInfo, MusicArtistInfo, MusicEntityType } from '@/api/types'
|
||
import type { RouteLocationRaw } from 'vue-router'
|
||
|
||
export interface MusicRouteTarget {
|
||
source?: string
|
||
media_source?: string
|
||
media_id?: string | number
|
||
music_type?: MusicEntityType
|
||
title?: string
|
||
name?: string
|
||
year?: string | number
|
||
}
|
||
|
||
// 音乐体系中一位可跳转的艺术家
|
||
export interface MusicArtistLink {
|
||
name: string
|
||
id?: string
|
||
}
|
||
|
||
/** 返回音乐对象可用于路由和订阅的统一来源。 */
|
||
export function getMusicSource(item: MusicRouteTarget): string | undefined {
|
||
return item.source || item.media_source
|
||
}
|
||
|
||
/** 返回音乐候选在列表和状态缓存中的稳定身份。 */
|
||
export function getMusicKey(item: MusicRouteTarget): string {
|
||
const source = getMusicSource(item) || 'music'
|
||
const entity = item.music_type || 'recording'
|
||
return `${source}:${entity}:${item.media_id || `${item.title || item.name}-${item.year || ''}`}`
|
||
}
|
||
|
||
/** 构造专辑详情路由。 */
|
||
export function buildMusicAlbumRoute(albumId: string, title?: string, source = 'musicbrainz'): RouteLocationRaw {
|
||
return { path: '/music/album', query: { source, mediaid: albumId, title } }
|
||
}
|
||
|
||
/** 构造艺术家详情路由。 */
|
||
export function buildMusicArtistRoute(artistId: string, name?: string, source = 'musicbrainz'): RouteLocationRaw {
|
||
return { path: '/music/artist', query: { source, mediaid: artistId, title: name } }
|
||
}
|
||
|
||
/** 按音乐实体类型构造详情路由，缺少标准身份时回退到音乐搜索页。 */
|
||
export function buildMusicDetailRoute(item: MusicRouteTarget): RouteLocationRaw {
|
||
const source = getMusicSource(item)
|
||
const mediaId = item.media_id?.toString()
|
||
if (!source || !mediaId) {
|
||
return { path: '/music', query: { query: item.title || item.name } }
|
||
}
|
||
if (item.music_type === 'album') return buildMusicAlbumRoute(mediaId, item.title || item.name, source)
|
||
if (item.music_type === 'artist') return buildMusicArtistRoute(mediaId, item.name || item.title, source)
|
||
return {
|
||
path: '/music/detail',
|
||
query: {
|
||
source,
|
||
mediaid: mediaId,
|
||
title: item.title || item.name,
|
||
},
|
||
}
|
||
}
|
||
|
||
/** 构造音乐元数据身份对应的站点资源搜索路由。 */
|
||
export function buildMusicResourceRoute(
|
||
item: MediaInfo | MusicAlbumInfo,
|
||
sites: number[] = [],
|
||
): RouteLocationRaw | undefined {
|
||
// 艺术家是浏览入口，不是可直接下载的媒体实体。
|
||
if ((item as MusicRouteTarget).music_type === 'artist') return undefined
|
||
const source = getMusicSource(item as MusicRouteTarget)
|
||
if (!source || !item.media_id) return undefined
|
||
return {
|
||
path: '/resource',
|
||
query: {
|
||
keyword: `${source}:${item.media_id}`,
|
||
type: '音乐',
|
||
title: item.title,
|
||
year: item.year,
|
||
area: 'title',
|
||
result_type: 'torrent',
|
||
...(sites.length ? { sites: sites.join(',') } : {}),
|
||
},
|
||
}
|
||
}
|
||
|
||
/** 把音乐信息整理成可点击跳转的艺术家列表，ID 与名称按下标对应。 */
|
||
export function getMusicArtistLinks(
|
||
item?: Pick<MediaInfo, 'artists' | 'artist_ids' | 'artist'> | MusicAlbumInfo,
|
||
): MusicArtistLink[] {
|
||
if (!item) return []
|
||
const names = item.artists?.length ? item.artists : item.artist ? [item.artist] : []
|
||
return names.map((name, index) => {
|
||
const id = item.artist_ids?.[index]
|
||
return id ? { name, id } : { name }
|
||
})
|
||
}
|
||
|
||
/** 把秒数格式化为音乐展示使用的时长文本。 */
|
||
export function formatMusicDuration(seconds?: number): string {
|
||
if (!seconds || seconds <= 0) return ''
|
||
const hours = Math.floor(seconds / 3600)
|
||
const minutes = Math.floor((seconds % 3600) / 60)
|
||
const remainder = Math.floor(seconds % 60)
|
||
const paddedSeconds = remainder.toString().padStart(2, '0')
|
||
if (!hours) return `${minutes}:${paddedSeconds}`
|
||
return `${hours}:${minutes.toString().padStart(2, '0')}:${paddedSeconds}`
|
||
}
|
||
|
||
/** 返回艺术家卡片和详情页展示用的副标题。 */
|
||
export function getMusicArtistSubtitle(artist?: MusicArtistInfo): string {
|
||
if (!artist) return ''
|
||
return [artist.relation, artist.artist_type, artist.disambiguation].filter(Boolean).join(' · ')
|
||
}
|