--- a/smf/inc/smfclient/smfmusic.h Tue May 18 17:33:55 2010 +0530
+++ /dev/null Thu Jan 01 00:00:00 1970 +0000
@@ -1,526 +0,0 @@
-/**
- * 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:
- * The SmfEvent class represents an event
- *
- */
-
-#ifndef SMFMUSIC_H
-#define SMMUSIC_H
-
-#include <QObject>
-
-#include <qmobilityglobal.h>
-#include <qgeopositioninfo.h>
-
-#include "smfglobal.h"
-#include "smfprovider.h"
-#include "smfcontact.h"
-#include "smfevent.h"
-
-class SmfProvider; //basic Smf service Provider info
-class SmfContact; // Smf contact
-class SmfMusicRating;//rating value from 0..31 - services would map accordingly
-class SmfMusicProfile; //user profile containing music usage and interest info, extends SmfContact
-class SmfTrackInfo; //id, title, album, artist, genre, tag, director,release year, rating, comment info
-class SmfMusicFingerPrint; //generation is not in scope of smf
-class SmfVenue;
-class SmfEvent;
-class SmfPlaylist;
-class SmfLyricsService;
-class SmfLyrics;
-class SmfSubtitle;
-class SmfSubtitleSearchFilter;
-
-typedef QList<SmfMusicProfile> SmfMusicProfileList;
-typedef QList<SmfTrackInfo> SmfTrackInfoList;
-typedef QList<SmfEvent> SmfEventsList;
-typedef QList<SmfProvider> SmfProviderList;
-typedef QList<SmfPlaylist> SmfPlaylistList;
-typedef QList<SmfVenue> SmfVenueList;
-typedef QList<SmfLyrics> SmfLyricsList;
-typedef QList<SmfSubtitle> SmfSubtitleList;
-/**
- * @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
- * Seeing as this is a plug-in implementation, these will realistically
- * be generated by SMF factory of some kind
- */
- SmfMusicService(SmfProvider* baseProvider = 0);
- ~SmfMusicService();
-
-public:
-
- /**
- * Gets self profile information asynchronously.
- * userInfoAvailable() signal is emitted with SmfMusicProfile when the info is arrived
- */
- void userinfo() ;
-
- /**
- * Asynchronously searches information about other service users for a particular venue
- * searchInfoAvailable() signal is emitted with SmfMusicProfileList when the info is 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
- */
- void searchUser(SmfVenue venue,int pageNum=SMF_FIRST_PAGE,int perPage=SMF_ITEMS_PER_PAGE) ;
-
- /**
- * Gets the base provider info
- */
- SmfProvider* getProvider() ;
-
-
-signals:
- /**
- * Notification on arrival of the self profile as result of userinfo().
- * @param profile The self profile
- */
- void userInfoAvailable(SmfMusicProfile* profile, QString error);
-
- void searchInfoAvailable(SmfMusicProfileList& profileList, QString error,SmfResultPage resultPage);
-private:
- SmfProvider* m_baseProvider;
-};
-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.
- * Seeing as this is a plug-in implementation, these will realistically
- * be generated by SMF factory of some kind
- */
-
- SmfMusicSearch(SmfProvider* baseProvider = 0);
- ~SmfMusicSearch();
-
-public:
- // Get the track listing - might be made asynchrnous later
-
- /**
- * 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
- */
- void recommendations(SmfTrackInfo track,int pageNum=SMF_FIRST_PAGE,int perPage=SMF_ITEMS_PER_PAGE) ; // basic list of track objects
-
- /**
- * 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
- */
- void tracks(SmfTrackInfo track,int pageNum=SMF_FIRST_PAGE,int perPage=SMF_ITEMS_PER_PAGE) ; // basic list of track objects
-
- /**
- * 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
- */
- void trackInfo(SmfMusicFingerPrint signature,int pageNum=SMF_FIRST_PAGE,int perPage=SMF_ITEMS_PER_PAGE) ; // search by fingerprint object
-
- /**
- * 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
- */
- void stores(SmfTrackInfo track,int pageNum=SMF_FIRST_PAGE,int perPage=SMF_ITEMS_PER_PAGE) ;
-
- //APIs to get/set base provider info (SmfProvider)
-
- /**
- * Gets the base provider info
- */
- SmfProvider* getProvider() ;
-
-
-public slots:
-
- /**
- * Posts currently playing track.
- * Success can be checked by checking the signal postFinished()
- * @param track Track to post
- */
- void postCurrentPlaying(SmfTrackInfo track) ;
- //int postRating(SmfTrackInfo track, SmfMusicRating rate) ;
- //int postComments(SmfTrackInfo track, SmfComment comment) ;
-
-signals:
- /**
- * Emitted when the search result for a track is available.
- * Note if number of tacks in the search is large, then it can download the list page by page.
- * In that case this signal is emitted multiple times.
- * @param resultPage Page number info
- */
- void trackSearchAvailable(SmfTrackInfoList* result, QString 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.
- * In that case this signal is emitted multiple times.
- * @param resultPage Page number info
- */
- void storeSearchAvailable(SmfProviderList* result, QString error, SmfResultPage resultPage);
-private:
- SmfProvider* m_baseProvider;
-};
-SMF_SERVICE_NAME(SmfMusicSearch, "org.symbian.smf.client.music.search\0.2")
-
-
-/**
- * Remote playlist
- */
-class SMFCLIENT_EXPORT SmfPlaylist : public QObject
- {
- Q_OBJECT
-
-public:
- SmfPlaylist();
- ~SmfPlaylist();
-
- /**
- * Gets tracks in the playlist
- */
- SmfTrackInfoList* getTrackList();
-
- /**
- * Gets playlist title
- */
- QString getPlayListTitle();
-
- /**
- * Gets the creation date
- */
- QDateTime getCreationDate();
-
- /**
- * Sets tracks in the playlist
- */
- void setTrackList(SmfTrackInfoList* trackList);
-
- /**
- * Sets playlist title
- */
- void setPlayListTitle(QString title);
-
- /**
- * Sets creation date
- */
- void setCreationDate(QDateTime time);
-
-private:
- SmfTrackInfoList* m_trackList;
- QString m_title;
- QDateTime m_creationDate;
- };
-
-
-/**
- * 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);
- ~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
- */
- void playlists(int pageNum=SMF_FIRST_PAGE,int perPage=SMF_ITEMS_PER_PAGE) ; // basic list of playlist objects
-
- /**
- * 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
- */
- void playlistsOf(SmfMusicProfile* user,int pageNum=SMF_FIRST_PAGE,int perPage=SMF_ITEMS_PER_PAGE) ;
-
- //APIs to get/set base provider info (SmfProvider)
-
- /**
- * Gets the base provider info
- */
- SmfProvider* getProvider() ;
-
-
-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
- */
- int addToPlaylist(SmfPlaylist plst, SmfTrackInfoList* tracks) ;
-
- /**
- * Upload currently playing playlist . Signal
- * playlistUpdated() can be checked for success value
- * @param plst The playlist to be uploaded
- */
- int postCurrentPlayingPlaylist(SmfPlaylist plst) ;
-
-
-signals:
- /**
- * Notification of availability of list of playlists requested.
- * Note if number of list is large, then it can download the list page by page.
- * In that case this signal is emitted multiple times.
- * @param resultPage Page number info
- */
- void playlistsListAvailable(SmfPlaylistList*, QString error, SmfResultPage resultPage);
- /**
- * Signals remote updation of playlist with success value
- */
- int playlistUpdated(bool success) ;
-private:
- SmfProvider* m_baseProvider;
-};
-SMF_SERVICE_NAME(SmfPlaylistService, "org.symbian.smf.client.music.playlist\0.2")
-
-
-/**
-* provides service ("org.symbian.smf.client.music.events")
-*/
-class SMFCLIENT_EXPORT SmfMusicEvents : public QObject
-{
- Q_OBJECT
-
-public:
- /**
- * Constructs SmfMusicEvents with base provider info
- * Seeing as this is a plug-in implementation, these will realistically
- * be generated by SMF factory of some kind
- */
- SmfMusicEvents(SmfProvider* baseProvider = 0);
- ~SmfMusicEvents();
-
-public:
-
- /**
- * Gets list of events in a particular location asynchronously.
- * eventsAvailable() signal is emitted with SmfEventsList 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
- */
- void events(QtMobility::QContactGeolocation location,int pageNum=SMF_FIRST_PAGE,int perPage=SMF_ITEMS_PER_PAGE) ;
-
- /**
- * Gets list of venues of a particular location asynchronously.
- * venuesAvailable() signal is emitted with SmfVenueList 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
- */
- void venues(QtMobility::QContactGeolocation location,int pageNum=SMF_FIRST_PAGE,int perPage=SMF_ITEMS_PER_PAGE) ; // basic list of venue objects
-
- /**
- * Gets list of events in a particular venue asynchronously.
- * eventsAvailable() signal is emitted with SmfEventsList 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
- */
- void events(SmfVenue venue,int pageNum=SMF_FIRST_PAGE,int perPage=SMF_ITEMS_PER_PAGE) ; // basic list of events objects
-
-
- //APIs to get/set base provider info (SmfProvider)
-
- /**
- * Gets the base provider info
- */
- SmfProvider* getProvider() ;
-
-
-public slots:
-
- /**
- * Updates events. Might not be supported by all service provider.
- * eventsUpdated() signal can be checked for success value.
- * @param SmfEventsList List of events to be posted
- */
- void postEvents(SmfEventsList events);
-
-signals:
-
- /**
- * Notification of the success of request to post an event
- */
- void eventsUpdated(bool success);
-
- /**
- * Notification on arrival of event lists
- * Note if number of list is large, then it can download the list page by page.
- * In that case this signal is emitted multiple times.
- * @param resultPage Page number info
- */
- void eventsAvailable(SmfEventsList* list, QString error, SmfResultPage resultPage);
-
- /**
- * Notification on arrival of venues lists
- * Note if number of list is large, then it can download the list page by page.
- * In that case this signal is emitted multiple times.
- * @param resultPage Page number info
- */
- void venuesAvailable(SmfVenueList* list, QString error, SmfResultPage resultPage);
-private:
- SmfProvider* m_baseProvider;
-};
-SMF_SERVICE_NAME(SmfMusicEvents, "org.symbian.smf.client.music.events\0.2")
-
-
-/**
-* provides service ("org.symbian.smf.client.music.lyrics")
-*/
-class SMFCLIENT_EXPORT SmfLyricsService : public QObject
-{
- Q_OBJECT
-
-public:
- /**
- * Constructs SmfLyricsService with base provider info.
- * Seeing as this is a plug-in implementation, these will realistically
- * be generated by SMF factory of some kind
- */
-
- SmfLyricsService(SmfProvider* baseProvider = 0);
- ~SmfLyricsService();
-
-public:
-
- /**
- * Get the lyrics lists asynchrnously, it fetches texts without time info.
- * lyricsAvailable() notification comes SmfLyricsList with when the data is available
- * @param track Track for which lyrics needs 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
- */
- void lyrics(SmfTrackInfo track,int pageNum=SMF_FIRST_PAGE,int perPage=SMF_ITEMS_PER_PAGE) ;
-
- /**
- * Get the lyrics lists asynchrnously, it fetches texts with time info.
- * Subtitle search filter can be applied
- * subtitleAvailable() notification comes SmfSubtitleList with when the data is available
- * @param track Track for which subtitle needs to be fetched.
- * @param filter Subtitle search filter
- * @param pageNum Page number to download, SMF_FIRST_PAGE denotes fresh query.
- * @param perPage Item per page, default is SMF_ITEMS_PER_PAGE
- */
- void subtitles(SmfTrackInfo track, SmfSubtitleSearchFilter filter,int pageNum=SMF_FIRST_PAGE,int perPage=SMF_ITEMS_PER_PAGE) ; // texts with time information
- //APIs to get/set base provider info (SmfProvider)
-
- /**
- * Gets the base provider info
- */
- SmfProvider* getProvider() ;
-
-
-public slots:
-
-
-signals:
-
- /**
- * Notification on arrival of lyrics
- * Note if the list is large, then it can download the list page by page.
- * In that case this signal is emitted multiple times.
- * @param resultPage Page number info
- */
- void lyricsAvailable(SmfLyricsList* list, QString error, SmfResultPage resultPage);
-
- /**
- * Notification on arrival of subtitle based on filter.
- * Note if the list is large, then it can download the list page by page.
- * In that case this signal is emitted multiple times.
- * @param resultPage Page number info
- */
- void subtitleAvailable(SmfSubtitleList* list, QString error, SmfResultPage resultPage);
-private:
- SmfProvider* m_baseProvider;
-};
-SMF_SERVICE_NAME(SmfLyricsService, "org.symbian.smf.client.music.lyrics\0.2")
-
-#endif // SMFMUSIC_H
-