/*
* Copyright (c) 2008 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:  Manages the call bubble extension plugins.
*
*/


#ifndef C_CPHONEBUBBLEEXTENSIONMANAGER_H
#define C_CPHONEBUBBLEEXTENSIONMANAGER_H

class TPhoneCmdParamCallHeaderData;
class CPhoneBubbleExtensionData;
class CPhoneBubbleExtension;
class CBubbleManager;
class TPriorityItem;

/**
 * Bubble extension plugin manager.
 * Keeps track of the extension plugins.
 *
 *  @lib ?library
 *  @since S60 5.0
 */
class CPhoneBubbleExtensionManager : public CBase
    {
public:

    /**
     * Two-phased constructor
     *
     * @param aBubbleManager Reference to bubble manager
     */
    static CPhoneBubbleExtensionManager* NewL( CBubbleManager& aBubbleManager );

    /**
     * Two-phased constructor
     *
     * @param aBubbleManager Reference to bubble manager
     */
    static CPhoneBubbleExtensionManager* NewLC( CBubbleManager& aBubbleManager );

    virtual ~CPhoneBubbleExtensionManager();

    /**
     * Notifies the plugin framework about a new call.
     *
     * @param aBubbleId Bubble id of the new call
     * @param aParams Call parameters
     */
    void StartCallL( TInt aBubbleId, TPhoneCmdParamCallHeaderData* aParams );

    /**
     * Notifies the plugin framework about cleared call.
     *
     * @param aId Bubble id of the call
     */
    void StopCall( TInt aBubbleId);
    
    /**
     * Notifies the plugin framework about changed call state.
     *
     * @param aId Bubble id of the call
     * @param aNewState New call state. (TPEState, not bubble state)
     */
    void UpdateCallState( TInt aBubbleId, TInt aNewState );

    /**
     * Loads all plugins
     */
    void InitializeL();
    
private:

    /**
     * First phase constructor
     *
     * @param aBubbleManager Reference to bubble manager
     */
    CPhoneBubbleExtensionManager( CBubbleManager& aBubbleManager );

    void ConstructL();

    /**
     * Loads plugin priorities.
     * TODO: Currently there is no plugin priorities, all plugins
     *       use the default priority. Nothing is loaded.
     */
    void LoadPrioritiesL();
    
    /**
     * Unloads all plugins, closes all calls
     */
    void Reset();
    
private: // data

    /**
     * Bubble manager reference
     */
    CBubbleManager& iBubbleManager;
    
    /**
     * Array that holds all the loaded plugins
     */
    RPointerArray<CPhoneBubbleExtension> iPlugins;

    /**
     * Array that holds all the call data
     */
    RPointerArray<CPhoneBubbleExtensionData> iCalls;

    /**
     * Are the plugins already loaded?
     */
    TBool iInitialized;

    /**
     * Plugin priorities
     */
    RArray<TPriorityItem> iPriorityArray;
    
    };

#endif // C_CPHONEBUBBLEEXTENSIONMANAGER_H