/*

* Copyright (c) 2004 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:    

*

*/

#ifndef CMCEMEDIAMANAGER_H

#define CMCEMEDIAMANAGER_H

//  INCLUDES

#include <e32base.h>

#include <e32cmn.h>

#include "mcemediadefs.h"

#include "mcedefs.h"

#include "mcesip.h"

#include "mcesrv.h"

#include "mcecomfilesource.h"

#include "mcesrvstream.h"

#include "mcesecuremediasession.h"

// FORWARD DECLARATIONS

class MMceMediaGeneralObserver;

class CMceComSession;

class CMceComAudioStream;

class CMceComAudioCodec;

class CMceComMediaStream;

class CMceSdpSession;

class CSdpDocument;

class CMceComMediaSink;

class CMceComMediaSource;

class CMceComRtpSource;

class CMceComRtpSink;

class CMceComSpeakerSink;

class CMceComDisplaySink;

class CMceComCameraSource;

class CMceComAMRCodec;

class CSdpMediaField;

class CMceSdpCodec;

class RStringF;

class CMccInterface;

class CMccSecureInterface;

class CMceNatPluginManager;

// Constants

const TInt KRtcpRR = 1;

const TInt KRtcpSR = 2;

const TInt KRtcpUndefined = 3;

/**

*  Media negotiator for encoding and decoding SDP according to 

*  offer/answer model defined in RFC 3264 and managing the MCC interface

*/

