/*
* Copyright (c) 2007,2009 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:  Observer for the generic upnp rendering state machine
*
*/

#ifndef C_UPNPRENDERINGSTATEMACHINEOBSERVER_H
#define C_UPNPRENDERINGSTATEMACHINEOBSERVER_H

// INCLUDES
#include <e32base.h>
#include "upnprenderingstatemachineconstants.h" // for types

// FORWARD DECLARATIONS

// CONSTANTS


/**
 * Class for receiving callbacks from
 * rendering state machine
 *
 * @lib upnprenderingstatemachine.lib
 */
class MUpnpRenderingStateMachineObserver
    {
public:

    /**
     * Indicates state machine has been synchronised with the renderer
     * @param aError error that occurred during sync
     */
    virtual void RendererSyncReady( TInt aError,
        Upnp::TState aState ) = 0;

    /**
     * Indicates renderer state has changed
     * either by request or spontanelously.
     * @param aError the error code
     * @param aState the new state
     * @param aUserOriented ETrue if this responds to a request
     * @param aStateParam extra info depending on the state change
     */
    virtual void RenderingStateChanged(
        TInt aError,
        Upnp::TState aState,
        TBool aUserOriented,
        TInt aStateParam ) = 0;

    /**
     * Synchronises UI with media duration and current position
     * this callback can be either automatic or explicitly requested
     * @param aError error that occurred during position sync
     * @param aMode mode in which the track is progressing
     * @param aDuration media duration in milliseconds
     * @param aPosition current position in milliseconds
     */
    virtual void PositionSync( TInt aError,
        Upnp::TPositionMode aMode,
        TInt aDuration, TInt aPosition ) = 0;

    };


#endif // C_UPNPRENDERINGSTATEMACHINEOBSERVER_H