/*
* 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:  RTP observer for SVP
*
*/


#ifndef SVPRTPOBSERVERREQUEST_H
#define SVPRTPOBSERVERREQUEST_H

// INCLUDES
#include <e32base.h>
#include "svptimerobserver.h"

// FORWARD DECLARATIONS
class CSVPSessionBase;
class CMceSession;
class CMceMediaStream;
class CSVPTimer;

// CLASS DECLARATION

/**
 * CSVPRtpObserverRequest
 * 
 */
class CSVPRtpObserverRequest : public CBase, public MSVPTimerObserver
    {
public:     // Data types
    
    // Enumeration to determine RTCP activitytype
    enum TReceivedRtcpPacket
        {
        ERtcpRrPacket = 0,
        ERtcpSrPacket = 1
        };
    
public:     // Constructors and destructor

    /**
     * Destructor.
     */
    ~CSVPRtpObserverRequest();

    /**
     * Two-phased constructor.
     */
    static CSVPRtpObserverRequest* NewL( CSVPSessionBase& aSession );

    /**
     * Two-phased constructor.
     */
    static CSVPRtpObserverRequest* NewLC(  CSVPSessionBase& aSession  );
    
public:     // New functions
    
    /**
     * Returns the SVP session associated to this request.
     * @since S60 v3.2
     * @return CSVPSessionBase
     */
    const CSVPSessionBase* SvpSession() const;
    
    /**
     * Returns the MCE session associated to this request.
     * @since S60 v3.2
     * @return CMceSession
     */
    const CMceSession* MceSession() const;
    
    /**
     * Called when RTCP RR or SR packet has been received.
     * @since S60 v3.2
     * @aPacket RTCP packet type
     * @aSession MCE session
     * @aStream MCE media stream.
     */
    void RtcpPacketReceived( TReceivedRtcpPacket aPacket,
        CMceSession& aSession, CMceMediaStream& aStream );
    
    /**
     * Called when associated session's state has changed.
     * @since S60 3.2
     */
    void Reset();


public:     // Functions from base classes
    
    // From MSVPTimerObserver
    void TimedOut( TInt aTimerId );
    
private:     // New functions
    
    /**
     * Determines the RTCP timeout value based on the media stream and
     * it's associated codecs. Returns default value (35 seconds) if
     * error is encountered.
     * @since S60 v3.2
     * @param aStream Stream from where to search the timeout value
     * @return TInt RTCP timeout value in milliseconds
     */
    TInt DetermineTimeoutValue( CMceMediaStream& aStream ) const;

    /**
     * Returns ETrue if the associated session is currently in Hold state 
     * @since S60 v3.2.3
     * @return TBool value
     */
    TBool IsSessionInHoldState();
    
private:    // Consturctors

    /**
     * Constructor for performing 1st stage construction
     */
    CSVPRtpObserverRequest( CSVPSessionBase& aSession );

    /**
     * EPOC default constructor for performing 2nd stage construction
     */
    void ConstructL();

private:    // Data
    
    /**
     * SVP session associated to this observing request
     * Not own
     */
    CSVPSessionBase& iSession;
    
    /**
     * Timer for determining RTCP timeout.
     * Own
     */
    CSVPTimer* iTimer;
    
    /**
     * Flag to indicate that 'disconnect' state has been informed.
     */
    TBool iDisconnectSent;

public:     // For testing purposes
    friend class UT_CSVPRtpObserverRequest;
    };

#endif // SVPRTPOBSERVERREQUEST_H