1 #pragma once 2 #include "IconMgr.h" 3 #include "MediaLibHelper.h" 4 5 enum ListType 6 { 7 LT_FOLDER, 8 LT_PLAYLIST, 9 LT_MEDIA_LIB, 10 LT_MAX, 11 12 // 以下项目仅用来构造CListCache时表示某个列表集合，不能出现在其他情况下 13 14 LT_RECENT, // 最近播放的列表 15 LT_PLAYLIST_NO_SPEC, // 除特殊播放列表外的播放列表 16 LT_CURRENT, // 当前播放列表 17 LT_ALL 18 }; 19 20 // ListItem描述一个“作为列表的可播放对象”的全部信息 21 struct ListItem 22 { 23 ListType type{}; // 此列表的类型 24 wstring path; // 路径 (媒体库模式存储具体项目名) 25 SortMode sort_mode{ SM_UNSORT }; // 此列表中音频的排序方式 26 SongKey last_track{}; // 最后播放到的曲目 27 int last_position{}; // 最后播放到的位置 28 int total_time{}; // 此列表中音频文件的总时长 29 int total_num{}; // 此列表中音频文件的数量 30 uint64_t last_played_time{}; // 上次播放的时间 (time_t) 31 uint64_t create_time{}; // 创建/添加时间 (time_t) 32 33 // 媒体库列表时存储列表种类 否则应保持默认 34 // 例如medialib_type为CT_ARTIST，则path字段储存的是艺术家的名称 35 // 特别的，CT_NONE表示所有曲目，此时path应留空 36 CMediaClassifier::ClassificationType medialib_type{}; 37 // 文件夹列表时存储是否包含子文件夹 否则应保持默认 38 bool contain_sub_folder{}; 39 ListItemListItem40 ListItem() {} 41 ListItem(ListType _type, wstring _path, CMediaClassifier::ClassificationType _medialib_type = {}); 42 43 bool operator==(const ListItem& other) const 44 { 45 return type == other.type && path == other.path && medialib_type == other.medialib_type; 46 } 47 bool operator<(const ListItem& other) const 48 { 49 return last_played_time > other.last_played_time; 50 } emptyListItem51 bool empty() const 52 { 53 return type == 0 && path.empty(); 54 } 55 56 // 为此ListItem设置打开时要播放的曲目，覆盖掉最后播放到的曲目 57 void SetPlayTrack(const SongKey& song_key, int position = 0) 58 { 59 last_track = song_key; 60 last_position = position; 61 } 62 63 // 当sort_mode为默认初始值SM_UNSORT时返回项目类型应有的的默认排序方式代替SM_UNSORT 64 SortMode GetDefaultSortMode() const; 65 66 // 获取项目的类型名，例如：“文件夹”、“播放列表”、“艺术家”、“唱片集”等 67 wstring GetTypeDisplayName() const; 68 // 获取项目的类型对应的图标类型 69 IconMgr::IconType GetTypeIcon() const; 70 // 获取项目具体显示名称，对LT_FOLDER返回去掉结尾'\'的path 71 // LT_PLAYLIST返回文件名并处理特殊播放列表的名称转换“[默认]”、“[我喜欢的音乐]” 72 // LT_MEDIA_LIB返回项目名“path”并在需要时转换特殊情况“<未知艺术家>”、“<其他>”等 73 wstring GetDisplayName() const; 74 // 在媒体库查询此项目上次播放曲目的SongKey，返回其用于显示的名称 75 // 效率不太好，如需用于自绘UI需要在CListCache加一层缓存 76 wstring GetLastTrackDisplayName() const; 77 }; 78 79