/*

* Copyright (c) 2006 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 MUSHENGREVEIVESESSION_H

#define MUSHENGREVEIVESESSION_H

#include "musengmcesession.h"

#include "musenguriparser.h"

#include "musunittesting.h"

#include <mcemediasink.h>

class MMusEngReceiveSessionObserver;

class CMceInSession;

    {

    MUS_UNITTEST( UT_CMusEngMceSession )

    MUS_UNITTEST( UT_CMusEngReceiveSession )

    public: // Contructors and destructor

       /**

        * Creates new MultimediaSharing Receive session.

        * @return CMusEngReceiveSession* New instanse of specified class

        */

       /**

        * Destructor

        *

        * @since S60 v3.2

        */

        ~CMusEngReceiveSession();

        /**

        * The state of the session has changed.

        *

        * @since S60 v3.2

        * @param aSession, the session that has changed.

        */

        virtual void HandleSessionStateChanged( CMceSession& aSession,

                                                TInt aStatusCode,

                                                const TDesC8& aReasonPhrase );

        /**

        * Sets Multimediasharing specific video codec settings like keepalive

        * timer. This functions gets called for every video codec in 

        * session. This function overrides function in base class. 

        * Function calls also overridden version.

        */ 

        /**

        * Sets Multimediasharing specific audio codec settings like keepalive

        * timer. 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 multiples of H.263 codec, prefers H263-2000 over H263-1998.

        * Additionally selects just the one with best quality from selected mode.

        * Removes all the H.263 codecs if any AVC codecs found. Prefers

        * non-interleaved AVC over single NAL AVC

        * @param aVideoStream

        */

        virtual void DoCodecSelectionL( CMceVideoStream& aVideoStream );

        /**

	    * Incoming session invitation. The CMCEInSession is given to the

		* application as a callback.

	    * @param aSession, pointer to the incoming session. Ownership is

		*	     transferred.

	    * @param aContainer, if present, holds details of

	    *        transaction causing state change.

	    */

        void IncomingSession(

	                CMceInSession* aSession,

    				TMceTransactionDataContainer* aContainer );

	    /**

	    * Incoming session update. The new updated CMCEInSession is given to the

		* application as a callback.

	    * @param aOrigSession, the original session to be updated. This instance

	    *        cannot be used anymore, all actions done using aUpdatedSession 

	    *        instance.

	    * @param aUpdatedSession, pointer to the new updated session. Ownership 

	    *        is transferred.

	    * @param aContainer, if present, holds details of update transaction.

	    */

		void IncomingUpdate(

					CMceSession& aOrigSession, 

					CMceInSession* aUpdatedSession,

    				TMceTransactionDataContainer* aContainer );

             // overrides the function in CMusEngMceSession

        /**

        * The state of the stream has changed.

        *

        * @since S60 v3.2

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

        */

        void StreamStateChanged( CMceMediaStream& aStream );

		void ConstructL();

        CMceInSession* InSession();

        void PrepareToRequire100RelL( 

         /**

         * Parse P-Asserted-Identity header. 

         * Tries to fetch the telephone number from tel uri, 

         * if tel uri not found it suppose that telephone number

         * is in sip url. 

         */

        // Set to ETrue if CMceInSession::RingL has already been called

        TBool iRingLCalled;

        // identity of originator parsed form P-Asserted-Identity field

        TBuf8<KMaxUriLength> iIdentity;

    };

#endif