/****************************************************************************
**
** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (qt-info@nokia.com)
**
** This file is part of the Qt Mobility Components.
**
** $QT_BEGIN_LICENSE:LGPL$
** No Commercial Usage
** This file contains pre-release code and may not be distributed.
** You may use this file in accordance with the terms and conditions
** contained in the Technology Preview License Agreement accompanying
** this package.
**
** GNU Lesser General Public License Usage
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file. Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Nokia gives you certain additional
** rights. These rights are described in the Nokia Qt LGPL Exception
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
** If you have questions regarding the use of this file, please contact
** Nokia at qt-info@nokia.com.
**
**
**
**
**
**
**
**
** $QT_END_LICENSE$
**
****************************************************************************/
#ifndef S60RADIOTUNERCONTROL_H
#define S60RADIOTUNERCONTROL_H
#include <QtCore/qobject.h>
#include <QRadioTunerControl>
#include <QRadioTuner>
#include <radioutility.h>
#include <radiofmtunerutility.h>
#include <radioplayerutility.h>
class S60RadioTunerService;
class CFMRadioEngineCallObserver;
QTM_USE_NAMESPACE
class S60RadioTunerControl
: public QRadioTunerControl
, public MRadioPlayerObserver
, public MRadioFmTunerObserver
{
Q_OBJECT
public:
S60RadioTunerControl(QObject *parent = 0);
~S60RadioTunerControl();
QRadioTuner::State state() const;
QRadioTuner::Band band() const;
void setBand(QRadioTuner::Band b);
bool isBandSupported(QRadioTuner::Band b) const;
int frequency() const;
int frequencyStep(QRadioTuner::Band b) const;
QPair<int,int> frequencyRange(QRadioTuner::Band b) const;
void setFrequency(int frequency);
bool isStereo() const;
QRadioTuner::StereoMode stereoMode() const;
void setStereoMode(QRadioTuner::StereoMode mode);
int signalStrength() const;
int volume() const;
void setVolume(int volume);
bool isMuted() const;
void setMuted(bool muted);
bool isSearching() const;
void searchForward();
void searchBackward();
void cancelSearch();
bool isValid() const;
bool isAvailable() const;
QtMedia::AvailabilityError availabilityError() const;
void start();
void stop();
QRadioTuner::Error error() const;
QString errorString() const;
/**
* From MRadioPlayerObserver.
* Called when Radio state changed.
*
* @since S60 3.2
* @param aState Radio player state
* @param aError A standard system error code, only used when aState is ERadioPlayerIdle
*/
void MrpoStateChange(TPlayerState aState, TInt aError);
/**
* From MRadioPlayerObserver.
* Called when volume changes. This may be caused by other applications.
*
* @since S60 3.2
* @param aVolume Current volume.
*/
void MrpoVolumeChange(TInt aVolume);
/**
* From MRadioPlayerObserver.
* Called when mute setting changes. This may be caused by other applications.
*
* @since S60 3.2
* @param aMute ETrue indicates audio is muted.
*/
void MrpoMuteChange(TBool aMute);
/**
* From MRadioPlayerObserver.
* Called when mute setting changes. This may be caused by other applications.
*
* Called when balance setting changes. This may be caused by other applications.
*
* @since S60 3.2
* Left speaker volume percentage. This can be any value from zero to 100.
* Zero value means left speaker is muted.
* @param aRightPercentage
* Right speaker volume percentage. This can be any value from zero to 100.
* Zero value means right speaker is muted.
*/
void MrpoBalanceChange(TInt aLeftPercentage, TInt aRightPercentage);
/**
* From MRadioFmTunerObserver.
* Called when Request for tuner control completes.
*
* @since S60 3.2
* @param aError A standard system error code or FM tuner error (TFmRadioTunerError).
*/
void MrftoRequestTunerControlComplete(TInt aError);
/**
* From MRadioFmTunerObserver.
* Set frequency range complete event. This event is asynchronous and is received after
* a call to CRadioFmTunerUtility::SetFrequencyRange.
*
* @since S60 3.2
* @param aError A standard system error code or FM tuner error (TFmRadioTunerError).
*/
void MrftoSetFrequencyRangeComplete(TInt aError);
/**
* From MRadioFmTunerObserver.
* Set frequency complete event. This event is asynchronous and is received after a call to
* CRadioFmTunerUtility::SetFrequency.
*
* @since S60 3.2
* @param aError A standard system error code or FM tuner error (TFmRadioTunerError).
*/
void MrftoSetFrequencyComplete(TInt aError);
/**
* From MRadioFmTunerObserver.
* Station seek complete event. This event is asynchronous and is received after a call to
* CRadioFmTunerUtility::StationSeek.
*
* @since S60 3.2
* @param aError A standard system error code or FM tuner error (TFmRadioTunerError).
* @param aFrequency The frequency(Hz) of the radio station that was found.
*/
void MrftoStationSeekComplete(TInt aError, TInt aFrequency);
/**
* From MRadioFmTunerObserver.
* Called when FM Transmitter status changes (if one is present in the device). Tuner receiver
* is forced to be turned off due to hardware conflicts when FM transmitter is activated.
*
* @since S60 3.2
* @param aActive ETrue if FM transmitter is active; EFalse otherwise.
*/
void MrftoFmTransmitterStatusChange(TBool aActive);
/**
* From MRadioFmTunerObserver.
* Called when antenna status changes.
*
* @since S60 3.2
* @param aAttached ETrue if antenna is attached; EFalse otherwise.
*/
void MrftoAntennaStatusChange(TBool aAttached);
/**
* From MRadioFmTunerObserver.
* Called when offline mode status changes.
* @since S60 3.2
*
** @param aAttached ETrue if offline mode is enabled; EFalse otherwise.
*/
void MrftoOfflineModeStatusChange(TBool aOfflineMode);
/**
* From MRadioFmTunerObserver.
* Called when the frequency range changes. This may be caused by other applications.
*
* @since S60 3.2
* @param aNewRange New frequency range.
*/
void MrftoFrequencyRangeChange(TFmRadioFrequencyRange aBand /*, TInt aMinFreq, TInt aMaxFreq*/);
/**
* From MRadioFmTunerObserver.
* Called when the tuned frequency changes. This may be caused by other
* applications or RDS if AF/TA is enabled.
*
* @since S60 3.2
* @param aNewFrequency The new tuned frequency(Hz).
*/
void MrftoFrequencyChange(TInt aNewFrequency);
/**
* From MRadioFmTunerObserver.
* Called when the forced mono status change. This may be caused by other applications.
*
* @since S60 3.2
* @param aForcedMono ETrue if forced mono mode is enabled; EFalse otherwise.
*/
void MrftoForcedMonoChange(TBool aForcedMono);
/**
* From MRadioFmTunerObserver.
* Called when the squelch (muting the frequencies without broadcast) status change.
* This may be caused by other applications.
*
* @since S60 3.2
* @param aSquelch ETrue if squelch is enabled; EFalse otherwise.
*/
void MrftoSquelchChange(TBool aSquelch);
private:
bool initRadio();
mutable int m_error;
CRadioUtility* m_radioUtility;
CRadioFmTunerUtility* m_fmTunerUtility;
CRadioPlayerUtility* m_playerUtility;
TInt m_maxVolume;
bool m_tunerControl;
bool m_audioInitializationComplete;
bool m_muted;
bool m_isStereo;
bool m_available;
int m_vol;
mutable int m_signal;
bool m_scanning;
QRadioTuner::Band m_currentBand;
qint64 m_currentFreq;
QRadioTuner::Error m_radioError;
QRadioTuner::StereoMode m_stereoMode;
QString m_errorString;
// caps meaning what the tuner can do.
// TTunerCapabilities m_currentTunerCapabilities;
QRadioTuner::State m_apiTunerState;
};
#endif