class CMceMediaManager : public CBase, public MMccCtrlObserver

    {

    public:  // Constructors and destructor

        /**

        * Two-phased constructor.

        */

        static CMceMediaManager* NewL( MMceMediaGeneralObserver& aObserver );

        /**

        * Two-phased constructor.

        */

        static CMceMediaManager* NewLC( MMceMediaGeneralObserver& aObserver );

        /**

        * Destructor.

        */

        ~CMceMediaManager();

    public: // new API for server

        CMceNatPluginManager& NatPluginManager();

        CSdpDocument* EncodeL( CMceComSession& aSession );

        TMceSipWarningCode DecodeL( CMceComSession& aSession,

                                    CSdpDocument& aSdpDocument );

        TMceReturnStatus UpdateL( CMceComSession& aSession );

        TMceReturnStatus ReserveL( CMceComSession& aSession, const TDesC8& aToken );

        TBool ReservationNeeded( CMceComSession& aSession );

        TBool NeedToNegotiate( CMceComSession& aSession, CSdpDocument* aSdpDocument = NULL );

        TBool ConfirmationNeeded( CMceComSession& aSession );

        TMceNegotiationRole GetRole( CMceComSession& aSession );

    public: // API for server

        /**

        * Creates a rejected SDP answer with all media lines set to 0. 

        *

        * @param  aSession, server session

        * @return none.

        */

        void CreateRejectedAnswer( CMceComSession& aSession );

        /**

        * Pauses the sink 

        *

        * @param  aSink, server sink 

        * @leaves with a system-wide error code

        */

        void PauseL( CMceComMediaSink& aSink );

        /**

        * Pauses the source 

        *

        * @param  aSource, server source

        * @leaves with a system-wide error code

        */

        void PauseL( CMceComMediaSource& aSource );

        /**

        * Resumes the sink

        *

        * @param  aSink, server sink 

        * @leaves with a system-wide error code

        */

        void ResumeL( CMceComMediaSink& aSink );

        /**

        * Stops the source

        *

        * @param  aSource, server source 

        * @leaves with a system-wide error code

        */

        void ResumeL( CMceComMediaSource& aSource );

        /**

        * Closes the session

        *

        * @param  aSession, server session

        * @return One of the standard system-wide error codes.

        */

        TInt CloseSession( CMceComSession& aSession );

        /**

        * Starts inactivity timer for the given RTP source

        * @param aRtpSource

        * @param aInactivityTimeout inactivity timeout

        * @leaves with a system-wide error code

        */

        void StartInactivityTimerL( const CMceComRtpSource& aRtpSource,

                                    TUint32 aInactivityTimeout );

        /**

        * Stops inactivity timer for the given RTP source

        * @param aRtpSource

        * @leaves with a system-wide error code

        */

        void StopInactivityTimerL( const CMceComRtpSource& aRtpSource );

        /**

        * Sends RTCP any data

        * @param aMediaStream, stream 

        * @param aData, data payload   

        * @leaves with a system-wide error code

        */

        void SendRTCPAnyDataL( const CMceComMediaStream& aMediaStream, 

                              const TDesC8& aData );

        /**

        * Sends RTCP receiver report to uplink if possible.

        * @param aRtpSink, rtp source

        * @leaves with a system-wide error code

        */

        void SendRTCPReceiverReportL( const CMceComRtpSource& aRtpSource );

        /**

        * Sends RTCP sender report to uplink if possible.

        * @param aRtpSink, rtp sink

        * @leaves with a system-wide error code

        */

        void SendRTCPSenderReportL( const CMceComRtpSink& aRtpSink );

        /**

        * Gets current maximum volume supported.

        * @param aMaxVolume - [output] maximum volume supported

        * @leaves with a system-wide error code

        */

        void GetMaxVolumeL( TInt& aMaxVolume );

        /**

        * Gets current volume.

        * @param aSink, sink

        * @param aVolume - [output] After completion, current volume

        * @leaves with a system-wide error code

        */

        void GetVolumeL( const CMceComMediaSink& aSink, 

                        TInt& aVolume );

        /**

        * Sets playback volume.

        * @param aSink, sink

        * @param aVolume - [input] Volume value to set

        * @leaves with a system-wide error code

        */

        void SetVolumeL( const CMceComMediaSink& aSink, 

                         TInt aVolume );

        /**

        * Gets audio routing.

        * @param aSpeaker - [input] speaker sink

        * @param aRoutingDestination on return contains destination where audio

        *        is currently routed. Usable values are defined in

        *        mmccinterfacedef.h (e.g. KMccAudioToPublic).

        * @leaves with a system-wide error code

        */

        void GetAudioRoutingL( const CMceComSpeakerSink& aSpeaker, 

                               TInt& aRoutingDestination );

        /**

        * Sets audio routing.

        * @param aSpeaker - [input] speaker sink

        * @param aRoutingDestination destination into which audio is routed.

        *        Usable values are defined in mmccinterfacedef.h 

        *        (e.g. KMccAudioToPublic).

        */

        void SetAudioRoutingL( const CMceComSpeakerSink& aSpeaker, 

                               TInt aRoutingDestination );

        /**

        * Sets balance of a given sink.

        * @param aSink, sink

        * @param aBalance - [input] Balance value to set

        * @leaves with a system-wide error code

        */

        void SetBalanceL( const CMceComMediaSink& aSink, 

                         TInt aBalance );

        /**

        * Sets balance of a given source.

        * @param aSource, source

        * @param aBalance - [input] Balance value to set

        * @leaves with a system-wide error code

        */

        void SetBalanceL( const CMceComMediaSource& aSource, 

                         TInt aBalance );

        /**

        * Gets current gain used in recording.

        * @param aSource, source

        * @param aGain - [output] After completion, current gain

        * @leaves with a system-wide error code

        */

        void GetGainL( const CMceComMediaSource& aSource, 

                      TInt& aGain );

        /**

        * Gets current maximum gain supported.

        * @param aMaxGain - [output] After completion, current gain

        * @leaves with a system-wide error code

        */

        void GetMaxGainL( TInt& aMaxGain );

        /**

        * Sets uplink/record gain to all ongoing sessions.

        * @param aSource, source

        * @param aGain - [input] Gain value to set

        * @leaves with a system-wide error code

        */

        void SetGainL( const CMceComMediaSource& aSource,

                      TInt aGain );

        /**

        * Gets number of displays available

        * @param aDisplaysAvailable, return value

        * @return One of the standard system-wide error codes.

        */

        void GetDisplaysAvailableL( TInt& aDisplaysAvailable );

        /**

        * Gets display size

        * @param aSink, sink

        * @param aDisplayRect, return value

        * @leaves with a system-wide error code

        */

        void GetDisplayRectL( CMceComDisplaySink& aSink, 

                             TRect& aDisplayRect );

        /**

        * Sets display size

        * @param aSink, sink

        * @param aDisplayRect, input value

        * @leaves with a system-wide error code

        */

        void SetDisplayRectL( CMceComDisplaySink& aSink, 

                             TRect aDisplayRect );

        /**

        * Gets display priority

        * @param aSink, sink

        * @param aDisplayPriority, return value

        * @leaves with a system-wide error code

        */

        void GetDisplayPriorityL( CMceComDisplaySink& aSink, 

                                 TInt& aDisplayPriority );

        /**

        * Gets display rotation

        * @param aSink, sink

        * @param aDisplayRotation, return value

        * @leaves with a system-wide error code

        */

        void GetDisplayRotationL( CMceComDisplaySink& aSink, 

                                  TInt& aDisplayRotation );

        /**

        * Sets display priority

        * @param aSink, sink

        * @param aDisplayPriority, input value

        * @leaves with a system-wide error code

        */

        void SetDisplayPriorityL( CMceComDisplaySink& aSink, 

                                 TInt aDisplayPriority );

        /**

        * Sets display index

        * @param aSink, sink

        * @param aDisplayIndex, input value

        * @leaves with a system-wide error code

        */

        void SetDisplayIndexL( CMceComDisplaySink& aSink, 

                              TInt aDisplayIndex );

        /**

        * Sets display rotation

        * @param aSink, sink

        * @param aDisplayRotation, input value

        * @leaves with a system-wide error code

        */

        void SetDisplayRotationL( CMceComDisplaySink& aSink, 

                                  TInt aDisplayRotation );

        /**

        * Gets camera info

        * @param aCameraIndex, input value

        * @param aCameraInfo, return value

        * @leaves with a system-wide error code

        */

        void GetCameraInfoL( TInt aCameraIndex, 

                             TCameraInfo& aCameraInfo );

        /**

        * Gets available cameras

        * @param aCamerasAvailable, return value

        * @leaves with a system-wide error code

        */

        void GetCamerasAvailableL( TInt& aCamerasAvailable );

        /**

        * Gets zoom factor of camera

        * @param aSource, source

        * @param aZoomFactor, return value

        * @leaves with a system-wide error code

        */

        void GetZoomFactorL( CMceComCameraSource& aSource, 

                             TInt& aZoomFactor );

        /**

        * Gets digital zoom factor of camera

        * @param aSource, source

        * @param aDigitalZoomFactor, return value

        * @leaves with a system-wide error code

        */

        void GetDigitalZoomFactorL( CMceComCameraSource& aSource, 

                                    TInt& aDigitalZoomFactor );

        /**

        * Gets contrast of camera

        * @param aSource, source

        * @param aContrast, return value

        * @leaves with a system-wide error code

        */

        void GetContrastL( CMceComCameraSource& aSource, 

                           TInt& aContrast );

        /**

        * Gets brightness of camera

        * @param aSource, source

        * @param aBrightness, return value

        * @leaves with a system-wide error code

        */

        void GetBrightnessL( CMceComCameraSource& aSource, 

                             TInt& aBrightness );

        /**

        * Gets exposure of camera

        * @param aSource, source

        * @param aExposure, return value

        * @leaves with a system-wide error code

        */

        void GetExposureL( CMceComCameraSource& aSource, 

                           TInt& aExposure );

        /**

        * Gets white balance of camera

        * @param aSource, source

        * @param aWhiteBalance, return value

        * @leaves with a system-wide error code

        */

        void GetWhiteBalanceL( CMceComCameraSource& aSource, 

                               TInt& aWhiteBalance );

        /**

        * Sets camera index of camera

        * @param aSource, source

        * @param aCameraIndex, input value

        * @param aCameraInfo, return value

        * 

        * @leaves with a system-wide error code

        */

        void SetCameraIndexL( CMceComCameraSource& aSource, 

                              TInt aCameraIndex,

                              TCameraInfo& aCameraInfo );

        /**

        * Sets zoom factor of camera

        * @param aSource, source

        * @param aZoomFactor, input value

        * @leaves with a system-wide error code

        */

        void SetZoomFactorL( CMceComCameraSource& aSource, 

                             TInt aZoomFactor );

        /**

        * Sets digital zoom factor of camera

        * @param aSource, source

        * @param aDigitalZoomFactor, input value

        * @leaves with a system-wide error code

        */

        void SetDigitalZoomFactorL( CMceComCameraSource& aSource, 

                                   TInt aDigitalZoomFactor );

        /**

        * Sets contrast of camera

        * @param aSource, source

        * @param aContrast, input value

        * @leaves with a system-wide error code

        */

        void SetContrastL( CMceComCameraSource& aSource, 

                           TInt aContrast );

        /**

        * Sets brightness of camera

        * @param aSource, source

        * @param aBrightness, input value

        * @leaves with a system-wide error code

        */

        void SetBrightnessL( CMceComCameraSource& aSource, 

                             TInt aBrightness );

        /**

        * Sets exposure of camera

        * @param aSource, source

        * @param aExposure, input value

        * @leaves with a system-wide error code

        */

        void SetExposureL( CMceComCameraSource& aSource, 

                           TInt aExposure );

        /**

        * Sets white balance of camera

        * @param aSource, source

        * @param aWhiteBalance, input value

        * @leaves with a system-wide error code

        */

        void SetWhiteBalanceL( CMceComCameraSource& aSource, 

                               TInt aWhiteBalance );

        /**

        * Gets file info

        * @param aSource, source

        * @param aFileInfo, return value

        * @leaves with a system-wide error code

        */

        void GetFileInfoL( CMceComFileSource& aSource, 

                           TMceFileInfo& aFileInfo );

        /**

        * Gets file info

        * @param aFileInfo, return value

        * @leaves with a system-wide error code

        */

       void GetFileInfoL( TMceFileInfo& aFileInfo );

        /**

        * Sets file info

        * @param aSource, source

        * @param aFileInfo, return value

        * @leaves with a system-wide error code

        */

       void SetFileInfoL( CMceComFileSource& aSource, 

                          TMceFileInfo& aFileInfo );