--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mmsharing/mmshengine/inc/musengmceoutsession.h	Thu Dec 17 08:44:37 2009 +0200
@@ -0,0 +1,204 @@
+/*
+* 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 MUSHENGMCEOUTSESSION_H
+#define MUSHENGMCEOUTSESSION_H
+
+// USER
+#include "musengmcesession.h"
+#include "musunittesting.h"
+
+
+// FORWARD DECLARATIONS
+class MMusEngOutSessionObserver;
+class CMceStreamBundle;
+
+// CLASS DECLARATION
+/**
+* Class for handling MCE out sessions. Direct inherit classes are
+* CMusEngLiveSession and CMusEngClipSession.
+*
+* @lib musengine.lib
+*/
+class CMusEngMceOutSession : public CMusEngMceSession
+    {
+    MUS_UNITTEST( UT_CMusEngOutSession )
+
+    public:
+
+        /**
+        * Destructor
+        */
+        ~CMusEngMceOutSession();
+
+
+    public: // NEW API FUNCTIONS
+
+        /**
+        * Sends invite to specified address. Session establishment is done in 
+        * pause mode meaning that no RTP will be sent to network as a 
+        * consequence of established session. PlayL() can be called any time 
+        * during session establishment or after that in order to allow 
+        * RTP sending.
+        * @leave KErrAlreadyExists if session establishment is already 
+        *        in progress
+        */
+        IMPORT_C void InviteL( const TDesC& aRecipient );
+
+        /**
+        * Cancels Invite.
+        * @pre Invite is sent
+        */
+        IMPORT_C void CancelInviteL( );
+        
+        /**
+        * If codecs supported by recipient are known e.g. because of OPTIONS
+        * query, they can be communicated to engine via this function
+        * @param aVideoCodecs Comma separated list of supported codecs 
+        */
+        IMPORT_C void SetSupportedVideoCodecListL( const TDesC& aVideoCodecs );
+
+
+    public: // VIRTUAL API
+     
+        /**
+        * Resumes previously paused session. Exact behavior depends on 
+        * exact session type.
+        */
+        virtual void PlayL() = 0;
+
+        /**
+        * Pauses session. Exact behavior depends on exact session type.
+        */
+        virtual void PauseL() = 0;
+
+        /**
+        * Tells whether session is paused or not
+        * @pre Call of InviteL has been completed
+        */
+        virtual TBool IsPlayingL() = 0;
+
+
+    protected: // Must be implemented in derived class
+
+        /**
+        * @param aLocalBundle All local streams are supposed to be added to
+        *        this bundle
+        */
+        virtual void CompleteSessionStructureL( 
+                                        CMceStreamBundle& aLocalBundle ) = 0;
+    
+    
+    protected: // May be overridden in derived classes
+         
+        /**
+        * Calls EstablishL-function of class CMceOutSession with feature tag 
+        * in Accept-Contact header. Functions also adjusts stream and codec
+        * settings by calling CMusEngMceSession::AdjustStreamsAndCodecsL.
+        * Intention of the function is to provide subclasses means to set 
+        * preconditions to establishment, e.g. succesfull transcoding.
+        */
+        virtual void EstablishSessionL();
+        
+
+    protected: // helper function inherited from CMusEngMceSession
+
+        /**
+        * Function handling MCE session termination.
+        */
+        void HandleTermination( TInt aStatusCode, const TDesC8& aReasonPhrase );
+
+        /**
+        * Sets Multimediasharing specific video codec settings like video 
+        * payload types. This functions gets called for every video codec in 
+        * session. This function overrides function in base class and may 
+        * be further overridden. Function calls also overridden version.
+        */ 
+        void AdjustVideoCodecL( CMceVideoCodec& aVideoCodec );
+        
+        /**
+        * Sets Multimediasharing specific audio codec settings like audio and
+        * video payload types. This functions gets called for every audio 
+        * codec in session.  This function overrides function in base class and
+        * may be further overridden. Function calls also overridden version.
+        */ 
+        void AdjustAudioCodecL( CMceAudioCodec& aAudioCodec );
+        
+
+    protected:
+
+        /**
+        * Constructor
+        */
+        CMusEngMceOutSession( const TRect& aRect,
+                              MMusEngSessionObserver& aSessionObserver,
+                              MMusEngOutSessionObserver& aOutSessionObserver );
+
+        /**
+        * Second-phase constructor
+        */
+        void ConstructL( TUint aSipProfileId );
+
+
+    private:
+
+        /**
+        *
+        */
+        void CreateMceSessionStructureL();  
+        
+        /**
+        * Add privacy sip header if call privacy is switched on else otherwise.
+        */
+        void AddPrivacyHeaderL( CDesC8Array& aHeaders );
+        
+        
+    protected: // DATA
+
+        /**
+        * Callback reference to outsession observer interface.
+        */
+        MMusEngOutSessionObserver& iOutSessionObserver;
+        
+        /**
+        * ETrue if operator specific behavior is expected
+        */
+        TBool iPrivate; 
+        
+        /**
+        * ETrue if private number is turn on
+        */
+        TBool iPrivateNumber;
+        
+    
+    protected: // DATA
+    
+        /**
+        * Recipient of session to be constructed
+        */
+        HBufC8* iRecipient;
+        
+        HBufC8* iVideoCodecList;
+        
+        
+    private:
+    
+        MUS_UNITTEST ( UT_CMusEngOutSession )
+
+    };
+#endif //MUSHENGMCESESSION_H