/*
* Copyright (c) 2004 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:  Video call abstraction
*
*/



#ifndef CVTCTLVIDEOCALL_H
#define CVTCTLVIDEOCALL_H

//  INCLUDES
#include <etelmm.h>
#include "MVtCtlCallControl.h"
#include "MVtCtlCallStatusObserver.h"


// FORWARD DECLARATIONS
class CVtCtlCallStatusMonitor;

// CLASS DECLARATION

/**
*  Video call abstraction
*
*  @lib CSCallCtrl
*  @since 2.6
*/
NONSHARABLE_CLASS( CVtCtlVideoCall ) : 
    public CBase,
    public MVtCtlCallStatusObserver
    {
    public:
        
        /**
        * Call information
        */
        struct TVtCtlCallInfo
            {
            // Session state
            MVtCtlCallControl::TVtCtlState     iStatus;
            // Previous session state
            MVtCtlCallControl::TVtCtlState     iPreviousStatus;
            // Session id
            TVtCtlSessionId                    iId;
            // Session direction
            MVtCtlCallControl::TVtCtlDirection iDirection;
            };

    public:  // Constructors and destructor
        
        /**
        * Two-phased constructor.
        * @param aDataLine line subsession
        * @param aId session id
        * @param aObserver call status observer
        */
        /*****************************************************
        *   Series 60 Customer / ETel
        *   Series 60  ETel API
        *****************************************************/
        static CVtCtlVideoCall* NewL( 
            RMobileLine& aDataLine,
            TVtCtlSessionId aId,
            MVtCtlCallStatusObserver& aObserver
            );

        /**
        * Destructor.
        */
        virtual ~CVtCtlVideoCall();

    public: // New functions
        
        /**
        * Returns call info
        * @return reference to call info
        */
        const CVtCtlVideoCall::TVtCtlCallInfo& CallInfo() const;

        /**
        * Returns Etel call info
        * @return call info
        */
        /*****************************************************
        *   Series 60 Customer / ETel
        *   Series 60  ETel API
        *****************************************************/
        const RMobileCall::TMobileCallInfoV1& MobileInfo() const;

        /**
        * Opens call subsession and starts monitoring call status.
        * @param aCallName call name
        */
        /*****************************************************
        *   Series 60 Customer / ETel
        *   Series 60  ETel API
        *****************************************************/
        void InitializeCallL( RMobileCall& aCall );

        /**
        * Updates call information from ETel
        * @return Symbian OS error code
        */
        TInt UpdateCallInfo();

        /**
        * Returns call duration from Etel
        * @param aDuration duration
        * @return Symbian OS error code
        */
        TInt GetDuration( TVtCtlDuration& aDuration );
        
        /**
        * Obtains video call state from the server and returns it.
        * @param aState updated call state
        * @return Symbian OS error code
        * @since S60 3.1
        */
        TInt GetCallState( MVtCtlCallControl::TVtCtlState& aState );

    protected:  // From MVtCtlCallStatusObserver
        
        /**
        * @see MVtCtlCallStatusObserver::HandleCallStatusChangeL
        */
        virtual void HandleCallStatusChangeL( 
            TVtCtlSessionId aId,
            MVtCtlCallControl::TVtCtlState aStatus,
            MVtCtlCallControl::TVtCtlState aPreviousStatus );

    private:

        /**
        * C++ constructor.
        * @param aDataLine data line
        * @param aId session id
        * @param aObserver observer
        */
        /*****************************************************
        *   Series 60 Customer / ETel
        *   Series 60  ETel API
        *****************************************************/
        CVtCtlVideoCall( 
            RMobileLine& aDataLine, 
            TVtCtlSessionId aId,
            MVtCtlCallStatusObserver& aObserver );

    private:    // Data

        // Call information
        TVtCtlCallInfo iCallInfo;

        // Etel call
        /*****************************************************
        *   Series 60 Customer / ETel
        *   Series 60  ETel API
        *****************************************************/
        RMobileCall* iCall;

        // Data line
        /*****************************************************
        *   Series 60 Customer / ETel
        *   Series 60  ETel API
        *****************************************************/
        RMobileLine& iLine;

        // Etel call information
        /*****************************************************
        *   Series 60 Customer / ETel
        *   Series 60  ETel API
        *****************************************************/
        RMobileCall::TMobileCallInfoV1 iMobileCallInfo;
        
        // Call status monitor
        CVtCtlCallStatusMonitor* iStatusMonitor;

        // Call status observer
        MVtCtlCallStatusObserver& iObserver;
    };

#endif      // CVTCTLVIDEOCALL_H   
            
// End of File