/*
* 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 "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 IRQPLAYERADAPTERINTERFACE_H_
#define IRQPLAYERADAPTERINTERFACE_H_

#include <QObject>
#include "irqenums.h"

class IRQMetaData;

/*
 * IRQPlayerAdapterInterface is the interface to use MMF adapter or PHONON adapter
 */
class IRQPlayerAdapterInterface : public QObject
{
    Q_OBJECT

public:

    /**
     *  Play specific url via certain access point id
     */
    virtual void playStation(const QString &aUrl, int aApId) = 0;

    /**
     *  Stop Playback
     */
    virtual void stop() = 0;

    /**
     *  Set volume to player
     */
    virtual void setVolume(int aVolume) = 0;

    /**
     *  Get current volume from player
     */
    virtual int getVolume() = 0;

    /**
     *  Get audio player instance
     */
    virtual void* getPlayerInstance() = 0;

signals:

    /**
     *  Connection is established
     */
    void connectionEstablished(int aBitrate);

    /**
     *  Send errors out
     */
    void errorOccured(IRQError aError);

    /**
     *  Send buffering progress out
     */
    void percentageBuffered(int aPercentage);

    /**
     *  Send meta data out
     */
    void metaDataReceived(IRQMetaData& aIRmetaData);

    /**
     *  Gets the preset volume
     */
    void volumeExpected(int& aVolume);

public:

    enum PlayState
    {
        EStopped     = 0,                    // Initial state; playback stopped
        EOpenning    = 1,                    // Try to open the url through MMF
        EConnecting  = 2,                    // Try to connect to the url
        EBuffering   = 3,                    // Buffer data
        EPlaying     = 4                     // Play the audio stream
    };

    PlayState             iPlayState;        // A simple state machine
};

#endif /* IRQPLAYERADAPTERINTERFACE_H_ */