/**************************************************************************************** * Copyright (c) 2007-2009 Bart Cerneels * * * * This program is free software; you can redistribute it and/or modify it under * * the terms of the GNU General Public License as published by the Free Software * * Foundation; either version 2 of the License, or (at your option) any later * * version. * * * * This program is distributed in the hope that it will be useful, but WITHOUT ANY * * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A * * PARTICULAR PURPOSE. See the GNU General Public License for more details. * * * * You should have received a copy of the GNU General Public License along with * * this program. If not, see . * ****************************************************************************************/ #ifndef PODCASTMETA_H #define PODCASTMETA_H #include "core/amarokcore_export.h" #include "core/meta/Meta.h" #include "core/playlists/Playlist.h" #include "core/support/Amarok.h" #include #include #include #include #include #include #include namespace Collections { class QueryMaker; } namespace Podcasts { class PodcastEpisode; class PodcastChannel; class PodcastArtist; class PodcastAlbum; class PodcastComposer; class PodcastGenre; class PodcastYear; typedef AmarokSharedPointer PodcastEpisodePtr; typedef AmarokSharedPointer PodcastChannelPtr; typedef QList PodcastEpisodeList; typedef QList PodcastChannelList; class AMAROKCORE_EXPORT PodcastMetaCommon { public: PodcastMetaCommon() {} virtual ~PodcastMetaCommon() {} virtual QString title() const { return m_title;} virtual QString description() const { return m_description; } virtual QStringList keywords() const { return m_keywords; } virtual QString subtitle() const { return m_subtitle; } virtual QString summary() const { return m_summary; } virtual QString author() const { return m_author; } virtual void setTitle( const QString &title ) { m_title = title; } virtual void setDescription( const QString &description ) { m_description = description; } virtual void setKeywords( const QStringList &keywords ) { m_keywords = keywords; } virtual void addKeyword( const QString &keyword ) { m_keywords << keyword; } virtual void setSubtitle( const QString &subtitle ) { m_subtitle = subtitle; } virtual void setSummary( const QString &summary ) { m_summary = summary; } virtual void setAuthor( const QString &author ) { m_author = author; } protected: QString m_title; //the title QString m_description; //a longer description, with HTML markup QStringList m_keywords; // TODO: save to DB QString m_subtitle; //a short description QString m_summary; QString m_author; // TODO: save to DB }; class AMAROKCORE_EXPORT PodcastEpisode : public PodcastMetaCommon, public Meta::Track { public: PodcastEpisode(); explicit PodcastEpisode( const PodcastChannelPtr &channel ); PodcastEpisode( const PodcastEpisodePtr &episode, const PodcastChannelPtr &channel ); ~PodcastEpisode() override {} // Meta::Base methods QString name() const override { return m_title; } // Meta::Track Methods QUrl playableUrl() const override { return m_localUrl.isEmpty() ? m_url : m_localUrl; } QString prettyUrl() const override { return playableUrl().toDisplayString(); } QString uidUrl() const override { return m_url.url(); } QString notPlayableReason() const override; Meta::AlbumPtr album() const override { return m_albumPtr; } Meta::ArtistPtr artist() const override { return m_artistPtr; } Meta::ComposerPtr composer() const override { return m_composerPtr; } Meta::GenrePtr genre() const override { return m_genrePtr; } Meta::YearPtr year() const override { return m_yearPtr; } qreal bpm() const override { return -1.0; } QString comment() const override { return QString(); } virtual void setComment( const QString &newComment ) { Q_UNUSED( newComment ); } qint64 length() const override { return m_duration * 1000; } int filesize() const override { return m_fileSize; } int sampleRate() const override { return 0; } int bitrate() const override { return 0; } int trackNumber() const override { return m_sequenceNumber; } virtual void setTrackNumber( int newTrackNumber ) { Q_UNUSED( newTrackNumber ); } int discNumber() const override { return 0; } virtual void setDiscNumber( int newDiscNumber ) { Q_UNUSED( newDiscNumber ); } virtual QString mimeType() const { return m_mimeType; } QString type() const override { const QString fileName = playableUrl().fileName(); return Amarok::extension( fileName ); } virtual void addMatchTo( Collections::QueryMaker* qm ) { Q_UNUSED( qm ); } bool inCollection() const override { return false; } QString cachedLyrics() const override { return QString(); } void setCachedLyrics( const QString &lyrics ) override { Q_UNUSED( lyrics ); } bool operator==( const Meta::Track &track ) const override; //PodcastMetaCommon methods void setTitle( const QString &title ) override { m_title = title; } //PodcastEpisode methods virtual QUrl localUrl() const { return m_localUrl; } virtual QDateTime pubDate() const { return m_pubDate; } virtual int duration() const { return m_duration; } virtual QString guid() const { return m_guid; } virtual bool isNew() const { return m_isNew; } virtual int sequenceNumber() const { return m_sequenceNumber; } virtual PodcastChannelPtr channel() const { return m_channel; } virtual void setLocalUrl( const QUrl &url ) { m_localUrl = url; } virtual void setFilesize( int fileSize ) { m_fileSize = fileSize; } virtual void setMimeType( const QString &mimeType ) { m_mimeType = mimeType; } virtual void setUidUrl( const QUrl &url ) { m_url = url; } virtual void setPubDate( const QDateTime &pubDate ) { m_pubDate = pubDate; } virtual void setDuration( int duration ) { m_duration = duration; } virtual void setGuid( const QString &guid ) { m_guid = guid; } virtual void setNew( bool isNew ) { m_isNew = isNew; } virtual void setSequenceNumber( int sequenceNumber ) { m_sequenceNumber = sequenceNumber; } virtual void setChannel( const PodcastChannelPtr &channel ) { m_channel = channel; } protected: PodcastChannelPtr m_channel; QString m_guid; //the GUID from the podcast feed QUrl m_url; //remote url of the file QUrl m_localUrl; //the localUrl, only valid if downloaded QString m_mimeType; //the mimetype of the enclosure QDateTime m_pubDate; //the pubDate from the feed int m_duration; //the playlength in seconds int m_fileSize; //the size tag from the enclosure int m_sequenceNumber; //number of the episode bool m_isNew; //listened to or not? //data members Meta::AlbumPtr m_albumPtr; Meta::ArtistPtr m_artistPtr; Meta::ComposerPtr m_composerPtr; Meta::GenrePtr m_genrePtr; Meta::YearPtr m_yearPtr; }; class AMAROKCORE_EXPORT PodcastChannel : public PodcastMetaCommon, public Playlists::Playlist { public: enum FetchType { DownloadWhenAvailable = 0, StreamOrDownloadOnDemand }; PodcastChannel() : PodcastMetaCommon() , Playlist() , m_image() , m_subscribeDate() , m_copyright() , m_autoScan( false ) , m_fetchType( DownloadWhenAvailable ) , m_purge( false ) , m_purgeCount( 0 ) { } explicit PodcastChannel(const PodcastChannelPtr &channel ); ~PodcastChannel() override {} //Playlist virtual methods QUrl uidUrl() const override { return m_url; } QString name() const override { return title(); } int trackCount() const override { return m_episodes.count(); } Meta::TrackList tracks() override; void addTrack( const Meta::TrackPtr &track, int position = -1 ) override; //PodcastMetaCommon methods // override this since it's ambiguous in PodcastMetaCommon and Playlist QString description() const override { return m_description; } //PodcastChannel methods virtual QUrl url() const { return m_url; } virtual QUrl webLink() const { return m_webLink; } virtual bool hasImage() const { return !m_image.isNull(); } virtual QUrl imageUrl() const { return m_imageUrl; } virtual QImage image() const { return m_image; } virtual QString copyright() const { return m_copyright; } virtual QStringList labels() const { return m_labels; } virtual QDate subscribeDate() const { return m_subscribeDate; } virtual void setUrl( const QUrl &url ) { m_url = url; } virtual void setWebLink( const QUrl &link ) { m_webLink = link; } // TODO: inform all albums with this channel of the changed image virtual void setImage( const QImage &image ) { m_image = image; } virtual void setImageUrl( const QUrl &imageUrl ) { m_imageUrl = imageUrl; } virtual void setCopyright( const QString ©right ) { m_copyright = copyright; } virtual void setLabels( const QStringList &labels ) { m_labels = labels; } virtual void addLabel( const QString &label ) { m_labels << label; } virtual void setSubscribeDate( const QDate &date ) { m_subscribeDate = date; } virtual Podcasts::PodcastEpisodePtr addEpisode( const PodcastEpisodePtr &episode ); virtual PodcastEpisodeList episodes() const { return m_episodes; } bool load( QTextStream &stream ) { Q_UNUSED( stream ); return false; } //PodcastChannel Settings QUrl saveLocation() const { return m_directory; } bool autoScan() const { return m_autoScan; } FetchType fetchType() const { return m_fetchType; } bool hasPurge() const { return m_purge; } int purgeCount() const { return m_purgeCount; } void setSaveLocation( const QUrl &url ) { m_directory = url; } void setAutoScan( bool autoScan ) { m_autoScan = autoScan; } void setFetchType( FetchType fetchType ) { m_fetchType = fetchType; } void setPurge( bool purge ) { m_purge = purge; } void setPurgeCount( int purgeCount ) { m_purgeCount = purgeCount; } protected: QUrl m_url; QUrl m_webLink; QImage m_image; QUrl m_imageUrl; QStringList m_labels; QDate m_subscribeDate; QString m_copyright; QUrl m_directory; //the local directory to save the files in. bool m_autoScan; //should this channel be checked automatically? PodcastChannel::FetchType m_fetchType; //'download when available' or 'stream or download on demand' bool m_purge; //remove old episodes? int m_purgeCount; //how many episodes do we keep on disk? PodcastEpisodeList m_episodes; }; // internal helper classes class AMAROKCORE_EXPORT PodcastArtist : public Meta::Artist { public: explicit PodcastArtist( PodcastEpisode *episode ) : Meta::Artist() , episode( episode ) {} Meta::TrackList tracks() override { return Meta::TrackList(); } Meta::AlbumList albums() { return Meta::AlbumList(); } QString name() const override { QString author; if( episode && episode->channel() ) author = episode->channel()->author(); return author; } bool operator==( const Meta::Artist &other ) const override { return name() == other.name(); } PodcastEpisode const *episode; }; class AMAROKCORE_EXPORT PodcastAlbum : public Meta::Album { public: explicit PodcastAlbum( PodcastEpisode *episode ) : Meta::Album() , episode( episode ) {} /* Its all a little bit stupid. When the channel image (and also the album image) changes the album get's no indication. Also the CoverCache is not in amarokcorelib but in amaroklib. Why the PodcastAlbum is the only one with a concrete implementation in amarokcorelib is another question. virtual ~PodcastAlbum() { CoverCache::invalidateAlbum( Meta::AlbumPtr(this) ); } */ bool isCompilation() const override { return false; } bool hasAlbumArtist() const override { return false; } Meta::ArtistPtr albumArtist() const override { return Meta::ArtistPtr(); } Meta::TrackList tracks() override { return Meta::TrackList(); } QString name() const override { if( episode != nullptr ) { const QString albumName = episode->channel()->title(); return albumName; } else return QString(); } QImage image( int size ) const override { // This is a little stupid. If Channel::setImage is called we don't Q_EMIT a MetaDataChanged or invalidate the cache QImage image = episode->channel()->image(); return image.scaledToHeight( size ); } bool operator==( const Meta::Album &other ) const override { return name() == other.name(); } PodcastEpisode const *episode; }; class AMAROKCORE_EXPORT PodcastGenre : public Meta::Genre { public: explicit PodcastGenre( PodcastEpisode *episode ) : Meta::Genre() , episode( episode ) {} Meta::TrackList tracks() override { return Meta::TrackList(); } QString name() const override { const QString genreName = i18n( "Podcast" ); return genreName; } bool operator==( const Meta::Genre &other ) const override { return name() == other.name(); } PodcastEpisode const *episode; }; class AMAROKCORE_EXPORT PodcastComposer : public Meta::Composer { public: explicit PodcastComposer( PodcastEpisode *episode ) : Meta::Composer() , episode( episode ) {} Meta::TrackList tracks() override { return Meta::TrackList(); } QString name() const override { if( episode != nullptr ) { const QString composer = episode->channel()->author(); return composer; } else return QString(); } bool operator==( const Meta::Composer &other ) const override { return name() == other.name(); } PodcastEpisode const *episode; }; class AMAROKCORE_EXPORT PodcastYear : public Meta::Year { public: explicit PodcastYear( PodcastEpisode *episode ) : Meta::Year() , episode( episode ) {} Meta::TrackList tracks() override { return Meta::TrackList(); } QString name() const override { if( episode != nullptr ) { const QString year = episode->pubDate().toString( QStringLiteral("yyyy") ); return year; } else return QString(); } bool operator==( const Meta::Year &other ) const override { return name() == other.name(); } PodcastEpisode const *episode; }; } //namespace Podcasts Q_DECLARE_METATYPE( Podcasts::PodcastMetaCommon* ) Q_DECLARE_METATYPE( Podcasts::PodcastEpisodePtr ) Q_DECLARE_METATYPE( Podcasts::PodcastEpisodeList ) Q_DECLARE_METATYPE( Podcasts::PodcastChannelPtr ) Q_DECLARE_METATYPE( Podcasts::PodcastChannelList ) #endif