LeechCraft  %{LEECHCRAFT_VERSION}
Modular cross-platform feature rich live environment.
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Pages
Media::IDiscographyProvider Class Referenceabstract

Interface for plugins supporting getting artist discography. More...

#include "idiscographyprovider.h"

Public Member Functions

virtual ~IDiscographyProvider ()
 
virtual QString GetServiceName () const =0
 Returns the service name. More...
 
virtual IPendingDiscoGetDiscography (const QString &artist)=0
 Fetches all the discography of the given artist. More...
 
virtual IPendingDiscoGetReleaseInfo (const QString &artist, const QString &release)=0
 Fetches contents of the given release by the artist. More...
 

Detailed Description

Interface for plugins supporting getting artist discography.

Plugins that support fetching artists discography from sources like MusicBrainz should implement this interface.

Discography includes various types of releases (albums, EPs, singles, etc) as well as the corresponding lists of tracks in those releases.

Definition at line 176 of file idiscographyprovider.h.

Constructor & Destructor Documentation

virtual Media::IDiscographyProvider::~IDiscographyProvider ( )
inlinevirtual

Definition at line 179 of file idiscographyprovider.h.

Member Function Documentation

virtual IPendingDisco* Media::IDiscographyProvider::GetDiscography ( const QString &  artist)
pure virtual

Fetches all the discography of the given artist.

This function initiates a search for artist discography and returns a handle through which the results of the search could be obtained.

All known releases of this artist are returned through the handle.

The handle owns itself and deletes itself after results are available — see its documentation for details.

Parameters
[in]artistThe artist name.
Returns
The pending discography search handle.
virtual IPendingDisco* Media::IDiscographyProvider::GetReleaseInfo ( const QString &  artist,
const QString &  release 
)
pure virtual

Fetches contents of the given release by the artist.

This function initiates a search for the given release of the given artist and returns a handle through which the contents of the release can be obtained.

Only matching release is returned through the handle, or no releases if, well, no releases match.

The handle owns itself and deletes itself after results are available — see its documentation for details.

Parameters
[in]artistThe artist name.
[in]releaseThe release name to search for.
Returns
The pending discography search handle.
virtual QString Media::IDiscographyProvider::GetServiceName ( ) const
pure virtual

Returns the service name.

This string returns a human-readable string with the service name, like "MusicBrainz".

Returns
The human-readable service name.

The documentation for this class was generated from the following file: