/**

 * Copyright (c) 2010 Sasken Communication Technologies Ltd.

 * All rights reserved.

 * This component and the accompanying materials are made available

 * under the terms of the "Eclipse Public License v1.0"

 * which accompanies  this distribution, and is available

 * at the URL "http://www.eclipse.org/legal/epl-v10.html"

 *

 * Initial Contributors:

 * Chandradeep Gandhi, Sasken Communication Technologies Ltd - Initial contribution

 *

 * Contributors:

 * Manasij Roy, Nalina Hariharan

 *

 * Description:

 * Music related services

 *

 */

#ifndef SMFMUSIC_H

#define SMFMUSIC_H

#include <qcontactgeolocation.h>

#include <smfglobal.h>

#include <smfevent.h>

#include <smfsubtitle.h>

#include <smfmusicprofile.h>

#include <smflyrics.h>

#include <smfplaylist.h>

#include <smftrackinfo.h>

#include <smflocation.h>

#include <smfprovider.h>

class SmfMusicServicePrivate;

class SmfMusicSearchPrivate;

class SmfLyricsServicePrivate;

class SmfPlaylistServicePrivate;

class SmfMusicFingerPrint;

class SmfMusicRating;

class SmfComment;

using namespace QtMobility;

/**

 * @ingroup smf_client_group

 * Basic music service ("org.symbian.smf.client.music.service")

 */

class SMFCLIENT_EXPORT SmfMusicService : public QObject

	{

	Q_OBJECT

public:

	/**

	 * Constructs SmfMusicService.

	 * @param baseProvider The base provider info

	 */

	SmfMusicService ( SmfProvider* baseProvider = 0 );

	/**

	 * Destructor

	 */

	~SmfMusicService ( );

public slots:

	/**

	 */

	/**

	 * Asynchronously searches information about other service users for a particular venue

	 * When the list is big user can specify the page number and per page item data.

	 * If not supplied by the user default values are used.

	 * @param pageNum Page number to download, SMF_FIRST_PAGE denotes fresh query.

	 * @param perPage Item per page, default is SMF_ITEMS_PER_PAGE

	 */

						int perPage = SMF_ITEMS_PER_PAGE);

	/**

	 * Request for a custom operation. The signal customDataAvailable() is emitted 

	 * when the result is available.

	 * @param operationId OperationId

	 * @param customData Custom data to be sent

	 * Note:-Interpretation of operationId and customData is upto the concerned

	 * plugin and client application. service provider should provide some

	 * serializing-deserializing utilities for these custom data

	 */

signals:

	/**

	 * Notification on arrival of the self profile as result of userinfo().

	 * @param profile The self profile

	 */

	/**

	 * Notification on arrival of search info

	 */

			SmfError error, SmfResultPage resultPage );

	/**

	 * Signals availability of the result of the customRequest

	 * @param operationId The ID to be shared between clients and the plugin

	 * @param customData data

	 */

	void customDataAvailable( const int& operationId, QByteArray* customData );

	/**

	 * Signals availability of the result of the posting a track or a comment or a rating

	 */

	void postfinished ( SmfError error );

private:

	/**

	 * Gets the base provider info

	 */

	SmfProvider* getProvider() const;

// Friend Class

	friend class SmfMusicServicePrivate;

private:

	SmfProvider* m_baseProvider;

	SmfMusicServicePrivate* m_private;

	};

SMF_SERVICE_NAME(SmfMusicService, "org.symbian.smf.client.music.service\0.2")

/**

 * Provides service ("org.symbian.smf.client.music.search") for music search

 */

class SMFCLIENT_EXPORT SmfMusicSearch : public QObject

	{

	Q_OBJECT

public:

	/**

	 * Constructs SmfMusicSearch with base provider as arguement.

	 */

	SmfMusicSearch ( SmfProvider* baseProvider = 0 );

	/**

	 * Destructor

	 */

	~SmfMusicSearch();

public:

	/**

	 * Searches for music recommendations similar to a particulartrack asynchronously.

	 * The signal trackSearchAvailable() is emitted with SmfTrackInfoList

	 * once its arrived.

	 * When the list is big user can specify the page number and per page item data.

	 * If not supplied by the user default values are used.

	 * @param track The track for which similar recommendations need to be fetched.

	 * @param pageNum Page number to download, SMF_FIRST_PAGE denotes fresh query.

	 * @param perPage Item per page, default is SMF_ITEMS_PER_PAGE

	 */

			int perPage = SMF_ITEMS_PER_PAGE);

	/**

	 * Searches for tracks similar to a given track asynchronously.

	 * The signal trackSearchAvailable() is emitted with SmfTrackInfoList

	 * once its arrived.

	 * When the list is big user can specify the page number and per page item data.

	 * If not supplied by the user default values are used.

	 * @param track The search criteria, similar tracks are searched

	 * @param pageNum Page number to download, SMF_FIRST_PAGE denotes fresh query.

	 * @param perPage Item per page, default is SMF_ITEMS_PER_PAGE

	 */

			int perPage = SMF_ITEMS_PER_PAGE);

	/**

	 * Searches for a track having similar finger print asynchronously.

	 * The signal trackSearchAvailable() is emitted with SmfTrackInfoList

	 * once its arrived.

	 * @param signature The search criteria,signature to be searched for

	 * @param pageNum Page number to download, SMF_FIRST_PAGE denotes fresh query.

	 * @param perPage Item per page, default is SMF_ITEMS_PER_PAGE

	 */

			int perPage = SMF_ITEMS_PER_PAGE);

	/**

	 * Search information about where to buy this song from asynchronously.

	 * The signal storeSearchAvailable() is emitted with SmfProviderList once its arrived.

	 * @param track The search criteria for stores

	 * @param pageNum Page number to download, SMF_FIRST_PAGE denotes fresh query.

	 * @param perPage Item per page, default is SMF_ITEMS_PER_PAGE

	 */

			int perPage = SMF_ITEMS_PER_PAGE);

	/**

	 * Request for a custom operation. The signal customDataAvailable() is emitted 

	 * when the result is available.

	 * @param operationId OperationId

	 * @param customData Custom data to be sent

	 * Note:-Interpretation of operationId and customData is upto the concerned

	 * plugin and client application. service provider should provide some

	 * serializing-deserializing utilities for these custom data

	 */

