telephonyserverplugins/common_tsy/commontsy/inc/mmgsmwcdma/cmmconferencecallgsmwcdmaext.h
author hgs
Thu, 23 Sep 2010 14:44:40 +0100
changeset 73 70d75957b98f
parent 0 3553901f7fa8
child 24 6638e7f4bd8f
permissions -rw-r--r--
201037_01

/*
* Copyright (c) 2006-2009 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:
*
*/



#ifndef CMMCONFERENCECALLGSMWCDMAEXT_H
#define CMMCONFERENCECALLGSMWCDMAEXT_H

// INCLUDES
#include "cmmconferencecallextinterface.h"

// CONSTANTS
const TInt KMaxCallsInConference = 5;

//  FORWARD DECLARATIONS
class CMmConferenceCallTsy;

// CLASS DECLARATION

/**
* Provides a Gsm/Wcdma system specific extension of 
* Conference Call Tsy.
*
*/
NONSHARABLE_CLASS( CMmConferenceCallGsmWcdmaExt ) 
    : public CMmConferenceCallExtInterface
    {
    public: // Constructors and destructor

        /**
         * Default destructor
         *         
         *
         */
        ~CMmConferenceCallGsmWcdmaExt();

        /**
         * Creates new GSM specific conference call object
         *         
         *
         * @param pointer to the conference call object
         * @return reated object 
         */
        static CMmConferenceCallGsmWcdmaExt* NewL(
            CMmConferenceCallTsy* aMmConferenceCallTsy );

        /**
         * This method allows clients to create the initial conference call
         *         
         *
         * @param  CC status
         * @param call list
         * @return  result of the request
         */
        TInt CreateConferenceL( 
            RMobileConferenceCall::TMobileConferenceStatus aStatus );

        /**
         * Allows a client to switch a conference call between "Active" and 
         * "Hold" states
         *         
         *
         * @param CC status
         * @param call list
         * @return TInt: result of the request
         */
        TInt SwapL( 
			RMobileConferenceCall::TMobileConferenceStatus aStatus,
            CMmCallList* aCallList );

        /**
         * This method adds the single voice call specified by the aCallName 
         * parameter to an existing conference call
         *         
         *
         * @param name of the call to be added to CC
         * @param CC status
         * @param call list
         * @return result of the request
         */
        TInt AddCallL( 
            const TName* aCallName,
            RMobileConferenceCall::TMobileConferenceStatus aStatus,
            CMmCallList* aCallList );

        /**
         * Directed to extension to inform extension that a status of a single 
         * call has changed
         *         
         *
         * @param  new status of
         * a single call
         * @param TaCallId: call ID of that call
         */
        TBool CallStatusChanged( 
			RMobileCall::TMobileCallStatus aNewStatus,
			TInt aCallId );

        /**
         * Checks if is possible to create a conference call
         *         
         *
         * @param CC status
         * @param call list
         */
        void CheckConferenceCapability(
            RMobileConferenceCall::TMobileConferenceStatus aStatus,
            CMmCallList* aCallList );

        /**
         * This method terminates the whole conference call
         *         
         *
         * @param CC status
         * @param call list
         * @return  result of the request
         */
        TInt HangUpL( 
            RMobileConferenceCall::TMobileConferenceStatus aStatus );

        /**
         * This method returns a current snapshot of the call information 
         * associated with the call specified by the aIndex parameter
         *         
         *
         * @param index of the call
         * @param pointer where to copy the call information
         * @param call list
         * @param  CC status
         * @return result of the request
         */
        TInt GetMobileCallInfo( 
            TInt* aIndex, 
            TDes8* aCallInfo, 
            CMmCallList* aCallList,
            RMobileConferenceCall::TMobileConferenceStatus aConferenceStatus );

        /**
         * Checks if given call can be splitted from the conference call
         *         
         *
         * @param call ID of the call to be splitted from CC
         * @param CC status
         * @param call list
         * @return TInt: result of the request
         */
        TInt IsGoOneToOneSupported( 
            TInt aCallId, 
            RMobileConferenceCall::TMobileConferenceStatus aStatus,
            CMmCallList* aCallList );

        /**
         * Returns new status for Conference call
         *         
         *
         * @param  new CC status will be returned using this pointer.
         * @return result of the request
         */
        TInt GetNewStatus( 
            RMobileConferenceCall::TMobileConferenceStatus* aNewStatus );

        /**
         * Is used for resetting internal attributes
         *         
         *
         */
        void ResetAttributes();

        /** 
         * Informs the Gsm extension if there is conference call
         * operation initiated bypassing the ETel (ghost operetion).
         *         
         *
         * @param aDataPackage: information about performed operation
         */
        void CompleteNotifyConferenceEvent( CMmDataPackage* aDataPackage );

		/** 
		 * Informs the Gsm extension if Go-One-To-One handling
		 * has started for any call.
		 * 		
         *
		 * @param aVal True if handling has started
		 * @param aCallId Id of the call for which handling has started
		 */
		void SetGoOneToOneHandlingStarted(TBool aVal, TInt aCallId);

    private: // Constructors and destructor

        /**
         * Default Constructor
         *         
         *
         */     
        CMmConferenceCallGsmWcdmaExt();

        /**
         * Class attributes are created in ConstructL
         */        
        void ConstructL();

        /**
         * Checks if Swap is going on and when Swap is ready 
         *         
         *
         * @param CC status
         * @param call list
         * @param new status of a single call
         * @param call ID of that call
         * @return ETrue if conference call status has changed
         */
        TBool HandleSwap(
            RMobileConferenceCall::TMobileConferenceStatus aStatus,
            CMmCallList& aCallList );

        /**
         * Checks if AddCall is going on and when AddCall is ready 
         *         
         *
         * @param CC status
         * @param call list
         * @param new status of a single call
         * @return ETrue if conference call status has changed
         */
        TBool HandleAddCall(
            RMobileConferenceCall::TMobileConferenceStatus aStatus,
            CMmCallList& aCallList, 
            RMobileCall::TMobileCallStatus aNewStatus );

        /**
         * Checks if CreateConference is going on and when CreateConference is 
         * ready 
         *         
         *
         * @param CC status
         * @param call list
         * @param new status of a single call
         * @param call ID of that call
         * @return ETrue if conference call status has changed
         */
        TBool HandleCreateConference(
            CMmCallList& aCallList, 
            TInt aCallId );

        /**
         * Checks if Conference call is still active or should it go to idle 
         * state 
         *         
         *
         * @param CC status
         * @param call list
         * @param new status of a single call
         * @param call ID of that call
         * @return ETrue if conference call status has changed
         */
        TBool HandleCallRelease(
            RMobileConferenceCall::TMobileConferenceStatus aStatus,
            CMmCallList& aCallList, 
            RMobileCall::TMobileCallStatus aNewStatus, 
            TInt aCallId );

        /**
         * Handles situation where client has asked Hold/Resume from Call 
         * object 
         *         
         *
         * @param CC status
         * @param new status of a single call
         * @return ETrue if conference call status has changed
         */
        TBool HandleSingleCallControl(
            RMobileConferenceCall::TMobileConferenceStatus aStatus,
            RMobileCall::TMobileCallStatus aNewStatus );

        /**
         * Handles GoOneToOne
         *         
         *
         * @param CC status
         * @param call list
         * @param new status of a single call
         * @param call ID of that call
         * @return ETrue if conference call status has changed
         */
        TBool HandleGoOneToOne(
            CMmCallList& aCallList, 
            TInt aCallId );

        /**
         * Updates call capabilities of all calls after a Join operation has
         * been executed (CreateConference or AddCall).
         *         
         *
         * @param call list
         */
        void UpdateCapsAfterJoin( CMmCallList& aCallList ) const;

        /**
         * Updates call capabilities of all calls after a call participating the
         * conference call has gone to idle state.
         *         
         *
         * @param call list
         */
        void UpdateCapsAfterCallRelease( CMmCallList& aCallList ) const;

        /**
         * Updates call capabilities of all calls after a Swap operation 
         * has been executed.
         *         
         *
         * @param conf. status
         * @param call list
         */
        void UpdateCapsAfterSwap(
            RMobileConferenceCall::TMobileConferenceStatus aStatus,
            CMmCallList& aCallList ) const;

    private: 

        /**
         * Pointer to the mode independent Conference call object
         * Not own.         
         */
        CMmConferenceCallTsy* iMmConferenceCallTsy;

        /**
         * Count, how many calls are to be swapped
         */
        TInt iNumberOfCallsToBeSwapped;

        /**
         * Counter telling when Create conference is ready to be completed
         */
        TInt iCreateConferenceCounter;

        /**
         * New conference call status
         */
        RMobileConferenceCall::TMobileConferenceStatus iNewStatus;

        /**
         * Flag telling if this is not the first hold/active status indication
         * caused by client asking hold/resume for a single call.         
         */
        TBool iCallControlStarted;

        /**
         * Counter telling how many calls should still change their state before
         * Conference call changes its' state.         
         */
        TInt iCallsToBeControlled;

        /**
         * Flag telling if GoOneToOne handling is going on.
         */
        TBool iGoOneToOneHandlingStarted;

        /**
         * Go-one-to-one call id
         */
        TInt iGoOneToOneCallId;

        /**
         * Operation initiated bypassing the ETel (ghost operetion).
         */
        TInt iCurrentGhostOperation;

    };

#endif // CMMCONFERENCECALLGSMWCDMAEXT_H