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.
enum | Band { AM, FM, SW, LW, FM2 } |
enum | Error { NoError, ResourceError, OpenError, OutOfRangeError } |
enum | State { ActiveState, StoppedState } |
enum | StereoMode { Auto, ForceStereo, ForceMono } |
|
|
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 |
virtual QtMultimediaKit::AvailabilityError | availabilityError () const |
virtual bool | isAvailable () const |
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 () |
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 ) |
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().
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. |
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. |
Enumerates radio tuner states.
Constant | Value | Description |
---|---|---|
QRadioTuner::ActiveState | 0 | The tuner is started and active. |
QRadioTuner::StoppedState | 1 | The tuner device is stopped. |
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. |
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.
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 ) |
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 ) |
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().
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 ) |
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.
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 ) |
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 ) |
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 ) |
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.
Destroys a radio tuner.
Reimplemented from QMediaObject::availabilityError().
Returns the availability error state.
This function was introduced in Qt Mobility 1.0.
Signals a radio tuner's band has changed.
This function was introduced in Qt Mobility 1.0.
Stops scanning for a signal.
This function was introduced in Qt Mobility 1.0.
See also searchForward(), searchBackward(), and searching.
Returns the error state of a radio tuner.
This function was introduced in Qt Mobility 1.0.
See also errorString().
Signals that an error occurred.
This function was introduced in Qt Mobility 1.0.
Returns a description of a radio tuner's error state.
This function was introduced in Qt Mobility 1.0.
See also error().
Signals that the frequency a radio tuner is tuned to has changed.
This function was introduced in Qt Mobility 1.0.
Returns a frequency band's minimum and maximum frequency.
This function was introduced in Qt Mobility 1.0.
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.
Reimplemented from QMediaObject::isAvailable().
Returns true if the radio tuner service is ready to use.
This function was introduced in Qt Mobility 1.0.
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.
Signals that the muted state of a radio tuner's audio output has changed.
This function was introduced in Qt Mobility 1.0.
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.
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.
Signals that the searching state of a radio tuner has changed.
This function was introduced in Qt Mobility 1.0.
Signals that the strength of the signal received by a radio tuner has changed.
This function was introduced in Qt Mobility 1.0.
Activate the radio device.
This function was introduced in Qt Mobility 1.0.
This signal is emitted when the state changes to state.
This function was introduced in Qt Mobility 1.0.
Signals that the stereo state of a radio tuner has changed.
This function was introduced in Qt Mobility 1.0.
Deactivate the radio device.
This function was introduced in Qt Mobility 1.0.
Signals that the volume of a radio tuner's audio output has changed.
This function was introduced in Qt Mobility 1.0.
© 2008-2011 Nokia Corporation and/or its subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide.
All other trademarks are property of their respective owners. Privacy Policy
Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia.
Alternatively, this document may be used under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.