/*

* Copyright (c) 2007 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:    Observer class for wrapping RConnection.*

*/

#ifndef MCRCONNECTIONOBSERVER_H

#define MCRCONNECTIONOBSERVER_H

// INCLUDES

#include <e32base.h>

// CONSTANTS

// None

// MACROS

// None

// DATA TYPES

// None

// FORWARD DECLARATIONS

// None

// CLASS DECLARATION

/**

*  Observer for connection interface status.

*

*  @lib CommonRecordingEngine.lib

*  @since Series 60 3.0

*/

class MCRConnectionObserver

    {

public: // Data types

    /**

    * TCRConnectionStatus is set of indications to be sent to client

    */

    enum TCRConnectionStatus

        {                        

    	ECRBearerChanged,        /**< Indicates change in network bearer */

		ECRIapDown,				 /**< Network connection lost */

    	ECRConnectionError,      /**< Unable to open connection in RTP engine & CR engine */

    	ECRConnecting,			 /**< Indicates "connection on progress" state to ui */

    	ECRAuthenticationNeeded, /**< Used to request username/password from ui */

        ECRNotEnoughBandwidth,	 /**< Stream has too high bitrate for our network */

    	ECRNormalEndOfStream,    /**< Clip ends normally */

    	ECRSwitchingToTcp,       /**< Indicates a udp->tcp switch, client may need to reset player */

    	ECRStreamIsLiveStream,   /**< Indicates that we have stream that can't be paused */

    	ECRAttachCompleted,      /**< Sent when attached to RConnection */

    	ECRStreamIsRealMedia,    /**< Indicates that stream is (unsupported) realmedia format */

        ECRTestSinkData,         /**< Data from TestSink (former NullSink) to test client observer */

		ECRSdpAvailable,         /**< Used to communicate availability of SDP */

        ECRReadyToSeek,          /**< Used to communicate seeking posibility */

        ECRRecordingStarted,     /**< Used to communicate recording state */

        ECRRecordingPaused,      /**< Used to communicate recording state */

        ECRRecordingEnded        /**< Used to communicate recording state */

        };     

    /**

    * This method is called after connection status changes or there is an error

    * @since Series 60 3.0

    * @param aSessionId Id to session generating the status change or message. 0 points to no session.

    * @param aConnection Reference to connection object being used.

    * @param aInterfaceUp flags if interface has gone up (ETrue)

    *        or down (EFalse).

    * @param aError error value associated.

    * @return none.

    */

    virtual void ConnectionStatusChange( TInt aSessionId,

                                         const TCRConnectionStatus aStatus,

                                         TInt aErr ) = 0;

    };

#endif // MCRCONNECTIONOBSERVER_H

// End of file