// 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 "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:

// Nokia Corporation - initial contribution.

//

// Contributors:

//

// Description:

//

/**

 @file

 @publishedAll

 @released

*/

#ifndef REMCONPLAYERINFORMATIONTARGET_H

#define REMCONPLAYERINFORMATIONTARGET_H

#include <e32base.h>

#include <s32mem.h>

#include <e32hashtab.h>

#include <remcon/remconinterfacebase.h>

#include <remcon/remconinterfaceif.h>

#include <remcon/avrcpspec.h>

#include <playerinformationtargetobserver.h>

class CRemConInterfaceSelector;

class CPlayerApplicationSettings;

class TEventsMask;

// This is the maximum length of the player application setting attribute and value strings

const TInt KMaxPlayerApplicationSettingsValue = 255 ;

// This is the minimum length of the player application setting attribute and value strings

const TInt KMinPlayerApplicationSettingsValue = 1 ;

/**

Client-instantiable class supporting player information responses.

This is the container class for the three interface parts

*/

NONSHARABLE_CLASS(CPlayerInfoTarget) : 	public CRemConInterfaceBase,

								       	public MRemConInterfaceIf2, 

								       	private MPlayerCapabilitiesObserver,

										private MPlayerApplicationSettingsObserver,

										private MPlayerEventsObserver

	{

public:

	/**

	Factory function.

	@param aInterfaceSelector The interface selector. The client must have 

	created one of these first.

	@param aPlayerCapabilitiesObserver Returns a pointer to a MPlayerCapabilitiesObserver for this interface, owned by the CPlayerInfoTarget.

	@param aPlayerApplicationSettingsObserver Returns a pointer to a MPlayerApplicationSettingsObserver for this interface, owned by the CPlayerInfoTarget

	@param aPlayerEventsObserver Returns a pointer to a MPlayerEventsObserver for this interface, owned by the CPlayerInfoTarget

	@return A new CPlayerInfoTarget, owned by the interface selector.

	*/

	IMPORT_C static CPlayerInfoTarget* NewL(CRemConInterfaceSelector& aInterfaceSelector,

								       	MPlayerCapabilitiesObserver*& aPlayerCapabilitiesObserver,

										MPlayerApplicationSettingsObserver*& aPlayerApplicationSettingsObserver,

										MPlayerEventsObserver*& aPlayerEventsObserver,

										MPlayerApplicationSettingsNotify& aApplicationSettingNotifier );

	/** Destructor */

	IMPORT_C ~CPlayerInfoTarget();

private:

	/** 

	Constructor.

	@param aInterfaceSelector The interface selector.

	*/

	CPlayerInfoTarget(CRemConInterfaceSelector& aInterfaceSelector, MPlayerApplicationSettingsNotify& aApplicationSettingNotifier );

	void ConstructL(MPlayerCapabilitiesObserver*& aPlayerCapabilitiesObserver,

							MPlayerApplicationSettingsObserver*& aPlayerApplicationSettingsObserver,

							MPlayerEventsObserver*& aPlayerEventsObserver );

private: // from CRemConInterfaceBase

	TAny* GetInterfaceIf(TUid aUid);

private: // from MRemConInterfaceIf

	void MrcibNewMessage(TUint aOperationId, const TDesC8& aData, TRemConMessageSubType aMsgSubType);

private: 

	// Bearer attributes (settings) processing

	void ProcessListPlayerApplicationAttributes( TInt aOperationId );

	void ProcessGetPlayerApplicationAttributeText( const TDesC8& aData, TInt aOperationId );

	void ProcessListPlayerApplicationValues( const TDesC8& aData, TInt aOperationId );

	void ProcessGetPlayerApplicationValueText( const TDesC8& aData, TInt aOperationId );

	void ProcessGetCurrentPlayerApplicationValue( const TDesC8& aData, TInt aOperationId );

	void ProcessSetPlayerApplicationValue( const TDesC8& aData, TInt aOperationId );

	// Bearer attributes (settings) API implementation from MPlayerApplicationSettingsObserver

	void DoDefineAttributeL(TUint aAttributeID, TDesC8& aAttributeText, RArray<TUint> &aValues, RArray<TPtrC8> &aValueTexts, TUint aInitialValue);

	void DoSetAttributeL(TUint aAttributeID, TUint aValue);

	// Notifier Events API implementation from MPlayerEventsObserver

	void DoPlaybackStatusChanged(TPlaybackStatus aStatus);

	void DoTrackChanged(TUint64 aTrackId, TUint32 aLengthInMilliseconds);

	void DoTrackReachedEnd();

	void DoTrackReachedStart();

	void DoSetPlaybackPosition(TUint32 aMilliseconds);	

	void DoSetBatteryStatus(TTargetBatteryStatus aBatteryStatus);

	// Notifier Events bearer processing  

	void ProcessGetPlayStatus();

	void ProcessGetStatusAndBeginObserving(TUint aOperationId, TRegisterNotificationEvent aEventId, const TDesC8& aData);

	void ProcessGetStatus(TUint aOperationId, TRegisterNotificationEvent aEventId);

	void SendNotificationResponse(TRegisterNotificationEvent aEventId, TRemConMessageSubType aMsgSubType);

	void ProcessGetPlayStatusUpdate(const TDesC8& aData);

	// Capabilities API implementation from MPlayerCapabilitiesObserver

	void DoClearEvents();

	TInt DoAddEvent(TRegisterNotificationEvent aEvent);

	TInt DoRemoveEvent(TRegisterNotificationEvent aEvent);

	void DoClearCompanyIds();

	TInt DoAddCompanyId(TInt aID);

	TInt DoRemoveCompanyID(TInt aID);

	// Capabilities bearer processing 

	void ProcessGetCapabilities( const TDesC8& aData );

	// Miscellaneous

	TBool AttributeSettingExists(TUint anAttribute);

	TBool IsValidAttributeValue(TUint anAttributeId, TUint aAttributeValue);

	TBool AttributeValueCanBeSet(TUint anAttributeId, TUint aAttributeValue);

	void SendError(TInt, TInt);

	void SendError(TInt, TInt, TRemConMessageSubType aSubType);

	CPlayerApplicationSettings* GetSetting(TUint anAttribute);

	MPlayerEventsObserver::TTargetBatteryStatus DetectBatteryStatus();

private: // owned

	RBuf8								iOutBuf;

	MPlayerApplicationSettingsNotify& 	iApplicationSettingNotifier;

	// data for MPlayerEventsObserver

	TPlaybackStatus 					iPlayBackStatus;

	TUint64 							iTrackId;

	TUint32 							iLengthInMilliseconds;

	TPlayPosition						iTrackPosition;

	// The time interval (received as part if the RegisterNotification) 

	// in which the change in playback position will be notified

	TUint32   							iPlayBackIntervalInMilliseconds;

	TTargetBatteryStatus				iBatteryStatus;

	TUint32 							iPlaybackPositionInMilliseconds;

	TUint32								iLastNotifiedPlaybackPositionInMilliseconds;

	// data for MPlayerCapabilitiesObserver

	TEventsMask*						iSupportedNotificationEventList;

	RArray<TInt> 						iCompanyIdList;

	// list of events for which notifications have been request 

	RArray<TRegisterNotificationEvent> 			iPendingNotificationEventList;

	// Whether we've been asked for an update when the play status changes

	TBool								iPlaybackStatusUpdatePending;

	// Attribute (settings) data MPlayerApplicationSettingsObserver

	RHashMap<TInt, CPlayerApplicationSettings*>		iPlayerApplicationSettings;

	};

#endif // REMCONPLAYERINFORMATIONTARGET_H