MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

QRadioTuner Class Reference

The QRadioTuner class provides an interface to the systems analog radio device. More...

 #include <QRadioTuner>

Inherits: QMediaObject.

This class was introduced in Qt Mobility 1.0.

Public Types

enum Band { AM, FM, SW, LW, FM2 }
enum Error { NoError, ResourceError, OpenError, OutOfRangeError }
enum State { ActiveState, StoppedState }
enum StereoMode { Auto, ForceStereo, ForceMono }

Properties

Public Functions

QRadioTuner ( QObject * parent = 0, QMediaServiceProvider * provider = QMediaServiceProvider::defaultServiceProvider() )
~QRadioTuner ()
Band band () const
Error error () const
QString errorString () const
int frequency () const
QPair<int, int> frequencyRange ( Band band ) const
int frequencyStep ( Band band ) const
bool isBandSupported ( Band band ) const
bool isMuted () const
bool isSearching () const
bool isStereo () const
void setStereoMode ( QRadioTuner::StereoMode mode )
int signalStrength () const
State state () const
StereoMode stereoMode () const
int volume () const

Reimplemented Public Functions

virtual QtMultimediaKit::AvailabilityError availabilityError () const
virtual bool isAvailable () const

Public Slots

void cancelSearch ()
void searchBackward ()
void searchForward ()
void setBand ( Band band )
void setFrequency ( int frequency )
void setMuted ( bool muted )
void setVolume ( int volume )
void start ()
void stop ()
  • 1 public slot inherited from QObject

Signals

void bandChanged ( QRadioTuner::Band band )
void error ( QRadioTuner::Error error )
void frequencyChanged ( int frequency )
void mutedChanged ( bool muted )
void searchingChanged ( bool searching )
void signalStrengthChanged ( int strength )
void stateChanged ( QRadioTuner::State state )
void stereoStatusChanged ( bool stereo )
void volumeChanged ( int volume )

Additional Inherited Members

  • 1 public variable inherited from QObject
  • 4 static public members inherited from QObject
  • 2 protected functions inherited from QMediaObject
  • 7 protected functions inherited from QObject
  • 2 protected variables inherited from QObject

Detailed Description

The QRadioTuner class provides an interface to the systems analog radio device.

You can control the systems analog radio device using this interface, for example:

 radio = new QRadioTuner;
 connect(radio, SIGNAL(frequencyChanged(int)), this, SLOT(freqChanged(int)));
 if (radio->isBandSupported(QRadioTuner::FM)) {
     radio->setBand(QRadioTuner::FM);
     radio->setFrequency(yourRadioStationFrequency);
     radio->setVolume(100);
     radio->start();
 }

The radio object will emit signals for any changes in state such as: bandChanged(), frequencyChanged(), stereoStatusChanged(), searchingChanged(), signalStrengthChanged(), volumeChanged(), mutedChanged().

You can change between the frequency bands using setBand() however it is recommended that you check to make sure the band is available first using isBandSupported().

Member Type Documentation

enum QRadioTuner::Band

Enumerates radio frequency bands.

Constant Value Description
QRadioTuner::AM 0 520 to 1610 kHz, 9 or 10kHz channel spacing, extended 1610 to 1710 kHz
QRadioTuner::FM 1 87.5 to 108.0 MHz, except Japan 76-90 MHz
QRadioTuner::SW 2 1.711 to 30.0 MHz, divided into 15 bands. 5kHz channel spacing
QRadioTuner::LW 3 148.5 to 283.5 kHz, 9kHz channel spacing (Europe, Africa, Asia)
QRadioTuner::FM2 4 range not defined, used when area supports more than one FM range.

enum QRadioTuner::Error

Enumerates radio tuner error conditions.

Constant Value Description
QRadioTuner::NoError 0 No errors have occurred.
QRadioTuner::ResourceError 1 There is no radio service available.
QRadioTuner::OpenError 2 Unable to open radio device.
QRadioTuner::OutOfRangeError 3 An attempt to set a frequency or band that is not supported by radio device.

enum QRadioTuner::State

Enumerates radio tuner states.

Constant Value Description
QRadioTuner::ActiveState 0 The tuner is started and active.
QRadioTuner::StoppedState 1 The tuner device is stopped.

enum QRadioTuner::StereoMode

Enumerates radio tuner policy for receiving stereo signals.

Constant Value Description
QRadioTuner::Auto 2 Uses the stereo mode matching the station.
QRadioTuner::ForceStereo 0 Provide stereo mode, converting if required.
QRadioTuner::ForceMono 1 Provide mono mode, converting if required.

Property Documentation

band : Band

This property holds the frequency band a radio tuner is tuned to.

This property was introduced in Qt Mobility 1.0.

Access functions:

Band band () const
void setBand ( Band band )

Notifier signal:

void bandChanged ( QRadioTuner::Band band )

See also QRadioTuner::Band.

frequency : int

This property holds the frequency in Hertz a radio tuner is tuned to.

This property was introduced in Qt Mobility 1.0.

Access functions:

int frequency () const
void setFrequency ( int frequency )

Notifier signal:

void frequencyChanged ( int frequency )

muted : bool

This property holds whether a radio tuner's audio output is muted.

This property was introduced in Qt Mobility 1.0.

Access functions:

bool isMuted () const
void setMuted ( bool muted )

Notifier signal:

void mutedChanged ( bool muted )

searching : const bool

This property holds whether a radio tuner is currently scanning for a signal.

This property was introduced in Qt Mobility 1.0.

