lyrics-search 0.3.1

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

use serde::Deserialize;

#[derive(Debug, Clone, Deserialize)]
pub(crate) struct SearchResponse {
    pub(crate) result: Option<SearchResultData>,
    #[serde(rename = "code")]
    pub(crate) code: Option<i64>,
}

#[derive(Debug, Clone, Deserialize)]
pub(crate) struct SearchResultData {
    pub(crate) songs: Option<Vec<Song>>,
}

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

#[derive(Debug, Clone, Deserialize)]
pub(crate) struct Artist {
    // 上游用 Newtonsoft 解析，缺字段不会失败；这里同样容忍缺失。
    #[serde(rename = "id", default)]
    pub(crate) _id: i64,
    pub(crate) name: String,
}

#[derive(Debug, Clone, Deserialize)]
pub(crate) struct Album {
    #[serde(rename = "id", default)]
    pub(crate) _id: i64,
    pub(crate) name: String,
}

/// 网易云 eapi 单曲搜索响应，对应 C# `EapiSearchResult`。
#[derive(Debug, Clone, Deserialize)]
pub(crate) struct EapiSearchResponse {
    pub(crate) result: Option<EapiSearchResultData>,
    pub(crate) code: Option<i64>,
}

#[derive(Debug, Clone, Deserialize)]
pub(crate) struct EapiSearchResultData {
    pub(crate) songs: Option<Vec<EapiSong>>,
}

/// eapi 搜索返回的单曲，字段名与 web 接口不同，对应 C# `EapiSong`。
#[derive(Debug, Clone, Deserialize)]
pub(crate) struct EapiSong {
    pub(crate) id: i64,
    pub(crate) name: String,
    #[serde(rename = "ar")]
    pub(crate) artists: Vec<Artist>,
    #[serde(rename = "al")]
    pub(crate) album: Album,
    #[serde(rename = "dt")]
    pub(crate) duration: i64,
}

impl From<EapiSong> for Song {
    fn from(song: EapiSong) -> Self {
        Self {
            id: song.id,
            name: song.name,
            artists: song.artists,
            album: song.album,
            duration: song.duration,
        }
    }
}

impl From<EapiSearchResponse> for SearchResponse {
    fn from(response: EapiSearchResponse) -> Self {
        Self {
            result: response.result.map(|result| SearchResultData {
                songs: result
                    .songs
                    .map(|songs| songs.into_iter().map(Song::from).collect()),
            }),
            code: response.code,
        }
    }
}

/// 网易云音乐歌词响应。
#[derive(Debug, Clone, Deserialize)]
pub struct LyricsResponse {
    /// 响应状态码
    pub code: Option<i32>,
    /// 原文歌词
    pub lrc: Option<LyricContent>,
    /// 翻译歌词
    pub tlyric: Option<LyricContent>,
}

/// 网易云音乐歌词内容。
#[derive(Debug, Clone, Deserialize)]
pub struct LyricContent {
    /// LRC 格式歌词文本
    pub lyric: Option<String>,
}

/// 网易云音乐 eapi 逐字歌词响应，对应 C# `Api.GetLyricNew` 的返回体。
#[derive(Debug, Clone, Deserialize)]
pub(crate) struct SyllableLyricsResponse {
    /// 逐字歌词（YRC）
    pub(crate) yrc: Option<LyricContent>,
    /// 逐字翻译歌词（YRC）
    pub(crate) ytlrc: Option<LyricContent>,
    /// 逐字罗马音歌词（YRC）
    pub(crate) yromalrc: Option<LyricContent>,
}