diff -r f742655b05bf -r d38647835c2e sipvoipprovider/svphold/inc/svpholdmediahandler.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/sipvoipprovider/svphold/inc/svpholdmediahandler.h Wed Sep 01 12:29:57 2010 +0100 @@ -0,0 +1,161 @@ +/* +* 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 + +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 +