LeechCraft  0.6.70-13605-g8cd066ad6a
Modular cross-platform feature rich live environment.
iradiostationprovider.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 <memory>
33 #include <functional>
34 #include <variant>
35 #include <QMap>
36 #include <QMetaType>
37 #include <QtPlugin>
38 
39 class QModelIndex;
40 class QAbstractItemModel;
41 
42 namespace Media
43 {
44  class IRadioStation;
45  typedef std::shared_ptr<IRadioStation> IRadioStation_ptr;
46 
47  using ActionFunctor_f = std::variant<std::function<void (QModelIndex)>, std::function<void ()>>;
48 
53  enum RadioType
54  {
57  None,
58 
67 
75  GlobalTag,
76 
79  Predefined,
80 
93 
101  TracksList,
102 
107  SingleTrack,
108 
114  TracksRoot,
115 
122  };
123 
128  enum RadioItemRole
129  {
134  ItemType = Qt::UserRole + 1,
135 
140  RadioID,
141 
147  PluginID,
148 
163  TracksInfos,
164 
168 
172  };
173 
182  class Q_DECL_EXPORT IRadioStationProvider
183  {
184  public:
185  virtual ~IRadioStationProvider () {}
186 
200  virtual IRadioStation_ptr GetRadioStation (const QModelIndex& item, const QString& query) = 0;
201 
217  virtual QList<QAbstractItemModel*> GetRadioListItems () const = 0;
218 
221  virtual void RefreshItems (const QList<QModelIndex>&) = 0;
222  };
223 }
224 
226 
227 Q_DECLARE_INTERFACE (Media::IRadioStationProvider, "org.LeechCraft.Media.IRadioStationProvider/1.0")
Media::RadioItemRole
RadioItemRole
Custom user roles for the items in the model.
Definition: iradiostationprovider.h:127
Media::Predefined
A predefined radio station like an Icecast stream.
Definition: iradiostationprovider.h:78
Media::TracksInfos
The tracks list.
Definition: iradiostationprovider.h:162
QList
Definition: ianrulesstorage.h:34
Media::RadioID
The internal ID of the radio.
Definition: iradiostationprovider.h:139
Media::PluginID
The ID of the plugin for this radio item.
Definition: iradiostationprovider.h:146
Media::ActionFunctor
The callable functor for RadioAction.
Definition: iradiostationprovider.h:166
Media::RadioType
RadioType
Describes the type of a radio station.
Definition: iradiostationprovider.h:52
Media::SingleTrack
A single song.
Definition: iradiostationprovider.h:106
Media::MaxRadioRole
Maximum role.
Definition: iradiostationprovider.h:170
Media::IRadioStationProvider
Interface for plugins providing radio stations.
Definition: iradiostationprovider.h:181
Media::SimilarArtists
Radio of artists similar to a given one.
Definition: iradiostationprovider.h:65
Media::ActionFunctor_f
std::variant< std::function< void(QModelIndex)>, std::function< void()> > ActionFunctor_f
Definition: iradiostationprovider.h:46
Media
Definition: audiostructs.h:36
Q_DECLARE_METATYPE
Q_DECLARE_METATYPE(QVariantList *)
Media::ItemType
The type of this radio station.
Definition: iradiostationprovider.h:133
Media::None
No type (item doesn't correspond to a radio station).
Definition: iradiostationprovider.h:56
Media::RadioAction
An action.
Definition: iradiostationprovider.h:120
Media::IRadioStation_ptr
std::shared_ptr< IRadioStation > IRadioStation_ptr
A pointer to a shared instance of a IRadioStation.
Definition: iradiostation.h:135
Media::TracksList
A predefined list of single tracks, not a stream.
Definition: iradiostationprovider.h:100
Media::TracksRoot
A root for a list of SingleTrack or TracksList items.
Definition: iradiostationprovider.h:113
Media::CustomAddableStreams
A radio station that contains user-addable streams.
Definition: iradiostationprovider.h:91
Media::GlobalTag
Radio of a global tag like metalcore.
Definition: iradiostationprovider.h:74