/*

* Copyright (c) 2005 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 MUSHENGLIVESESSION_H

#define MUSHENGLIVESESSION_H

// USER

#include "musengmceoutsession.h"

#include "musunittesting.h"

// SYSTEM

#include <ecam.h>

// FORWARD DECLARATIONS

class MMusEngLiveSessionObserver;

class CMusEngLiveSession : public CMusEngMceOutSession

    {

    MUS_UNITTEST( UT_CMusEngOutSession )

    MUS_UNITTEST( UT_CMusEngLiveSession )

    public:

        /**

        * Creates new MultimediaSharing Live session.

        *

        * @param aFileName Media filename

        * @param aRect UI drawing area. It is allowed handle from engine

        * @param aSessionObserver Interface for session specific callbacks

        * @param aOutSessionObserver Interface for outsession specific callbacks

        * @param aLiveSessionObserver interface for live session specific

        *        callbacks

        * @param aSipProfileId SIP profile to be used, 0 is default profile

        * @return CMusEngLiveSession* New instanse of specified class

        */

        IMPORT_C static CMusEngLiveSession* NewL( 

							const TDesC& aFileName,

                            const TRect& aRect,

                            MMusEngSessionObserver& aSessionObserver,

                            MMusEngOutSessionObserver& aOutSessionObserver,

                            MMusEngLiveSessionObserver& aLiveSessionObserver,

                            TUint aSipProfileId = 0);

        /**

        * Creates new MultimediaSharing Live session.

        *

        * @param aRect UI drawing area. It is allowed handle from engine

        * @param aSessionObserver Interface for session specific callbacks

        * @param aOutSessionObserver Interface for outsession specific callbacks

        * @param aLiveSessionObserver interface for live session specific

        *        callbacks

        * @param aSipProfileId SIP profile to be used, 0 is default profile

        * @return CMusEngLiveSession* New instanse of specified class

        */

        IMPORT_C static CMusEngLiveSession* NewL( 

                            const TRect& aRect,

                            MMusEngSessionObserver& aSessionObserver,

                            MMusEngOutSessionObserver& aOutSessionObserver,

                            MMusEngLiveSessionObserver& aLiveSessionObserver,

                            TUint aSipProfileId = 0 );

    public:

        /**

        * Destructor

        */

        ~CMusEngLiveSession();

    public: // NEW LIVE SESSION SPECIFIC API FUNCTIONS

        /**

        * Gets current zoom factor

        * 

        * @pre Session is established

        * @leave KErrNotReady if precondition not fullfilled

        */

        IMPORT_C TInt CurrentZoomL() const;

        /**

        * Sets new zoom factor

        * 

        * @pre Session is established

        * @pre MinZoomL <= aNewZoomFactor <= MaxZoomL

        * @leave KErrNotReady if session is not established

        */

        IMPORT_C void SetZoomL( TInt aNewZoomFactor );

        /**

        * Gets minimum zoom factor

        * 

        * @pre Session is established

        * @leave KErrNotReady if precondition not fullfilled

        */

        IMPORT_C TInt MinZoomL() const;

        /**

        * Gets maximum zoom factor

        * 

        * @pre Session is established

        * @leave KErrNotReady if precondition not fullfilled

        */

        IMPORT_C TInt MaxZoomL() const;

        /**

        * Increases zoom factor by one.

        * 

        * @pre Session is established

        * @leave KErrNotReady if precondition not fullfilled

        */

        IMPORT_C void ZoomInL();

        /**

        * Decreases zoom factor by one.

        * 

        * @pre Session is established

        * @leave KErrNotReady if precondition not fullfilled

        */

        IMPORT_C void ZoomOutL();

        /**

        * Sets zoom factor to default.

        * 

        * @pre Session is established

        * @leave KErrNotReady if precondition not fullfilled

        */

        IMPORT_C void ZoomDefaultL();

        /**

        * Sets current brightness

        * 

        * @pre Session is established

        * @leave KErrNotReady if precondition not fullfilled

        */

        IMPORT_C void SetBrightnessL( TInt aBrightness ) const;

        /**

        * Gets current brightness

        * 

        * @pre Session is established

        * @leave KErrNotReady if precondition not fullfilled

        */

        IMPORT_C TInt CurrentBrightnessL() const;

        /**

        * Gets maximum brightness

        * 

        * @pre Session is established

        * @leave KErrNotReady if precondition not fullfilled

        */

        IMPORT_C TInt MaxBrightnessL() const;

        /**

        * Gets minimum brightness

        * 

        * @pre Session is established

        * @leave KErrNotReady if precondition not fullfilled

        */

        IMPORT_C TInt MinBrightnessL() const;

        /**

        * Increases brightness by one.

        * 

        * @pre Session is established

        * @leave KErrNotReady if precondition not fullfilled

        */

        IMPORT_C void IncreaseBrightnessL();

        /**

        * Decreases brightness by one.

        * 

        * @pre Session is established

        * @leave KErrNotReady if precondition not fullfilled

        */

        IMPORT_C void DecreaseBrightnessL();

        /**

        * Sets brightness factor to default.

        * 

        * @pre Session is established

        * @leave KErrNotReady if precondition not fullfilled

        */

        IMPORT_C void BrightnessDefaultL();

        /**

        * Sets brightness to automatic.

        * 

        * @pre Session is established

        * @leave KErrNotReady if precondition not fullfilled

        */

        IMPORT_C void BrightnessAutoL();

        /**

        * Starts or pauses recording

        */

        IMPORT_C void RecordL( TBool aRecord );

        /**

        * Tells whether recording is paused or not

        */

        IMPORT_C TBool IsRecording();

    public: // implementation of virtual API from CMusEngMceOutSession

        /**

        * Resumes previously paused session. 

        * Continues using viewfinder and enables streaming video.

        *

        */

        IMPORT_C void PlayL();

        /**

        * Pauses session.

        * Holds display and disables streaming video to network.

        *

        */

        IMPORT_C void PauseL();

        /**

        * Tells whether session is paused or not

        */

        IMPORT_C TBool IsPlayingL();

    protected: // inherited from CMusEngMceOutSession

        /**

        * @param aLocalBundle All local streams are supposed to be added to

        *        this bundle

        */

		void CompleteSessionStructureL( CMceStreamBundle& aLocalBundle );

    private: // overrides ancestor class versions

        /**

        * The state of the session has changed

        * @param aSession, the session that has changed.

        */

        virtual void HandleSessionStateChanged( CMceSession& aSession,

                                                TInt aStatusCode,

                                                const TDesC8& aReasonPhrase );

        /**

        * Sets Multimediasharing specific video codec settings like video 

        * bitrate maxbitrate. This functions gets called for every video codec 

        * in session. This function overrides function in ancestor classes. 

        * Function calls also overridden version.

        */ 

        virtual void AdjustVideoCodecL( CMceVideoCodec& aVideoCodec );

        /**

        * Sets Multimediasharing specific audio codec settings. This functions 

        * gets called for every audio codec in session. This function overrides 

        * function in base class. Function calls also overridden version.

        */ 

        virtual void AdjustAudioCodecL( CMceAudioCodec& aAudioCodec );     

        /**

        * Removes AVC if known that it is not supported

        */

        virtual void DoCodecSelectionL( CMceVideoStream& aVideoStream );

    private: // from MMceStreamObserver, 

             // overrides the function in CMusEngMceSession

        /**

        * The state of the sink has changed.

        *

        * @param aStream, the stream that uses the sink.

        * @param aSink, the sink that has changed.

        */

        void StreamStateChanged( CMceMediaStream& aStream,

                                 CMceMediaSink& aSink );    

    private:

        /**

        * Constructor

        */

        CMusEngLiveSession( MMusEngSessionObserver& aSessionObserver,

                            MMusEngOutSessionObserver& aOutSessionObserver,

                            MMusEngLiveSessionObserver& aLiveSessionObserver,

        					const TRect& aRect,

        					const TDesC& aRecordedFile = KNullDesC );

        /**

        * Second-phase constructor

        */

        void ConstructL( TUint aSipProfileId );

    private: // Helpers

        /**

        * Reads from CenRep and sets encoding device for a codec.

        */

        void SetEncodingDeviceL( CMceVideoCodec& aVideoCodec );

        /**

        * Sets configuration key for a codec

        */

        void SetCodecConfigKeyL( CMceVideoCodec& aVideoCodec );

        /**

        * Reads proper configuration key for a codec. NULL if not available.

        * Ownership is transferred.

        */

        HBufC8* ReadCodecConfigKeyL( const CMceVideoCodec& aVideoCodec ) const;

        /**

        * Constructs and stores to cenrep a concatenation of all AVC config keys.

        */

        void StoreEncoderConfigInfoL() const;

        /**

        * Returns config key id for the provided codec. Ownership is transferred

        */

        const TPtrC8 ConfigKeyIdL( const CMceVideoCodec& aVideoCodec ) const;

        /**

        *    Calculate the zoom step size based time escaped. 

        * 

        * @param aTime, start time. pass iZoomInTime or iZoomOutTime as parameter

        * @return TInt, return calculate result of the step size  

        */

        TInt ZoomStepSize( TInt64& aTime );

        /**

         *  Calculates iMinZoomStep and iMaxZoomStep zoom step sizes,

         *  should be called before first ZoomIn()/ZoomOut() call

         */

        void InitializeZoomStepSize();

    private:

        /**

        * Reference to live session observer interface.

        */

        MMusEngLiveSessionObserver& iLiveSessionObserver;

        /**

        *

        */

        TCameraInfo iCameraInfo;

        /**

        *

        */

        TInt iDefaultZoomFactor;

        /**

        *

        */

        TInt iDefaultBrightness;

        /**

        * File name for recording. If KNullDesC no recording performed.

        */

        TFileName iRecordedFile;

        /**

        * If true, configuration key of current AVC codec must be written to

        * CenRep after session establishment.

        */

        TBool iStoreEncoderConfigInfo;

        /**

        * latest Zoomin time

        */

        TInt64 iZoomInTime;

        /**

        * latest Zoomout time

        */

        TInt64 iZoomOutTime;        

        /**

        *

        */

        TInt iSmallZoomStep;

        /**

        *

        */

        TInt iBigZoomStep;

    };

#endif