1 /*

     2 * Copyright (c) 2008 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:   Internal

    15 *

    16 */

    17 

    18 

    19 

    20 

    21 #ifndef CVCCCONFERENCECALL_H

    22 #define CVCCCONFERENCECALL_H

    23 

    24 #include <e32base.h>

    25 #include <mccpconferencecall.h>         // CCP API MCCPConferenceCall

    26 #include <mccpconferencecallobserver.h> //CCP API MCCPConferenceCallObserver

    27 

    28 class CVccPerformer;

    29 class CConvergedCallProvider;

    30 

    31 /**  Type definition for call arrays */

    32 typedef RPointerArray<CVccPerformer> RVccCallArray;

    33 

    34 /**

    35  *  Internal conference call object

    36  *  This object contains logic for VCC conference calls

    37  *

    38  *  @lib vccperformer.dll

    39  *  @since S60 v3.2

    40  */

    41 NONSHARABLE_CLASS(CVccConferenceCall) : public CBase,

    42                                         public MCCPConferenceCall,

    43                                         public MCCPConferenceCallObserver

    44     {

    45 public:

    46 

    47     /**

    48      * Two-phased constructor.

    49      * @param aServiceId Service id

    50      * @param aObserver Reference to conference call observer in CCE

    51      * @param aCallArray Reference to CVccDirector's performer array

    52      */

    53     static CVccConferenceCall* NewL( const TUint32 aServiceId,

    54                                const MCCPConferenceCallObserver& aObserver,

    55                                RVccCallArray& aCallArray );

    56     

    57     /**

    58      * Two-phased constructor.

    59      * @param aConferenceCall

    60      * @param aCallArray Reference to CVccDirector's performer array

    61      */

    62     static CVccConferenceCall* NewL( MCCPConferenceCall& aConferenceCall, 

    63                                     RVccCallArray& aCallArray );

    64 

    65     /**

    66      * Destructor.

    67      */

    68     virtual ~CVccConferenceCall();

    69     

    70     /**

    71      * Singnals CS plugin that conference is released

    72      *

    73      * @since S60 v3.2

    74      */

    75     void ReleaseConference();

    76 

    77 // from base class MCCPConferenceCall

    78 

    79     /** @see MCCPConferenceCall::ServiceId */

    80     TUint32 ServiceId() const;

    81     

    82     /** @see MCCPConferenceCall::HangUp */

    83     TInt HangUp();

    84     

    85     /** @see MCCPConferenceCall::Hold */

    86     TInt Hold();

    87        

    88     /** @see MCCPConferenceCall::Resume */

    89     TInt Resume();

    90     

    91     /** @see MCCPConferenceCall::Swap */

    92     TInt Swap();

    93     

    94     /** @see MCCPConferenceCall::AddCallL */

    95     void AddCallL( MCCPCall* aCall );

    96 

    97     /** @see MCCPConferenceCall::RemoveCallL */

    98     void RemoveCallL( MCCPCall* aCall );

    99 

   100     /** @see MCCPConferenceCall::CallCount */

   101     TInt CallCount() const;

   102 

   103     /** @see MCCPConferenceCall::GoOneToOneL */

   104     void GoOneToOneL( MCCPCall& aCall );

   105 

   106     /** @see MCCPConferenceCall::CurrentCallsToConferenceL */

   107     void CurrentCallsToConferenceL();

   108         

   109     /** @see MCCPConferenceCall::AddObserverL */

   110     void AddObserverL( const MCCPConferenceCallObserver& aObserver );

   111     

   112     /** @see MCCPConferenceCall::RemoveObserver */

   113     TInt RemoveObserver( const MCCPConferenceCallObserver& aObserver );

   114     

   115     /** @see MCCPConferenceCall::GetCallArray */

   116     TInt GetCallArray( RPointerArray<MCCPCall>& aCallArray );

   117     

   118 // from MCCPConferenceCallObserver

   119 

   120     /** @see MCCPConferenceCallObserver::ErrorOccurred */

   121     void ErrorOccurred( TCCPConferenceCallError aError );

   122 

   123     /** @see MCCPConferenceCallObserver::ConferenceCallCapsChanged */

   124     void ConferenceCallCapsChanged( const TCCPConferenceCallCaps aCaps );

   125 

   126     /** @see MCCPConferenceCallObserver::ConferenceCallStateChanged */

   127     void ConferenceCallStateChanged( const TCCPConferenceCallState aState );

   128         

   129     /** @see MCCPConferenceCallObserver::ConferenceCallEventOccurred */

   130     void ConferenceCallEventOccurred( const TCCPConferenceCallEvent aEvent,

   131                                       MCCPCall* aReferredCall = NULL );

   132          

   133 private:

   134     

   135     /**

   136      * Finds the call from call array

   137      *

   138      * @since S60 v3.2

   139      * @param aCall Call to be found from array

   140      * @return Pointer to found call or NULL if not found

   141      */

   142     CVccPerformer* MatchPluginToVccCall( MCCPCall* aCall );

   143 

   144 private:

   145 

   146     /** 

   147      * C++ Constructor 

   148      * 

   149      * @param aServiceId Service id

   150      * @param aObserver Reference to conference call observer in CCE

   151      * @param aCallArray Reference to CVccDirector's performer array

   152      * 

   153      */

   154     CVccConferenceCall( const TUint32 aServiceId,

   155                         const MCCPConferenceCallObserver& aObserver,

   156                         RVccCallArray& aCallArray );

   157 

   158     /** 

   159     * C++ Constructor 

   160     * 

   161     * @param aConferenceCall Conference call object

   162     * @param aCallArray Reference to CVccDirector's performer array

   163     * 

   164     */

   165     CVccConferenceCall( MCCPConferenceCall& aConferenceCall,

   166                             RVccCallArray& aCallArray );

   167     

   168     /** 2nd phase constructor */

   169     void ConstructL();

   170     

   171 private: // data

   172 

   173     /**

   174      * ServiceId for this conferencecall

   175      */

   176     TUint32 iServiceId;

   177     

   178     /**

   179      * Reference to conference call observer (CCE)

   180      * Not own.

   181      */

   182     MCCPConferenceCallObserver* iObserver;

   183     

   184     /**

   185      * Reference to CVccDirector's array of calls

   186      * Not own.

   187      */

   188     RVccCallArray& iCallArray;

   189 

   190     /**

   191      * Reference to CS plugin's conference object

   192      * Own.

   193      */

   194     MCCPConferenceCall* iConferenceCall;

   195     

   196     /**

   197      * Reference to CS plugin

   198      * Not own.

   199      */

   200     CConvergedCallProvider* iCsProvider;

   201 

   202     friend class T_CVccConferenceCall;

   203     };

   204 

   205 

   206 #endif /*CVCCCONFERENCECALL_H*/