LeechCraft  0.6.70-10870-g558588d6ec
Modular cross-platform feature rich live environment.
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 134 of file ilyricsfinder.h.

Constructor & Destructor Documentation

◆ ~ILyricsFinder()

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

Definition at line 137 of file ilyricsfinder.h.

Member Function Documentation

◆ gotLyrics()

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.

◆ RequestLyrics()

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: