--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/mmsharing/mmshengine/inc/musengreceivesession.h Thu Dec 17 08:44:37 2009 +0200
@@ -0,0 +1,192 @@
+/*
+* 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;
+
+class CMusEngReceiveSession : public CMusEngMceSession
+ {
+ MUS_UNITTEST( UT_CMusEngMceSession )
+ MUS_UNITTEST( UT_CMusEngReceiveSession )
+
+ public: // Contructors and destructor
+
+ /**
+ * Creates new MultimediaSharing Receive session.
+ *
+ * @param aRect UI drawing area. It is allowed handle from engine
+ * @param aEngObserver Engine specific callbacks
+ * @param aSessionObserver Session specific callbacks
+ * @return CMusEngReceiveSession* New instanse of specified class
+ */
+ IMPORT_C static CMusEngReceiveSession* NewL(
+ const TRect& aRect,
+ MMusEngSessionObserver& aSessionObserver,
+ MMusEngReceiveSessionObserver& aReceiveSessionObserver );
+ /**
+ * Destructor
+ *
+ * @since S60 v3.2
+ */
+ ~CMusEngReceiveSession();
+
+
+ public: // API
+
+ /**
+ * Accept or deny processed invitation
+ *
+ * @param aAccept ETrue if session is to be accepted and EFalse if
+ * to be rejected.
+ */
+ IMPORT_C void AcceptInvitationL(const TBool& aAccept);
+
+
+ private: // Overrides function in CMusEngMceSession
+
+ /**
+ * 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.
+ */
+ virtual void AdjustVideoCodecL( CMceVideoCodec& aVideoCodec );
+
+ /**
+ * 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 );
+
+
+ private: // from MMceInSessionObserver
+ // overrides the function in CMusEngMceSession
+
+ /**
+ * 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 );
+
+
+ private: // from MMceStreamObserver,
+ // 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 );
+
+
+ private: // CONSTRUCTORS
+
+ CMusEngReceiveSession(
+ MMusEngSessionObserver& aSessionObserver,
+ MMusEngReceiveSessionObserver& aReceiveSessionObserver,
+ const TRect& aRect );
+
+ void ConstructL();
+
+ private: // HELPERS
+
+ CMceInSession* InSession();
+
+ void PrepareToRequire100RelL(
+ TMceTransactionDataContainer* aContainer);
+
+ void CompleteSessionStructureL();
+
+ /**
+ * 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.
+ */
+ void ParseAssertedIdentity(
+ TMceTransactionDataContainer* aContainer );
+
+ private: // DATA
+
+ MMusEngReceiveSessionObserver& iReceiveSessionObserver;
+
+ // 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
+