Music Events are now normal Fetcher APIs added
All APIs now return SmfError
Canceling Request now supported
Music Search now based on category
Providerinfo added in DSM
Added secondary ID, count, location to SMFAlbum
Tags for Artist added
Get tracks for album and artist added
Added URL to subtitle
DSM Bug fixes
Detailed debugging logs filtered in server, pluginmgr, transportmgr
playlistsOf() method changed in smfclient and plugin interfaces.
RVCT B686 compilation issues resolved.
/**
* 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 music profile class represents a user's profile in music site
*
*/
#ifndef SMFMUSICPROFILE_H_
#define SMFMUSICPROFILE_H_
#include <qdatastream.h>
#include <QSharedData>
#include <QMetaType>
#include "smftrackinfo.h"
#include "smfevent.h"
#include "smfclientglobal.h"
class SmfMusicProfilePrivate;
/*
* Implementation constants
*/
const int SmfMusicProfileMaxSize = 20000;
/**
* @ingroup smf_common_group
* The music profile class represents a user's profile in music site
*/
class SMFCOMMON_EXPORT SmfMusicProfile
{
public:
/**
* Constructor with default argument
*/
SmfMusicProfile( );
/**
* Copy Constructor
* @param aOther The reference object
*/
SmfMusicProfile( const SmfMusicProfile &aOther );
/**
* Overloaded = operator
* @param aOther The reference object
*/
SmfMusicProfile& operator=( const SmfMusicProfile &aOther );
/**
* Destructor
*/
~SmfMusicProfile( );
/**
* Method to get the user's most recently heard tracks
* @return The users most recently heard tracks
*/
QList<SmfTrackInfo> recentTracks( ) const;
/**
* Method to get the user's favorite tracks e.g. could be user.getLovedTracks for last.fm
* @return The users favorite track list
*/
QList<SmfTrackInfo> favorites( ) const;
/**
* Method to get a list of upcoming events that this user is attending
* @return The list of upcoming events
*/
QList<SmfEvent> userEvents( ) const;
/**
* Method to get the service specific id of this user
* @return The ID value
*/
QString id( ) const;
/**
* Method to set the user's recent tracks
* @param aUsage The users new track list
*/
void setRecentTracks( const QList<SmfTrackInfo>& aUsage );
/**
* Method to set the user's favorite tracks
* @param aInterest The users new favorite track list
*/
void setFavorites( const QList<SmfTrackInfo>& aInterest );
/**
* Method to set the user events as list of SmfEvents
* @param aList The list of events
*/
void setUserEvents( const QList<SmfEvent> &aList );
/**
* Method to set the id of the music profile
* @param aId The ID value
*/
void setId( const QString &aId );
private:
QSharedDataPointer<SmfMusicProfilePrivate> d;
friend QDataStream &operator<<( QDataStream &aDataStream,
const SmfMusicProfile &aProfile );
friend QDataStream &operator>>( QDataStream &aDataStream,
SmfMusicProfile &aProfile );
};
/**
* Method for Externalization. Writes the SmfMusicProfile object to
* the stream and returns a reference to the stream.
* @param aDataStream Stream to be written
* @param aProfile The SmfMusicProfile object to be externalized
* @return reference to the written stream
*/
SMFCOMMON_EXPORT QDataStream &operator<<( QDataStream &aDataStream,
const SmfMusicProfile &aProfile );
/**
* Method for Internalization. Reads a SmfMusicProfile object from
* the stream and returns a reference to the stream.
* @param aDataStream Stream to be read
* @param aProfile The SmfMusicProfile object to be internalized
* @return reference to the stream
*/
SMFCOMMON_EXPORT QDataStream &operator>>( QDataStream &aDataStream,
SmfMusicProfile &aProfile);
typedef QList<SmfMusicProfile> SmfMusicProfileList;
// Make the class SmfMusicProfile known to QMetaType, so that as to register it.
Q_DECLARE_METATYPE(SmfMusicProfile)
Q_DECLARE_METATYPE(QList<SmfMusicProfile>)
#endif /* SMFMUSICPROFILE_H_ */