// Copyright (c) 2007-2009 Nokia Corporation and/or its subsidiary(-ies).
// All rights reserved.
// This component and the accompanying materials are made available
// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
// which accompanies this distribution, and is available
// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
//
// Initial Contributors:
// Nokia Corporation - initial contribution.
//
// Contributors:
//
// Description:
//



/**
 @file
 @publishedAll
 @released
*/

#ifndef REMCONMEDIAINFORMATIONTARGETOBSERVER_H
#define REMCONMEDIAINFORMATIONTARGETOBSERVER_H

#include <e32base.h>

enum TMediaAttributeId
	{
	ETitleOfMedia 			=0x1,
	ENameOfArtist			=0x2,
	ENameOfAlbum			=0x3,
	ETrackNumber			=0x4,		/* for example the CD track number */
	ENumberOfTracks			=0x5,		/* for example the total track number of the CD */
	EGenre					=0x6,
	EPlayingTime			=0x7
	};

/**
 * Provide an iterator wrapper class 
 */
class TMediaAttributeIter
	{
public:
	TMediaAttributeIter(RArray<TMediaAttributeId>& aMediaAttributeIDs);
	IMPORT_C void Start();
	IMPORT_C TBool Next(TMediaAttributeId& aId);
	
private:
	RArray<TMediaAttributeId>& iMediaAttributeIDs;
	TInt iterator;
	};


/**
Clients must implement this interface in order to instantiate objects of type 
CRemConMediaInformationTarget. This interface passes incoming commands from RemCon to 
the client. 
*/
NONSHARABLE_CLASS(MRemConMediaInformationTargetObserver)
	{
public:

	/**
	For each element in aAttributeList for which the requested Metadata is available,
	the client shall respond by calling CRemConMediaInformationTarget::AttributeValue(). 
	After all attributes have been supplied the client shall call CRemConMediaInformationTarget::Completed().
	@param aAttributeList A CMediaAttributeIDs containing a list of TMediaAttributeIds requested by the controller
	@see CRemConMediaInformationTarget::AttributeValue()
	@see CRemConMediaInformationTarget::Completed()
	*/
	virtual void MrcmitoGetCurrentlyPlayingMetadata( TMediaAttributeIter& aAttributeIter ) = 0;

	};

#endif // REMCONMEDIAINFORMATIONTARGETOBSERVER_H