MCCECallObserver Class Reference

class MCCECallObserver

Call observer for MCCECall class.

cce.dll
Since
S60 v3.2
Public Member Functions
voidCallCapsChanged(const MCCECallObserver::TCCECallControlCaps)
voidCallDurationChanged(const TTimeIntervalSeconds)
voidCallEventOccurred(const MCCECallObserver::TCCECallEvent)
voidCallStateChanged(const CCPCall::TCallState)
voidCallStateChangedWithInband(const CCPCall::TCallState)
voidErrorOccurred(const TCCPError)
voidHandleTransfer(const TBool, const TDesC &)
Public Member Enumerations
enumTCCECallControlCaps {
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
}
enumTCCECallEvent {
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
}
enumTCCETone {
ECCENoTone, ECCEUserBusy, ECCERadioPathNotAvailable, ECCECongestion, ECCESpecialInformation, ECCEReorder, ECCERemoteAlerting, ECCEDataCallTone, ECCENoSoundSequence, ECCEBeepSequence, ECCECallWaiting
}

Member Functions Documentation

CallCapsChanged(const MCCECallObserver::TCCECallControlCaps)

voidCallCapsChanged(const MCCECallObserver::TCCECallControlCapsaCaps)[pure virtual]

Notifies observer about the changes in call control caps.

Since
S60 v3.2

Parameters

const MCCECallObserver::TCCECallControlCaps aCapsContains updated call control capability flags return none

CallDurationChanged(const TTimeIntervalSeconds)

voidCallDurationChanged(const TTimeIntervalSecondsaDuration)[pure virtual]

Notifies observer the change in call duration.

Since
S60 v3.2

Parameters

const TTimeIntervalSeconds aDurationDuration of the call in seconds return none

CallEventOccurred(const MCCECallObserver::TCCECallEvent)

voidCallEventOccurred(const MCCECallObserver::TCCECallEventaEvent)[pure virtual]

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

Since
S60 v3.2

Parameters

const MCCECallObserver::TCCECallEvent aEventOccurred call event return none

CallStateChanged(const CCPCall::TCallState)

voidCallStateChanged(const CCPCall::TCallStateaState)[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 aStateNew state of the call return none

CallStateChangedWithInband(const CCPCall::TCallState)

voidCallStateChangedWithInband(const CCPCall::TCallStateaState)[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 aStateCall state.

ErrorOccurred(const TCCPError)

voidErrorOccurred(const TCCPErroraError)[pure virtual]

Call errors are notified using this interface.

Since
S60 v3.2

Parameters

const TCCPError aErrorOccurred error as integer, return none

HandleTransfer(const TBool, const TDesC &)

voidHandleTransfer(const TBoolaAttended,
const TDesC &aDestination
)[pure virtual]

Notifies observer about transfer made by remote end

Since
S60 v3.2

Parameters

const TBool aAttendedETrue: if transfer type is attended, EFalse: type is unattended
const TDesC & aDestinationAddress 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