#include "musunittesting.h"

#include <mtelephonyaudioroutingobserver.h>

#include <telephonyaudiorouting.h>

#include <rphcltserver.h>

class CRepository;

class CTelephonyAudioRouting;

class CPhCltCommandHandler;

class MMusEngAudioRoutingObserver;

* Utility class to handle all phone related requests:

* Audio routing, volume control and microphone muting.

class CMusEngTelephoneUtils : public CActive,

                              public MTelephonyAudioRoutingObserver

    MUS_UNITTEST( UT_CMusEngTelephoneUtils )

    MUS_UNITTEST( UT_CMusEngSession )

	public: 

		/**

   		*

        */

		static CMusEngTelephoneUtils* NewL();

		/**

   		*

		~CMusEngTelephoneUtils();

	public: // API

	    /**

        * Checks if audio routing can be changed using LoudspeakerL

        * 

        * @return ETrue if audio routing can be changed using LoudspeakerL

        */

        TBool AudioRoutingCanBeChanged();

		/**

   		* Changes the audio routing between loudspeaker and handset.

   		*  

   		* @param aShowDialog if ETrue, user is notified about new audio routing

		/**

   		*

        */

		TBool IsLoudSpeakerEnabled() const;

		/**

   		*

		TInt GetVolumeL() const;

		/**

   		*

        */

		void SetVolumeL( TInt aVolume );

		/**

        * Mutes CS call microphone.

        */

        void MuteMicL( TBool aMute );

        * Returns current CS call mic mute state.

        TBool IsMicMutedL();

        * Sets audio routing observer. Can be set to NULL in order to indicate

        * ending of observing changes in audio routing.

        void SetAudioRoutingObserver( MMusEngAudioRoutingObserver* aObserver );

    private: // inherited from CActive

		/**

   		*

        */

        void RunL();

		/**

   		* Cancels outstanding request to phone client

        */

        void DoCancel();

    private: // MTelephonyAudioRoutingObserver functions

         * Available outputs have changed

         */

        void AvailableOutputsChanged( 

                        CTelephonyAudioRouting& aTelephonyAudioRouting );

        /**

         * Some other application has changed audio output routing

         */

        void OutputChanged( 

                        CTelephonyAudioRouting& aTelephonyAudioRouting );

        /**

         * Our request to change audio output routing has completed

         */

        void SetOutputComplete( 

                        CTelephonyAudioRouting& aTelephonyAudioRouting,

                        TInt aError );

        /**

        * Set output if setting is currently allowed. Leaves with KErrAccessDenied

        * if setting is not allowed.

        void DoSetOutputL( CTelephonyAudioRouting::TAudioOutput aAudioOutput );

    private:

		/**

   		* Default C++ constructor

		CMusEngTelephoneUtils();

		/**

   		* 2nd phase constructor

        */

		void ConstructL();

	private: // HELPER

		/**

   		* Checks that volume value is between 1 and 10.

   		*

   		* @return validated volume value

        */

		TInt ValidateVolume( const TInt aVolume ) const;

    private: // DATA

        *  Stores the audio routing state at startup.

        CTelephonyAudioRouting::TAudioOutput iAudioOutputAtStartup;

        CTelephonyAudioRouting* iTelephonyAudioRouting;

        CRepository* iRepository;

        /**

        * Command handler for muting the microphone

        */        

        CPhCltCommandHandler* iPhoneCommandHandler;

        /**

        * Not owned.

        */

        MMusEngAudioRoutingObserver* iAudioRoutingObserver;

        TBool iShowDialog;