Collapse all Symbian^3 Product Developer Library

MCCPCallObserver Class Reference

class MCCPCallObserver

CCP API Call observer class

Since: S60 3.2

Public Member Functions
void	CallCapsChanged(const TUint32, MCCPCall *)
void	CallEventOccurred(const MCCPCallObserver::TCCPCallEvent, MCCPCall *)
void	CallStateChanged(const MCCPCallObserver::TCCPCallState, MCCPCall *)
void	CallStateChangedWithInband(const MCCPCallObserver::TCCPCallState, MCCPCall *)
void	ErrorOccurred(const TCCPError, MCCPCall *)

Protected Member Functions
	~MCCPCallObserver()

Public Member Enumerations
enum	TCCPCallControlCaps { ECCPCapsData = 0x00000001, ECCPCapsFax = 0x00000002, ECCPCapsVoice = 0x00000004, ECCPCapsDial = 0x00000008, ECCPCapsConnect = 0x00000010, ECCPCapsHangUp = 0x00000020, ECCPCapsAnswer = 0x00000040, ECCPCapsLoanDataPort = 0x00000080, ECCPCapsRecoverDataPort = 0x00000100, ECCPCapsHold = 0x00000200, ECCPCapsResume = 0x00000400, ECCPCapsSwap = 0x00000800, ECCPCapsDeflect = 0x00001000, ECCPCapsTransfer = 0x00002000, ECCPCapsJoin = 0x00004000, ECCPCapsOneToOne = 0x00008000, ECCPCapsActivateCCBS = 0x00010000, ECCPCapsSwitchAlternatingCall = 0x00020000, ECCPCapsMulticall = 0x00040000, ECCPCapsPSCall = 0x00080000, ECCPCapsUnattendedTransfer = 0x00100000, KCCPCapsCreate = 0x00200000 }
enum	TCCPCallEvent { ECCPLocalHold, ECCPRemoteHold, ECCPLocalResume, ECCPRemoteResume, ECCPLocalBarred, ECCPRemoteBarred, ECCPRemoteWaiting, ECCPRemoteTerminated, ECCPQueued, ECCCSPEarlyMediaStarted, ECCPSecureCall, ECCPNotSecureCall, ECCPNotSecureSessionWithSips, ECCPRemoteConferenceCreate, ECCPCSDataPortLoaned, ECCPCSDataPortRecovered, ECCPNotifyRemotePartyInfoChange, ECCPSecureNotSpecified }
enum	TCCPCallState { ECCPStateIdle, ECCPStateRinging, ECCPStateConnecting, ECCPStateConnected, ECCPStateDisconnecting, ECCPStateHold, ECCPStateTransferring, ECCPStateForwarding, ECCPStateQueued, ECCPStateAnswering, ECCPStateDialling }

Constructor & Destructor Documentation

~MCCPCallObserver()

~MCCPCallObserver

(

)

[protected, inline, virtual]

Protects the observer being deleted through the observer interface

Since: S60 3.2

Member Functions Documentation

CallCapsChanged(const TUint32, MCCPCall *)

void	CallCapsChanged	(	const TUint32	aCapsFlags,
			MCCPCall *	aCall
		)	[pure virtual]

Notifies changed call capabilities.

Since: S60 3.2

Parameters

const TUint32 aCapsFlags	New capabilities for the call
MCCPCall * aCall	Pointer to used ccp call, can be NULL in emergency call

CallEventOccurred(const MCCPCallObserver::TCCPCallEvent, MCCPCall *)

void	CallEventOccurred	(	const MCCPCallObserver::TCCPCallEvent	aEvent,
			MCCPCall *	aCall
		)	[pure virtual]

An event has occurred concerning a specific call.

Since: S60 3.2

Parameters

const MCCPCallObserver::TCCPCallEvent aEvent	Occurred event.
MCCPCall * aCall	Pointer to used ccp call, can be NULL in emergency call

CallStateChanged(const MCCPCallObserver::TCCPCallState, MCCPCall *)

void	CallStateChanged	(	const MCCPCallObserver::TCCPCallState	aState,
			MCCPCall *	aCall
		)	[pure virtual]

The state of the call has changed.

Since: S60 3.2

Parameters

const MCCPCallObserver::TCCPCallState aState	Call state.
MCCPCall * aCall	Pointer to used ccp call, can be NULL in emergency call

CallStateChangedWithInband(const MCCPCallObserver::TCCPCallState, MCCPCall *)

