/*

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

* All rights reserved.

* This component and the accompanying materials are made available

* under the terms of the License "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 VCXNSCONTENTCLIENTHANDLER_H_

#define VCXNSCONTENTCLIENTHANDLER_H_

// INCLUDES

#include <e32base.h>

#include "MIptvVodContentClientObserver.h"

#include <ipvideo/vcxconnutilengineobserver.h>

// FORWARD DECLARATIONS

class CIptvVodContentClient;

class CVcxNsUiEngine;

class CVcxConnectionUtility;

// TYPEDEFS

typedef TUint32 TIptvServiceId;

/**

* Class CVcxNsContentClientHandler handles content client interactions.

*

* @lib vcxnsuiengine.lib

*/

class CVcxNsContentClientHandler : public CBase,

                                   public MIptvVodContentClientObserver,

                                   public MConnUtilEngineObserver 

    {

public:

    /**

     * Constructor.

     * 

     * @param aUiEngine Ui engine

     * @param aConnUtil Connection util

     */

    static CVcxNsContentClientHandler* CVcxNsContentClientHandler::NewL( 

                    CVcxNsUiEngine& aUiEngine, CVcxConnectionUtility& aConnUtil );

    virtual ~CVcxNsContentClientHandler();

    /**

     * Returns content management client.

     * @return Pointer to CIptvVodContentClient object.

     */

    CIptvVodContentClient* GetVodContentClientL( TUint32 aServiceId );

    /**

     * Updates the given service's ecg.

     * This causes the iap to be reasked if necessary.

     * 

     * @param   aServiceId  Service id

     * @return Error code

     */

    TInt UpdateEcgL( TUint32 aServiceId );

    /**

     * Stores mpx media id to content database.

     * @param    aServiceId          Service id

     * @param    aContentId          Content id

     * @param    aCaIndex            Content access index

     * @param    aMpxId              Mpx id.

     */

    void StoreMpxIdToEcgDbL( TUint32 aServiceId,

                             TUint32 aContentId,

                             TUint32 aCaIndex,

                             TUint32 aMpxId );

    /**

     * Stores Last Playing Position to content database.

     * @param    aServiceId          Service id

     * @param    aContentId          Content id

     * @param    aCaIndex            Content access index

     * @param    aPos                Last play pos.

     */

    void StoreLastPlayPosL( TUint32 aServiceId,

                            TUint32 aContentId,

                            TUint32 aCaIndex,

                            TReal32 aPos );

// From MIptvVodContentClientObserver

    /**

    * Messages from EPG manager are handled here. Messages are defined in CIptvUtil.h

    * @since            Engine 1.1

    * @param aMsg       Message 

    * @param aInfo      Info 

    * @param aServiceId Service id.

    */

    void HandleEpgManagerMsgL( TInt aMsg, TInt aInfo, TIptvServiceId aServiceId );   

// from MConnUtilEngineObserver

    /**

    * This method is called by the vcxconnectionutility when 

    * it has received a notification about the availibility of

    * "better" iap in the network. This might happen  

    * when WLAN defined in the corresponding destination becomes

    * available or when WLAN carrier is lost and there is defined

    * 3G/gprs iap (or another available WLAN) in the destination

    * being used.

    *

    * Client don't have to accept the changing of the iap. If client 

    * returns EFalse notifying it does not want to roam, then the 

    * iap will not be changed.

    *

    * This however might result in diconnecting, if the old iap is 

    * no longer available, like it would happen when WLAN carrier is lost

    *

    * @return TBool  ETrue: roaming accepted, EFalse: Roaming not accepted

    */

    TBool RequestIsRoamingAllowedL();

    /**

     * This method is called by the vcxconnectionutility when 

     * there have been some change in the iap currently using:

     * 

     * Connection lost: this happens when for example WLAN carrier 

     * is lost and there is no other iap to use to or when corresponding

     * connection is closed by some other application.

     *

     * Iap change by the roaming: if client has accepted roaming

     * vcxconnectionutility notifies about new iap is ready to use

     *

     * When client is being called by this method, it can request a

     * iap id by calling CVcxConnectionUtility::GetIap-

     */

    void IapChangedL();

    /**

     * Return iap query status.

     * 

     * @return ETrue if connection for service has been created or

     *         will be triggered via MIptvVodContentClientObserver

     *         interface, otherwise EFalse

     */

    TBool IapAsked( TUint32 aServiceId );

    /**

     * Set specified service iap query status.

     * 

     * @param aServiceId the service id, that value is to be set.

     * @param aSet Value to be set to iap asked flag

     */

    void SetIapAsked( TUint32 aServiceId, TBool aSet );

private:

    /**

     * Constructor.

     * 

     * @param aUiEngine Ui engine

     * @param aConnUtil Connection util

     */

    CVcxNsContentClientHandler( CVcxNsUiEngine& aUiEngine, 

                                CVcxConnectionUtility& aConnUtil );

    /**

     * Private 2nd phase construction.

     */

    void ConstructL();

// Data

    /**

     * Pointers to VOD Content Clients.

     * Own.

     */

    RPointerArray<CIptvVodContentClient> iVodContentClients;

    /**

     * Array of content client service id's. 

     */

    RArray<TInt> iVodContentClientIds;

    /**

     * Array of flags, if the iap query is needed for service

     * This must be set to ETrue by default. If user cancels in 

     * connection creation dialog, then set to EFalse

     */

    RArray<TBool> iIapAsked;

    /**

     * CVcxNsUiEngine

     */

    CVcxNsUiEngine& iUiEngine; 

    /**

     * Reference to connection utility

     */

    CVcxConnectionUtility& iConnUtil;

    };

#endif /*VCXNSCONTENTCLIENTHANDLER_H_*/