LeechCraft  0.6.70-6645-gcd10d7e
Modular cross-platform feature rich live environment.
iaudiopile.h
Go to the documentation of this file.
1 /**********************************************************************
2  * LeechCraft - modular cross-platform feature rich internet client.
3  * Copyright (C) 2006-2014 Georg Rudoy
4  *
5  * Boost Software License - Version 1.0 - August 17th, 2003
6  *
7  * Permission is hereby granted, free of charge, to any person or organization
8  * obtaining a copy of the software and accompanying documentation covered by
9  * this license (the "Software") to use, reproduce, display, distribute,
10  * execute, and transmit the Software, and to prepare derivative works of the
11  * Software, and to permit third-parties to whom the Software is furnished to
12  * do so, all subject to the following:
13  *
14  * The copyright notices in the Software and this entire statement, including
15  * the above license grant, this restriction and the following disclaimer,
16  * must be included in all copies of the Software, in whole or in part, and
17  * all derivative works of the Software, unless such copies or derivative
18  * works are solely in the form of machine-executable object code generated by
19  * a source language processor.
20  *
21  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
22  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
23  * FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
24  * SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
25  * FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
26  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
27  * DEALINGS IN THE SOFTWARE.
28  **********************************************************************/
29 
30 #pragma once
31 
32 #include <QString>
33 #include "audiostructs.h"
34 
35 class QObject;
36 class QIcon;
37 
38 namespace Media
39 {
59  class Q_DECL_EXPORT IPendingAudioSearch
60  {
61  public:
62  virtual ~IPendingAudioSearch () {}
63 
71  virtual QObject* GetQObject () = 0;
72 
75  struct Result
76  {
80 
83  QUrl Source_;
84  };
85 
94  virtual QList<Result> GetResults () const = 0;
95  protected:
101  virtual void ready () = 0;
102 
111  virtual void error () = 0;
112  };
113 
124  {
129  QString Title_;
130 
135  QString Artist_;
136 
139  QString Album_;
140 
146 
152  QString FreeForm_;
153 
157  : TrackLength_ (0)
158  {
159  }
160  };
161 
168  class Q_DECL_EXPORT IAudioPile
169  {
170  public:
171  virtual ~IAudioPile () {}
172 
180  virtual QString GetServiceName () const = 0;
181 
189  virtual QIcon GetServiceIcon () const = 0;
190 
201  virtual IPendingAudioSearch* Search (const AudioSearchRequest& request) = 0;
202  };
203 }
204 
205 Q_DECLARE_INTERFACE (Media::IPendingAudioSearch, "org.LeechCraft.Media.IPendingAudioSearch/1.0");
206 Q_DECLARE_INTERFACE (Media::IAudioPile, "org.LeechCraft.Media.IAudioPile/1.0");
Interface for plugins supporting searching for tracks.
Definition: iaudiopile.h:168
int TrackLength_
The approximate length of the track.
Definition: iaudiopile.h:145
virtual ~IPendingAudioSearch()
Definition: iaudiopile.h:62
Describes a single audio track.
Definition: audiostructs.h:40
QString Album_
The album containing this track.
Definition: iaudiopile.h:139
QString FreeForm_
Free form engine-specific request.
Definition: iaudiopile.h:152
A structure describing a single entry in search result.
Definition: iaudiopile.h:75
QString Artist_
The artist performing the track.
Definition: iaudiopile.h:135
virtual ~IAudioPile()
Definition: iaudiopile.h:171
QString Title_
The title of a track.
Definition: iaudiopile.h:129
QUrl Source_
The URL of this audio track.
Definition: iaudiopile.h:83
AudioInfo Info_
The information about the found audio track.
Definition: iaudiopile.h:79
Describes a request for an audio search in an IAudioPile.
Definition: iaudiopile.h:123
AudioSearchRequest()
Creates an empty audio search request.
Definition: iaudiopile.h:156
Q_DECLARE_INTERFACE(Media::IPendingAudioSearch,"org.LeechCraft.Media.IPendingAudioSearch/1.0")
Pending audio search handle.
Definition: iaudiopile.h:59