void	CallStateChangedWithInband	(	const MCCPCallObserver::TCCPCallState	aState,
			MCCPCall *	aCall
		)	[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 MCCPCallObserver::TCCPCallState aState	Call state.
MCCPCall * aCall	Pointer to used ccp call, can be NULL in emergency call

ErrorOccurred(const TCCPError, MCCPCall *)

void	ErrorOccurred	(	const TCCPError	aError,
			MCCPCall *	aCall
		)	[pure virtual]

An error has occurred concerning a specific call.

Since: S60 3.2

Parameters

const TCCPError aError	Error code.
MCCPCall * aCall	Pointer to used ccp call, can be NULL in emergency call

Member Enumerations Documentation

Enum TCCPCallControlCaps

Flags indicating all the possible call control capabilities.

Enumerators

ECCPCapsData = 0x00000001	Call supports data calls.
ECCPCapsFax = 0x00000002	Call supports fax calls.
ECCPCapsVoice = 0x00000004	Call supports voice calls.
ECCPCapsDial = 0x00000008	The Dial request is currently a valid action.
ECCPCapsConnect = 0x00000010	The Connect request is currently a valid action.
ECCPCapsHangUp = 0x00000020	The Hang Up request is currently a valid action.
ECCPCapsAnswer = 0x00000040	The Answer request is currently a valid action.
ECCPCapsLoanDataPort = 0x00000080	The Loan Data Port request is currently a valid action.
ECCPCapsRecoverDataPort = 0x00000100	The Recover Data Port request is currently a valid action.
ECCPCapsHold = 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.
ECCPCapsResume = 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.
ECCPCapsSwap = 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.
ECCPCapsDeflect = 0x00001000	Indicates that this incoming call can be deflected to another destination.
ECCPCapsTransfer = 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.
ECCPCapsJoin = 0x00004000	Indicates that this call can be joined either to another single call to form a conference call or to an existing conference call.
ECCPCapsOneToOne = 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.
ECCPCapsActivateCCBS = 0x00010000	Indicates that the user can activate a CCBS request on this failed call set-up.
ECCPCapsSwitchAlternatingCall = 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.
ECCPCapsMulticall = 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.
ECCPCapsPSCall = 0x00080000	Indicates that this call is an packet switched call
ECCPCapsUnattendedTransfer = 0x00100000	Indicates that this call supports unattended transfer method and that this call is currently active
KCCPCapsCreate = 0x00200000	Indicates that a conference call can be created.

Enum TCCPCallEvent

Describes the possible call events.

Enumerators

ECCPLocalHold	Call has been placed on hold as a result of a local action.
ECCPRemoteHold	Call has been placed on hold by the remote connected party.
ECCPLocalResume	Call has been resumed as a result of a local action.
ECCPRemoteResume	Call has been resumed by the remote connected party.
ECCPLocalBarred	Outgoing call has been barred by the local party.
ECCPRemoteBarred	Outgoing call has been barred by the remote party.
ECCPRemoteWaiting	Call is waiting at the remote end. Obsolote, use supplementary service ESsCallWaiting
ECCPRemoteTerminated	Call has been terminated by the remote party.
ECCPQueued	Call is in queue
ECCCSPEarlyMediaStarted	VoIP specific
ECCPSecureCall	Call is secure
ECCPNotSecureCall	Call is not secure
ECCPNotSecureSessionWithSips	VoIP specific User has called with address containing "SIPS:" prefix. This event notifies that secure call signaling is not possible.
ECCPRemoteConferenceCreate	Call has been added to remote conference call at remote end
ECCPCSDataPortLoaned	CS call specific event
ECCPCSDataPortRecovered	CS call specific event
ECCPNotifyRemotePartyInfoChange	One or more of following information has been changed Remote party name Remote party number/address Call parameters ( ie. service id )
ECCPSecureNotSpecified	Call secure status cannot be determined

Enum TCCPCallState

Call states

Enumerators

ECCPStateIdle	Indicates initial call state after call creation. Basic state.
ECCPStateRinging	Indicates that the MT call is ringing but not answered yet by the local user. Basic state.
ECCPStateConnecting	MO Call: the network notifies to the MS that the remote party is now ringing. Basic state.
ECCPStateConnected	Indicates that call is connected and active. Basic state.
ECCPStateDisconnecting	Indicates that call is disconnecting. Basic state.
ECCPStateHold	Indicates that the call is connected but on hold. Basic state.
ECCPStateTransferring	Call is transfering. Optional state.
ECCPStateForwarding	MO call is being forwarded at receiver end. Optional state.
ECCPStateQueued	Call is queued locally. Optional state.
ECCPStateAnswering	Indicates that the local user has answered the MT call but the network has not acknowledged the call connection yet. Must be sent after MCCPCall::Answer method has been completed.
ECCPStateDialling	Indicates that the call is dialing. Must be sent after MCCPCall::Dial method has been completed.