--- /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