Access functions:

bool isSearching () const

Notifier signal:

void searchingChanged ( bool searching )

See also searchForward(), searchBackward(), and cancelSearch().

signalStrength : const int

This property holds the strength of the current radio signal as a percentage.

This property was introduced in Qt Mobility 1.0.

Access functions:

int signalStrength () const

Notifier signal:

void signalStrengthChanged ( int strength )

state : const State

Return the current radio tuner state.

This property was introduced in Qt Mobility 1.0.

Access functions:

State state () const

Notifier signal:

void stateChanged ( QRadioTuner::State state )

See also QRadioTuner::State.

stereo : const bool

This property holds whether a radio tuner is receiving a stereo signal.

This property was introduced in Qt Mobility 1.0.

Access functions:

bool isStereo () const

Notifier signal:

void stereoStatusChanged ( bool stereo )

stereoMode : StereoMode

This property holds the stereo mode of a radio tuner.

This property was introduced in Qt Mobility 1.0.

Access functions:

StereoMode stereoMode () const
void setStereoMode ( QRadioTuner::StereoMode mode )

volume : int

This property holds the volume of a radio tuner's audio output as a percentage.

This property was introduced in Qt Mobility 1.0.

Access functions:

int volume () const
void setVolume ( int volume )

Notifier signal:

void volumeChanged ( int volume )

Member Function Documentation

QRadioTuner::QRadioTuner ( QObject * parent = 0, QMediaServiceProvider * provider = QMediaServiceProvider::defaultServiceProvider() )

Constructs a radio tuner based on a media service allocated by a media service provider.

The parent is passed to QMediaObject.

This function was introduced in Qt Mobility 1.0.

QRadioTuner::~QRadioTuner ()

Destroys a radio tuner.

QtMultimediaKit::AvailabilityError QRadioTuner::availabilityError () const [virtual]

Reimplemented from QMediaObject::availabilityError().

Returns the availability error state.

This function was introduced in Qt Mobility 1.0.

void QRadioTuner::bandChanged ( QRadioTuner::Band band ) [signal]

Signals a radio tuner's band has changed.

This function was introduced in Qt Mobility 1.0.

void QRadioTuner::cancelSearch () [slot]

Stops scanning for a signal.

This function was introduced in Qt Mobility 1.0.

See also searchForward(), searchBackward(), and searching.

Error QRadioTuner::error () const

Returns the error state of a radio tuner.

This function was introduced in Qt Mobility 1.0.

See also errorString().

void QRadioTuner::error ( QRadioTuner::Error error ) [signal]

Signals that an error occurred.

This function was introduced in Qt Mobility 1.0.

QString QRadioTuner::errorString () const

Returns a description of a radio tuner's error state.

This function was introduced in Qt Mobility 1.0.

See also error().

void QRadioTuner::frequencyChanged ( int frequency ) [signal]

Signals that the frequency a radio tuner is tuned to has changed.

This function was introduced in Qt Mobility 1.0.

QPair<int, int> QRadioTuner::frequencyRange ( Band band ) const

Returns a frequency band's minimum and maximum frequency.

This function was introduced in Qt Mobility 1.0.

int QRadioTuner::frequencyStep ( Band band ) const

Returns the number of Hertz to increment the frequency by when stepping through frequencies within a given band.

This function was introduced in Qt Mobility 1.0.

bool QRadioTuner::isAvailable () const [virtual]

Reimplemented from QMediaObject::isAvailable().

Returns true if the radio tuner service is ready to use.

This function was introduced in Qt Mobility 1.0.

bool QRadioTuner::isBandSupported ( Band band ) const

Identifies if a frequency band is supported by a radio tuner.

Returns true if the band is supported, and false if it is not.

This function was introduced in Qt Mobility 1.0.

void QRadioTuner::mutedChanged ( bool muted ) [signal]

Signals that the muted state of a radio tuner's audio output has changed.

This function was introduced in Qt Mobility 1.0.

void QRadioTuner::searchBackward () [slot]

Starts a backwards scan for a signal, starting from the current frequency.

This function was introduced in Qt Mobility 1.0.

See also searchForward(), cancelSearch(), and searching.

void QRadioTuner::searchForward () [slot]

Starts a forward scan for a signal, starting from the current frequency.

This function was introduced in Qt Mobility 1.0.

See also searchBackward(), cancelSearch(), and searching.

void QRadioTuner::searchingChanged ( bool searching ) [signal]

Signals that the searching state of a radio tuner has changed.

This function was introduced in Qt Mobility 1.0.

void QRadioTuner::signalStrengthChanged ( int strength ) [signal]

Signals that the strength of the signal received by a radio tuner has changed.

This function was introduced in Qt Mobility 1.0.

void QRadioTuner::start () [slot]

Activate the radio device.

This function was introduced in Qt Mobility 1.0.

void QRadioTuner::stateChanged ( QRadioTuner::State state ) [signal]

This signal is emitted when the state changes to state.

This function was introduced in Qt Mobility 1.0.

void QRadioTuner::stereoStatusChanged ( bool stereo ) [signal]

Signals that the stereo state of a radio tuner has changed.

This function was introduced in Qt Mobility 1.0.

void QRadioTuner::stop () [slot]

Deactivate the radio device.

This function was introduced in Qt Mobility 1.0.

void QRadioTuner::volumeChanged ( int volume ) [signal]

Signals that the volume of a radio tuner's audio output has changed.

This function was introduced in Qt Mobility 1.0.