/*

* Copyright (c) 2006-2007 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:  Pauses and resumes audio stream.

*

*/

#ifndef SVPHOLDMEDIAHANDLER_H

#define SVPHOLDMEDIAHANDLER_H

#include <e32base.h>

class CSVPHoldContext;

class CMceMediaStream;

/**

*  Media handler class for SVP hold extension.

*  @lib svp.dll

*  @since S60 3.2

*/

class CSVPHoldMediaHandler : public CBase

    {

public:  // Constructors and destructor

    /**

    * Two-phased constructor.

    */

    static CSVPHoldMediaHandler* NewL();

    /**

    * Destructor.

    */

    virtual ~CSVPHoldMediaHandler();

public:  // New functions

    /**

    * Disables/enables media stream based on the request.

    * @since S60 3.2

    * @param aMediaStream MCE Media stream

    * @param aRequest Request type

    */

    void PerformMediaActionL( CMceMediaStream& aMediaStream,

                              TSVPHoldRequestType aRequest );

    /**

    * Disables needed sinks/sources.

    * @since S60 3.2

    * @param aContext SVP Hold context

    * @param aLeaveSpeakerEnabled ETrue, when only mic source is disabled

    */

    void DisableAudioL( CSVPHoldContext& aContext,

                        TBool aLeaveSpeakerEnabled = EFalse );

    /**

    * Disables needed sinks/sources.

    * @since S60 3.2

    * @param aContext SVP Hold context

    */

    void EnableAudioL( CSVPHoldContext& aContext );

private:

    /**

    * C++ default constructor.

    */

    CSVPHoldMediaHandler();

    /**

    * By default Symbian 2nd phase constructor is private.

    */

    void ConstructL() const;

private: // New functions

    /**

    * Handles streams in local hold request cases.

    * @since S60 3.2

    * @param aMediaStream MCE Media stream

    * @param aBoundStream MCE Media stream

    */

    void HandleLocalHoldingL( CMceMediaStream& aMediaStream,

                              CMceMediaStream& aBoundStream );

    /**

    * Handles streams in local resume request cases.

    * @since S60 3.2

    * @param aMediaStream MCE Media stream

    * @param aBoundStream MCE Media stream

    * @param aRequest Request type

    */

    void HandleLocalResumingL( CMceMediaStream& aMediaStream,

                               CMceMediaStream& aBoundStream,

                               TSVPHoldRequestType aRequest );

    /**

    * Handles streams in remote hold request cases.

    * @since S60 3.2

    * @param aMediaStream MCE Media stream

    * @param aBoundStream MCE Media stream

    */

    void HandleRemoteHoldingL( CMceMediaStream& aMediaStream,

                               CMceMediaStream& aBoundStream,

                               TSVPHoldRequestType aRequest );

    /**

    * Handles streams in local resume request cases.

    * @since S60 3.2

    * @param aMediaStream MCE Media stream

    * @param aBoundStream MCE Media stream

    * @param aRequest Request type

    */

    void HandleRemoteResumingL( CMceMediaStream& aMediaStream,

                                CMceMediaStream& aBoundStream,

                                TSVPHoldRequestType aRequest );

    /**

    * Enables audio

    * @since S60 3.2

    * @param aMediaStream MCE Media stream

    * @param aContext SVP Hold context

    */

    void EnableAudioL( CMceMediaStream& aMediaStream,

                       CSVPHoldContext& aContext );

    /**

    * Disables used audio stream (mic & speaker)

    * @since S60 3.2

    * @param aAudioStream MCE Media stream

    */

    void DisableAudioStreamL( CMceMediaStream& aAudioStream,

                              TBool aLeaveSpeakerEnabled );

    /**

    * Disables used audio stream (mic & speaker)

    * @since S60 3.2

    * @param aAudioStream MCE Media stream

    * @param aAllowMicEnable Boolean value

    */

    void EnableAudioStreamL( CMceMediaStream& aAudioStream,

                             TBool aAllowMicEnable = ETrue );

    };

#endif      // SVPHOLDMEDIAHANDLER_H