class CMceInSession : public CMceSession |
Class for mobile terminated MCE sessions.
CMceInSession represents incoming invitation to join in a session.
The characteristics of the session are defined by remote terminal. Theses charactereistics are defined using SDP and are turned by MCE server into structure of media streams attached into the session. The user of this class is then responsible to either reject accept the invitation.
Accepting the invitation is executed in two steps. First after receiving the invitation the user must complete the media structure. Streams attached to the session are not complete, but they must be completed by the user. Those componens defined in SDP are put automatically into media structure (like streams and RTP sinks and sources), but other relations must be completed by user. When media structure is complete, UpdateL method is called and session establishement continues with second step.
After all media resources are succesfully negotiated and reserved, session state is changed to Proceeding, and end used can be alarmed about incoming invitation. Typically, at this state 180 Ringing response is sent to network. If end user accepts the invitation, 200 OK is sent to network and session is established.
After the session has been succesfylly established, it can be later updated and must be finally terminated.
This class is never instantiated by user, but the ownership is in any case transferred to it. See class MMceInSessionObserver .
If for any reason instance of this class is deleted while in established state, session is automatically terminated by MCE server.
mceclient.lib
Public Member Functions | |
---|---|
CMceInSession ( CMceManager *, TUint32 ) | |
~CMceInSession () | |
IMPORT_C void | AcceptL () |
IMPORT_C void | AcceptL (const TDesC8 &, TUint32 , CDesC8Array *, HBufC8 *, HBufC8 *) |
CMceInSession * | NewL ( RReadStream &, CMceManager &, TUint32 , TBool ) |
CMceInSession * | NewL () |
IMPORT_C void | RejectL () |
IMPORT_C void | RejectL (const TDesC8 &, TUint32 , CDesC8Array *, HBufC8 *, HBufC8 *) |
IMPORT_C void | RespondL (const TDesC8 &, TUint32 , CDesC8Array *, HBufC8 *, HBufC8 *) |
IMPORT_C void | RingL ( CDesC8Array *, HBufC8 *, HBufC8 *) |
TBool | StreamInitializeCondition ( CMceMediaStream &) |
Protected Member Functions | |
---|---|
void | ConstructL (const TDesC8 &, const TDesC8 &) |
void | InitializeInSessionL ( MMceComSerializationContext &, TBool ) |
Inherited Enumerations | |
---|---|
CMceSession:TControlPathSecurityLevel | |
CMceSession:TReason | |
CMceSession:TState |
Inherited Attributes | |
---|---|
CMceSession::iFCObserver | |
CMceSession::iFlatData | |
CMceSession::iManager | |
CMceSession::iMediaStreams | |
CMceSession::iProfileId | |
CMceSession::iReceiver | |
CMceSession::iSender |
CMceInSession | ( | CMceManager * | aManager, |
TUint32 | aProfileId | ||
) |
C++ default constructor.
CMceManager * aManager | Reference to session manager. |
TUint32 aProfileId | Id of the sip profile used for the session. |
IMPORT_C void | AcceptL | ( | ) |
IMPORT_C void | AcceptL | ( | const TDesC8 & | aReason, |
TUint32 | aCode, | |||
CDesC8Array * | aHeaders = 0, | |||
HBufC8 * | aContentType = 0, | |||
HBufC8 * | aContent = 0 | |||
) |
const TDesC8 & aReason | Reason phrase |
TUint32 aCode | Reason code |
CDesC8Array * aHeaders = 0 | SIP headers to be added. Ownership is transferred. |
HBufC8 * aContentType = 0 | Type of content. Ownership is transferred. |
HBufC8 * aContent = 0 | Content to be added in body. Ownership is transferred. |
void | ConstructL | ( | const TDesC8 & | aOriginator, |
const TDesC8 & | aRecipient | |||
) | [protected] |
second-phase constructor
void | InitializeInSessionL | ( | MMceComSerializationContext & | aSerCtx, |
TBool | aUpdateSession | |||
) | [protected] |
Two-phased constructor.
MMceComSerializationContext & aSerCtx | Context containing read stream |
TBool aUpdateSession | Boolean defining whether new session is created becuase of updating |
CMceInSession * | NewL | ( | RReadStream & | aReadStream, |
CMceManager & | aManager, | |||
TUint32 | aProfileId, | |||
TBool | aUpdateSession = EFalse | |||
) | [static] |
Two-phased constructor.
RReadStream & aReadStream | Read stream used. |
CMceManager & aManager | Reference to session manager. |
TUint32 aProfileId | Id of the sip profile used for the session. |
TBool aUpdateSession = EFalse | Boolean defining whether new session is created becuase of updating |
IMPORT_C void | RejectL | ( | ) |
IMPORT_C void | RejectL | ( | const TDesC8 & | aReason, |
TUint32 | aCode, | |||
CDesC8Array * | aHeaders = 0, | |||
HBufC8 * | aContentType = 0, | |||
HBufC8 * | aContent = 0 | |||
) |
const TDesC8 & aReason | Reason phrase |
TUint32 aCode | Reason code |
CDesC8Array * aHeaders = 0 | SIP headers to be added. Ownership is transferred. |
HBufC8 * aContentType = 0 | Type of content. Ownership is transferred. |
HBufC8 * aContent = 0 | Content to be added in body. Ownership is transferred. |
IMPORT_C void | RespondL | ( | const TDesC8 & | aReason, |
TUint32 | aCode, | |||
CDesC8Array * | aHeaders = 0, | |||
HBufC8 * | aContentType = 0, | |||
HBufC8 * | aContent = 0 | |||
) |
const TDesC8 & aReason | |
TUint32 aCode | |
CDesC8Array * aHeaders = 0 | |
HBufC8 * aContentType = 0 | |
HBufC8 * aContent = 0 |
IMPORT_C void | RingL | ( | CDesC8Array * | aHeaders = 0, |
HBufC8 * | aContentType = 0, | |||
HBufC8 * | aContent = 0 | |||
) |
CDesC8Array * aHeaders = 0 | SIP headers to be added. Ownership is transferred. |
HBufC8 * aContentType = 0 | Type of content. Ownership is transferred. |
HBufC8 * aContent = 0 | Content to be added in body. Ownership is transferred. |
TBool | StreamInitializeCondition | ( | CMceMediaStream & | aMediaStream | ) | const [virtual] |
Checks if the stream should be initialized.
CMceMediaStream & aMediaStream | media stream |
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.