Collapse all Symbian^3 Application Developer Library

MCCECallObserver Class Reference

class MCCECallObserver

Call observer for MCCECall class.

cce.dll

Since: S60 v3.2

Public Member Functions
void	CallCapsChanged (const MCCECallObserver::TCCECallControlCaps )
void	CallDurationChanged (const TTimeIntervalSeconds )
void	CallEventOccurred (const MCCECallObserver::TCCECallEvent )
void	CallStateChanged (const CCPCall::TCallState )
void	CallStateChangedWithInband (const CCPCall::TCallState )
void	ErrorOccurred (const TCCPError )
void	HandleTransfer (const TBool , const TDesC &)

Public Member Enumerations
enum	TCCECallControlCaps { ECCECapsData = 0x00000001, ECCECapsFax = 0x00000002, ECCECapsVoice = 0x00000004, ECCECapsDial = 0x00000008, ECCECapsConnect = 0x00000010, ECCECapsHangUp = 0x00000020, ECCECapsAnswer = 0x00000040, ECCECapsLoanDataPort = 0x00000080, ECCECapsRecoverDataPort = 0x00000100, ECCECapsHold = 0x00000200, ECCECapsResume = 0x00000400, ECCECapsSwap = 0x00000800, ECCECapsDeflect = 0x00001000, ECCECapsTransfer = 0x00002000, ECCECapsJoin = 0x00004000, ECCECapsOneToOne = 0x00008000, ECCECapsActivateCCBS = 0x00010000, ECCECapsSwitchAlternatingCall = 0x00020000, ECCECapsMulticall = 0x00040000, ECCECapsPSCall = 0x00080000, ECCECapsUnattendedTransfer = 0x00100000 }
enum	TCCECallEvent { ELocalHold , ERemoteHold , ELocalResume , ERemoteResume , ELocalDeflectCall , ELocalTransfer , ERemoteTransferring , ERemoteTransferAlerting , ERemoteTerminated , ERemoteConferenceCreate , ERemoteBarred , ERemoteForwarding , ERemoteWaiting , ELocalBarred , ESecureSession , ENotSecureSession , EVoIPEventNotSecureSessionWithSips , EVoIPEventEarlyMediaStarted , EVoIPEventMultipleChoices , EVoIPEventMovedPermanently , ECCECSLocalDeflectCall , ECCECSDataPortLoaned , ECCECSDataPortRecovered , ECCENotifyRemotePartyInfoChange , ECCESecureNotSpecified }
enum	TCCETone { ECCENoTone , ECCEUserBusy , ECCERadioPathNotAvailable , ECCECongestion , ECCESpecialInformation , ECCEReorder , ECCERemoteAlerting , ECCEDataCallTone , ECCENoSoundSequence , ECCEBeepSequence , ECCECallWaiting }

Member Functions Documentation

CallCapsChanged(const MCCECallObserver::TCCECallControlCaps)

void

CallCapsChanged

(

const MCCECallObserver::TCCECallControlCaps

aCaps

)

[pure virtual]

Notifies observer about the changes in call control caps.

Since: S60 v3.2

Parameters

const MCCECallObserver::TCCECallControlCaps aCaps

Contains updated call control capability flags return none

CallDurationChanged(const TTimeIntervalSeconds)

void

CallDurationChanged

(

const TTimeIntervalSeconds

aDuration

)

[pure virtual]

Notifies observer the change in call duration.

Since: S60 v3.2

Parameters

const TTimeIntervalSeconds aDuration

Duration of the call in seconds return none

CallEventOccurred(const MCCECallObserver::TCCECallEvent)

void

CallEventOccurred

(

const MCCECallObserver::TCCECallEvent

aEvent

)

[pure virtual]

An event for the call has occurred. The observer need to verify event correcness.

Since: S60 v3.2

Parameters

const MCCECallObserver::TCCECallEvent aEvent

Occurred call event return none

CallStateChanged(const CCPCall::TCallState)

void

CallStateChanged

(

const CCPCall::TCallState

aState

)

[pure virtual]

Call state notificfation. The observer need to verify the correctness of given state. CCE will do at least basic call state change checking but also the client needs to verify the correctness.

Since: S60 v3.2

Parameters

const CCPCall::TCallState aState

New state of the call return none

CallStateChangedWithInband(const CCPCall::TCallState)

void

CallStateChangedWithInband

(

const CCPCall::TCallState

aState

)

[pure virtual]

The state of the call has changed with inband tone, meaning network is playing the tone relating to the state.

Since: S60 3.2

Parameters

const CCPCall::TCallState aState

Call state.

ErrorOccurred(const TCCPError)

void

ErrorOccurred

(

const TCCPError

aError

)

[pure virtual]

Call errors are notified using this interface.

Since: S60 v3.2

Parameters

const TCCPError aError

Occurred error as integer, return none

HandleTransfer(const TBool, const TDesC &)

void	HandleTransfer	(	const TBool	aAttended,
			const TDesC &	aDestination
		)	[pure virtual]

Notifies observer about transfer made by remote end

Since: S60 v3.2