signals:

	/**

	 * Note if number of tacks in the search is large, then it can download the list page by page.

	 * @param resultPage Page number info

	 */

	void trackSearchAvailable ( SmfTrackInfoList* result, 

			SmfError error, SmfResultPage resultPage);

	/**

	 *  Emitted when the search result for a store is available.

	 *  Note if number of tacks in the search is large, then it can download the list page by page.

	 *  @param resultPage Page number info

	 */

	void storeSearchAvailable ( SmfProviderList* result, 

			SmfError error, SmfResultPage resultPage );

	/**

	 * Signals availability of the result of the customRequest

	 * @param operationId The ID to be shared between clients and the plugin

	 * @param customData data

	 */

	void customDataAvailable( const int& operationId, QByteArray* customData );

private:

	/**

	 * Gets the base provider info

	 */

	SmfProvider* getProvider() const;

private:

	SmfProvider* m_baseProvider;

	SmfMusicSearchPrivate* m_private;

	friend class SmfMusicSearchPrivate;

	};

SMF_SERVICE_NAME(SmfMusicSearch, "org.symbian.smf.client.music.search\0.2")

/**

 * Provides service ("org.symbian.smf.client.music.playlist")

 *

 * Interface to a remote playlist service. This class

 * provides some basic functionality to allow applications

 * to interact with playlists in some music related service provider (e.g. last.fm).

 *

 * Note that branding information for the particular service implementation

 * is available from getProvider() API. See also:

 * SmfProvider::serviceName(), SmfProvider::serviceIcon()

 *

 * All of the functionality described here should be implemented by a service

 * specific plug-in object.

 *

 */

class SMFCLIENT_EXPORT SmfPlaylistService : public QObject

	{

	Q_OBJECT

public:

	/**

	 * Constructs SmfPlaylistService with base provider info

	 * Seeing as this is a plug-in implementation, these will realistically

	 * be generated by SMF factory of some kind

	 */

	SmfPlaylistService ( SmfProvider* baseProvider = 0 );

	/**

	 * Destructor

	 */

	~SmfPlaylistService ( );

public:

	/**

	 * Gets the list playlists for the logged-in user asynchronously.

	 * The signal playlistsListAvailable() signal is emitted with

	 * SmfPlaylistList once its arrived .

	 * When the list is big user can specify the page number and per page item data.

	 * If not supplied by the user default values are used.

	 * @param pageNum Page number to download, SMF_FIRST_PAGE denotes fresh query.

	 * @param perPage Item per page, default is SMF_ITEMS_PER_PAGE

	 */

			int perPage = SMF_ITEMS_PER_PAGE);

	/**

	 * Gets the list playlists for the given user asynchronously.

	 * The signal playlistsListAvailable() signal is emitted with

	 * SmfPlaylistList once its arrived.

	 * When the list is big user can specify the page number and per page item data.

	 * If not supplied by the user default values are used.

	 * @param user User for which to get the playlists

	 * @param pageNum Page number to download, SMF_FIRST_PAGE denotes fresh query.

	 * @param perPage Item per page, default is SMF_ITEMS_PER_PAGE

	 */

			int perPage = SMF_ITEMS_PER_PAGE);

public slots:

	/**

	 * Upload currently playing track to a playlist. Signal

	 * playlistUpdated() can be checked for success value

	 * @param plst The playlist to be added in

	 * @param tracks The list of tracks to uploaded

	 */

	/**

	 * Upload currently playing playlist . Signal

	 * playlistUpdated() can be checked for success value

	 * @param plst The playlist to be uploaded

	 */

	/**

	 * Request for a custom operation. The signal customDataAvailable() is emitted 

	 * when the result is available.

	 * @param operationId OperationId