/*

* 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 IRQMEDIAPLAYER_H_

#define IRQMEDIAPLAYER_H_

#include <QObject>

#include "irqenums.h"

class IRQPlayerAdapterInterface;

class IRQMetaData;

class CStereoWidening;

/**

 * This class provides the interface to IR Media Player component

 */

class IRQMediaPlayer : public QObject

{

    Q_OBJECT

public:

    /**

     *  Constructor

     */

    IMPORT_C IRQMediaPlayer();

    /**

     *  Destructor

     */

    ~IRQMediaPlayer();

    /**

     *  Returns the current volume of playback, it's a percentage

     *  @return int

     */

    IMPORT_C int  getVolume();

public slots:

    /**

     *  Plays a radio station

     */

    IMPORT_C void playStation(const QString &aUrl, int aApId);

    /**

     *  Stops playback

     */

    IMPORT_C void stop();

    /**

     *  Sets the volume to player, it's a percentage

     */

    IMPORT_C void setVolume(int aVolume);

    /**

     *  Turns on the stereo effect

     */

    IMPORT_C void enableStereoEffect();

    /**

     *  Turns off the stereo effect

     */

    IMPORT_C void disableStereoEffect();

signals:

    /**

     *  Notifies the successful connection with a radio station

     */

    void connectionEstablished(int aBitrate);

    /**

     *  Notifies the error

     */

    void errorOccured(IRQError aError);

    /**

     *  Notifies the buffering status

     */

    void percentageBuffered(int aPercentage);

    /**

     *  Notifies the meta data

     */

    void metaDataReceived(IRQMetaData& aIRMetaData);

    /**

     *  Gets the preset volume, it's a percentage

     */

    void volumeExpected(int& aVolume);

private:

    /**

     *  Turns on the stereo effect

     */

    void enableStereoEffectL();

private:

    /**

     *  Player adpater interface

     */

    IRQPlayerAdapterInterface* iPlayer;

    /**

     *  Used for handling Stereo Mode

     */

    CStereoWidening* iStereoEffect;

};

#endif /* IRQMEDIAPLAYER_H_ */