phonesrv_plat/converged_call_engine_api/inc/mcceconferencecallobserver.h
changeset 0 ff3b6d0fd310
child 19 7d48bed6ce0c
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/phonesrv_plat/converged_call_engine_api/inc/mcceconferencecallobserver.h	Tue Feb 02 01:11:09 2010 +0200
@@ -0,0 +1,133 @@
+/*
+* 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:  Observer interface for conference call
+*
+*/
+
+
+#ifndef MCCECONFERENCECALLOBSERVER_H
+#define MCCECONFERENCECALLOBSERVER_H
+
+class MCCECall;
+
+#include <ccpdefs.h> // conference call error defenitions
+
+/**
+ *  Observer interface for conference call
+ *
+ *  @lib cce.dll
+ *  @since S60 v3.2
+ */
+class MCCEConferenceCallObserver
+    {
+public:
+    /** Conference events. */
+    enum TCCEConferenceCallEvent
+      {
+      /** A call has been added to the conference. */
+      ECCEConferenceCallAdded,   
+      /** A call has been removed from the conference. */
+      ECCEConferenceCallRemoved, 
+      /** Names of the two calls used to build the conference call returned in aCallName. */
+      ECCEConferenceBuilt,	   
+      /** No name provided */
+      ECCEConferenceTerminated,  
+      /** No name provided. */
+      ECCEConferenceSwapped,	   
+      /** Name of the call being seperated. */
+      ECCEConferenceSplit		   
+      };
+		
+    /** Conference call State. */
+    enum TCCEConferenceCallState
+      {
+      /** The conference call is in the idle state. */
+      ECCEConferenceIdle,
+      /** The conference call is in the active, connected state. */
+      ECCEConferenceActive,
+      /** The conference call is in the held, connected state. */
+      ECCEConferenceHold
+      };
+		
+    /** Conference call capabilities. */
+    enum TCCEConferenceCallCaps
+      {
+      /** Indicates that a conference call can be created. */
+      KCCECapsCreate = 0x00000001,
+      /** Indicates that a conference call can be terminated. */
+      KCCECapsHangUp = 0x00000002,
+      /** Indicates that a conference call exists and can be swapped to the opposite 
+      state (active or hold). */
+      KCCECapsSwap = 0x00000004
+      };
+
+    /**
+    * A ConferenceCall event has occurred.
+    * @since S60 3.2
+    * @param aEvent Occurred event.
+    * @param aReferredCall Pointer to call that the event refers to. 
+    * Used e.g. for 
+    * MCCEConferenceCall::AddCallL and 
+    * MCCEConferenceCall::RemoveCallL
+    * Default value is NULL.
+    * @return none
+    */
+    virtual void CallEventOccurred( 
+                 const MCCEConferenceCallObserver::TCCEConferenceCallEvent aEvent,
+                 MCCECall* aReferredCall=NULL  ) = 0;
+
+    /**
+    * Conference state has changed.
+    *
+    * @since S60 3.2
+    * @param aStateContains the state of the conference call
+    * @return none
+    */
+    virtual void CallStateChanged( 
+                 const MCCEConferenceCallObserver::TCCEConferenceCallState aState ) = 0;
+
+
+    /**
+    * Conference capabilities have changed.
+    *
+    * @since S60 3.2
+    * @param aCaps Updated call control capabilities
+    * @return none
+    */
+    virtual void CallCapsChanged( 
+                 const MCCEConferenceCallObserver::TCCEConferenceCallCaps aCaps ) = 0;
+     
+    /**
+    * An error has occurred regarding the conference.
+    *
+    * @since S60 3.2
+    * @param aError Occurred error code. 
+    * @return none
+    */
+    virtual void ErrorOccurred( TCCPConferenceCallError aError  ) = 0;
+
+	/**
+	* Notifies observer the change in call duration.
+	*
+	* @since S60 v3.2
+	* @param aDuration Duration of the call in seconds
+	* return none
+	*/
+	virtual void CallDurationChanged( const TTimeIntervalSeconds aDuration ) = 0;
+	};
+
+
+
+
+#endif // MCCECONFERENCECALLOBSERVER