/*

* Copyright (c) 2006 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:   This class is the main interface to the TelephonyAudioRoutingServer. 

*				 It implements the client-side session.

*

*/

#ifndef TELEPHONYAUDIOROUTINGMANAGERSESSION_H                                                

#define TELEPHONYAUDIOROUTINGMANAGERSESSION_H                                                  

#include <e32base.h>

#include <e32std.h>     

#include "MTelephonyAudioRoutingPolicyObserver.h"

#include "TelephonyAudioRoutingClientServer.h"

class CTelephonyAudioRoutingPolicyRequest;

class CTelephonyAudioRoutingManager;

// CLASS DECLARATION

/**

*  Main interface to the TelephonyAudioRoutingServer. 

*  It implements the client-side session.

*

*  @lib TelephonyAudioRoutingManagerSession.lib

*  @since Series 60 3.1

*/                                     

class RTelephonyAudioRoutingManagerSession : public RSessionBase                                   

    { 

	public:                                                                          

    	IMPORT_C RTelephonyAudioRoutingManagerSession();    

    public:                                                    

    	/**

        * Connects a policy client to the server.

        * @since Series 60 3.1

        * @param aAudioRoutingManager: Client, aPolicyObserver: client observer class

        * @return TInt: if connection was successful

        */

    	IMPORT_C TInt Connect(CTelephonyAudioRoutingManager& aAudioRoutingManager, MTelephonyAudioRoutingPolicyObserver& aPolicyObserver);

        /**

        * Closes connection to the server.

        * @since Series 60 3.1

        * @param none

        * @return void

        */

        IMPORT_C void Close();                                                      

	    /**

        * Used by policy to notify server of audio output changes.

        * @since Series 60 3.1

        * @param aOutput: client obj

        * @return void

        */

	    IMPORT_C void OutputChanged(CTelephonyAudioRouting::TAudioOutput aOutput); 

	    /**

        * Used by policy to notify server that requested output change completed

        * @since Series 60 3.1

        * @param aOutput: client obj, aError: error code for operation

        * @return void

        */

	    IMPORT_C void OutputChangeCompleted(CTelephonyAudioRouting::TAudioOutput aOutput, TInt aError); 

    	/**

        * Used by policy session to get notification whenever any of the clients sends

        * a SetOutput request.

        * @since Series 60 3.1

        * @param none

        * @return void

        */

    	IMPORT_C void MonitorOutputChangeRequest();

    	/**

        * Sets policy session Id.

        * @since Series 60 3.1

        * @param none

        * @return void

        */

    	IMPORT_C void SetPolicySessionIdL();

    	/**

        * Cancel a previously send request.

        * @since Series 60 3.1

        * @param aRequest: request to cancel

        * @return void

        */

    	IMPORT_C void CancelRequest(TTelAudRtngServRqst aRequest);

    	/**

        * Used by policy session to notify server if the available audio

        * output change.

        * @since Series 60 3.1

        * @param aOutputs: array of available outputs

        * @return void

        */

    	IMPORT_C void AvailableOutputsChangedL(const TArray<CTelephonyAudioRouting::TAudioOutput>& aOutputs);

     	/**

        * Provide caller with iAudioOutputPkg

        * @since Series 60 3.1

        * @param none

        * @return iAudioOutputPkg

        */

    	IMPORT_C  TPckgBuf<CTelephonyAudioRouting::TAudioOutput>& AudioOutputPkg();    	 

	private:

   		/**

        * Start asynchronous request handlers.

        * @since Series 60 3.1

        * @param aAudioRoutingManager: client obj, aPolicyObserver: observer obj for callbacks

        * @return void

        */

   		void StartPolicyRequestHandlersL( CTelephonyAudioRoutingManager& aAudioRoutingManager, MTelephonyAudioRoutingPolicyObserver& aPolicyObserver );

	private:

  		TPckgBuf<CTelephonyAudioRouting::TAudioOutput> iAudioOutputPkg;      

		CTelephonyAudioRoutingPolicyRequest* iPolicyRequest;	

		TBool iConnected;  

    };                                                                           

#endif         //TELEPHONYAUDIOROUTINGSESSION_H