LeechCraft  0.6.70-3565-g2d86529
Modular cross-platform feature rich live environment.
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
Media::ILyricsFinder Class Referenceabstract

Interface for plugins supporting finding lyrics. More...

#include "ilyricsfinder.h"

Public Member Functions

virtual ~ILyricsFinder ()
 
virtual void RequestLyrics (const LyricsQuery &query, QueryOptions options=NoOption)=0
 Requests searching for lyrics for the given query. More...
 

Protected Member Functions

virtual void gotLyrics (const LyricsResults &results)=0
 Emitted when search for lyrics is complete. More...
 

Detailed Description

Interface for plugins supporting finding lyrics.

Plugins that support searching for lyrics should implement this interface.

Fetching lyrics is asynchronous in nature, so one should request fetching the lyrics via RequestLyrics() method and wait for the gotLyrics() signal with the corresponding query parameter.

Todo:
Consider migrating to handle-based results, like for IArtistBioFetcher.

Definition at line 144 of file ilyricsfinder.h.

Constructor & Destructor Documentation

virtual Media::ILyricsFinder::~ILyricsFinder ( )
inlinevirtual

Definition at line 147 of file ilyricsfinder.h.

Member Function Documentation

virtual void Media::ILyricsFinder::gotLyrics ( const LyricsResults results)
protectedpure virtual

Emitted when search for lyrics is complete.

It is OK to emit this signal multiple times for a single query.

Parameters
[out]resultsThe results of the lyrics query, containing the original query and the actual results.
virtual void Media::ILyricsFinder::RequestLyrics ( const LyricsQuery query,
QueryOptions  options = NoOption 
)
pure virtual

Requests searching for lyrics for the given query.

Parameters
[in]queryThe lyrics query.
[in]optionsAdditional search options.

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