/**************************************************************************************** * Copyright (c) 2009 Nikolaj Hald Nielsen * * Copyright (c) 2012 Matěj Laitl * * * * This program is free software; you can redistribute it and/or modify it under * * the terms of the GNU General Public License as published by the Free Software * * Foundation; either version 2 of the License, or (at your option) any later * * version. * * * * This program is distributed in the hope that it will be useful, but WITHOUT ANY * * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A * * PARTICULAR PURPOSE. See the GNU General Public License for more details. * * * * You should have received a copy of the GNU General Public License along with * * this program. If not, see . * ****************************************************************************************/ #ifndef METAMULTISOURCECAPABILITY_H #define METAMULTISOURCECAPABILITY_H #include "core/capabilities/Capability.h" class QUrl; namespace Capabilities { /** * A capability for tracks that can have several different source urls, such as * multiple fallback streams for a radio station. If one source url fails or finishes, * the track will automatically use the next one. It is also possible to get a list * of all urls that can be presented to the user so tha she can choose. * * @author Nikolaj Hald Nielsen */ class AMAROKCORE_EXPORT MultiSourceCapability : public Capability { Q_OBJECT public: MultiSourceCapability(); ~MultiSourceCapability() override; static Type capabilityInterfaceType() { return MultiSource; } /** * Return list of displayable urls in this MultiSource. Only for display * purposes, don't attempt to play these urls. */ virtual QStringList sources() const = 0; /** * Set current source. Does nothing if @param source is out of bounds. */ virtual void setSource( int source ) = 0; /** * Get index of the current source */ virtual int current() const = 0; /** * Return the url of the next source without actually advancing to it. * Returns empty url if the current source is the last one. */ virtual QUrl nextUrl() const = 0; Q_SIGNALS: void urlChanged( const QUrl &url ); }; } #endif