lyrics-search 0.2.0

Lyrics search functionality for various platforms
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136

use serde::Deserialize;

#[derive(Debug, Clone, Deserialize)]
pub(crate) struct SearchResponse {
    #[serde(rename = "status_code")]
    #[allow(dead_code)]
    pub(crate) status_code: Option<i32>,
    #[serde(rename = "result_groups")]
    pub(crate) result_groups: Option<Vec<ResultGroup>>,
}

#[derive(Debug, Clone, Deserialize)]
pub(crate) struct ResultGroup {
    pub(crate) data: Option<Vec<ResultGroupItem>>,
}

#[derive(Debug, Clone, Deserialize)]
pub(crate) struct ResultGroupItem {
    pub(crate) meta: Option<Meta>,
    pub(crate) entity: Option<Entity>,
}

#[derive(Debug, Clone, Deserialize)]
pub(crate) struct Meta {
    #[serde(rename = "item_type")]
    pub(crate) item_type: Option<String>,
}

#[derive(Debug, Clone, Deserialize)]
pub(crate) struct Entity {
    pub(crate) track: Option<Track>,
}

#[derive(Debug, Clone, Deserialize)]
pub(crate) struct Track {
    pub(crate) id: String,
    pub(crate) name: String,
    pub(crate) duration: Option<i64>,
    pub(crate) artists: Option<Vec<Artist>>,
    pub(crate) album: Option<Album>,
}

#[derive(Debug, Clone, Deserialize)]
pub(crate) struct Artist {
    pub(crate) name: String,
}

#[derive(Debug, Clone, Deserialize)]
pub(crate) struct Album {
    pub(crate) name: String,
}

/// 汽水音乐 H5 `seo_track` 接口返回（获取歌曲详情/歌词）
#[derive(Debug, Clone, Deserialize)]
pub struct TrackDetailResponse {
    #[serde(rename = "status_code")]
    #[allow(dead_code)]
    pub(crate) status_code: Option<i32>,
    #[serde(default)]
    pub(crate) lyric: Option<LyricData>,
    /// 歌曲信息，H5 接口可能只返回 `seo_track.track`，由 API 层回填。
    #[serde(default)]
    pub(crate) track: Option<Track>,
    /// 播放信息，H5 接口可能只返回 `seo_track.track_player`，由 API 层回填。
    #[serde(rename = "track_player", default)]
    #[allow(dead_code)]
    pub(crate) track_player: Option<TrackPlayer>,
    #[serde(rename = "seo_track", default)]
    pub(crate) seo_track: Option<SeoTrackDetail>,
}

/// H5 `seo_track` 字段
#[derive(Debug, Clone, Deserialize)]
pub struct SeoTrackDetail {
    #[serde(default)]
    pub(crate) track: Option<Track>,
    #[serde(rename = "track_player", default)]
    pub(crate) track_player: Option<TrackPlayer>,
}

/// 播放信息
#[derive(Debug, Clone, Deserialize)]
#[allow(dead_code)]
pub struct TrackPlayer {
    #[serde(rename = "expire_at", default)]
    pub(crate) expire_at: Option<i64>,
    #[serde(rename = "media_id", default)]
    pub(crate) media_id: Option<String>,
    #[serde(rename = "url_player_info", default)]
    pub(crate) url_player_info: Option<String>,
    #[serde(rename = "video_model", default)]
    pub(crate) video_model: Option<String>,
    #[serde(rename = "video_model_type", default)]
    pub(crate) video_model_type: Option<i32>,
}

/// 歌词数据
#[derive(Debug, Clone, Deserialize)]
#[allow(dead_code)]
pub struct LyricData {
    /// 歌词正文（LRC 格式）
    #[serde(default)]
    pub(crate) content: Option<String>,
    /// 歌词语言
    #[serde(default)]
    pub(crate) lang: Option<String>,
    /// 歌词类型（如 "lrc"）
    #[serde(rename = "type", default)]
    pub(crate) lyric_type: Option<String>,
    /// 各语言翻译
    #[serde(rename = "lang_translations", default)]
    pub(crate) lang_translations: Option<std::collections::HashMap<String, LyricTranslation>>,
    /// 简体中文翻译（来自 `translations.cn`）
    #[serde(default)]
    pub(crate) translations: Option<LyricTranslationData>,
}

/// 翻译歌词数据
#[derive(Debug, Clone, Deserialize)]
#[allow(dead_code)]
pub struct LyricTranslation {
    #[serde(default)]
    pub(crate) content: Option<String>,
    #[serde(default)]
    pub(crate) lang: Option<String>,
    #[serde(rename = "type", default)]
    pub(crate) translation_type: Option<String>,
}

/// 翻译数据包装（`translations` 字段）
#[derive(Debug, Clone, Deserialize)]
pub struct LyricTranslationData {
    /// 简体中文翻译
    #[serde(default)]
    pub(crate) cn: Option<String>,
}