Parameters

const TBool aAttended	ETrue: if transfer type is attended, EFalse: type is unattended
const TDesC & aDestination	Address where the call is to be transferred. Given as received in CCE observer needs to verify the address, e.g. it can be KNullDesC. A-B -> B-C, C has requested anonymity in network???

Member Enumerations Documentation

Enum TCCECallControlCaps

Enumerators

ECCECapsData = 0x00000001	The call supports data calls.
ECCECapsFax = 0x00000002	The call supports fax calls.
ECCECapsVoice = 0x00000004	The call supports voice calls.
ECCECapsDial = 0x00000008	The Dial request is currently a valid action.
ECCECapsConnect = 0x00000010	The Connect request is currently a valid action.
ECCECapsHangUp = 0x00000020	The Hang Up request is currently a valid action.
ECCECapsAnswer = 0x00000040	The Answer request is currently a valid action.
ECCECapsLoanDataPort = 0x00000080	The Loan Data Port request is currently a valid action.
ECCECapsRecoverDataPort = 0x00000100	The Recover Data Port request is currently a valid action.
ECCECapsHold = 0x00000200	Indicates that this call can be put on hold. This implies that the call is currently active and that there is no other held call.
ECCECapsResume = 0x00000400	Indicates that this call can be resumed. This implies that the call is currently on hold and that there is no other active call.
ECCECapsSwap = 0x00000800	Indicates that this call's state can be swapped to the opposite state. This implies that this call is either active or held. There may be another call in the opposite state and if this is the case then both calls will be simultaneously swapped to their opposite state.
ECCECapsDeflect = 0x00001000	Indicates that this incoming call can be deflected to another destination.
ECCECapsTransfer = 0x00002000	Indicates that this call can be transferred to the remote party of another call. For this capability to be set there must be one active call and one held or dialing call.
ECCECapsJoin = 0x00004000	Indicates that this call can be joined either to another single call to form a conference call or to an existing conference call.
ECCECapsOneToOne = 0x00008000	Indicates that this call (within a conference call) can go into One to One mode. This action would put the rest of the conference call on hold.
ECCECapsActivateCCBS = 0x00010000	Indicates that the user can activate a CCBS request on this failed call set-up.
ECCECapsSwitchAlternatingCall = 0x00020000	Indicates that this call is part of an alternating call and the client can call SwitchAlternatingCall() on this call in order to switch it to its other mode.
ECCECapsMulticall = 0x00040000	Indicates that this call can use/create a new bearer. This means that multiple calls (multicall) can be active at the same time using no more that 7 bearers simultaneously. The other option is to swap with an active call, therefore it becomes held and shares the same bearer.
ECCECapsPSCall = 0x00080000	Indicates that this call is an packet swiched call
ECCECapsUnattendedTransfer = 0x00100000	Indicates that this call supports unattended transfer method and that this call is currently active

Enum TCCECallEvent

MCCE call events

Enumerators

ELocalHold	The call has been placed on hold as a result of a local action.
ERemoteHold	The call has been placed on hold by the remote connected party.
ELocalResume	The call has been resumed as a result of a local action.
ERemoteResume	The call has been resumed by the remote connected party.
ELocalDeflectCall	The call has been deflected to another remote party as a result of a local action.
ELocalTransfer	The call has been transferred to another remote party as a result of a local action.
ERemoteTransferring
ERemoteTransferAlerting
ERemoteTerminated	The call has been terminated by the remote party.
ERemoteConferenceCreate	The call has been joined by the remote connected party to other call(s) to create/add to a conference call.
ERemoteBarred	The outgoing call has been barred by the remote party.
ERemoteForwarding	The call is being forwarded by the remote party.
ERemoteWaiting	Call is waiting at the remote end. Obsolote, use supplementary service ESsCallWaiting
ELocalBarred	The outgoing call has been barred by the local party.
ESecureSession	Indicates that the connected call is secure
ENotSecureSession	Indicates that the connected call is not secure
EVoIPEventNotSecureSessionWithSips	VoIP specific
EVoIPEventEarlyMediaStarted	VoIP specific: Indicates that the early media playing will be done in MCC component
EVoIPEventMultipleChoices	VoIP specific
EVoIPEventMovedPermanently	VoIP specific
ECCECSLocalDeflectCall	Call has been deflected to another remote party as a result of a local action.
ECCECSDataPortLoaned	CS call specific event
ECCECSDataPortRecovered	CS call specific event
ECCENotifyRemotePartyInfoChange	One or more of following information has been changed Remote party name Remote party number/address Call parameters ( ie. service id )
ECCESecureNotSpecified	Call secure status cannot be determined

Enum TCCETone

Tone to play enumeration. Used in MCCECallObserver::PlayInbandTone

Enumerators

ECCENoTone
ECCEUserBusy
ECCERadioPathNotAvailable
ECCECongestion
ECCESpecialInformation
ECCEReorder
ECCERemoteAlerting
ECCEDataCallTone
ECCENoSoundSequence
ECCEBeepSequence
ECCECallWaiting	ENoSoundSequence handled the same way