![]() |
Home · All Classes · All Functions · | ![]() |
The QRadioTuner class provides an interface to the systems analog radio device. More...
#include <QRadioTuner>
Inherits QMediaObject.
|
|
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.
Access functions:
See also QRadioTuner::Band.
This property holds the frequency in Hertz a radio tuner is tuned to.
Access functions:
This property holds whether a radio tuner's audio output is muted.
Access functions:
This property holds whether a radio tuner is currently scanning for a signal.
Access functions:
See also searchForward(), searchBackward(), and cancelSearch().
This property holds the strength of the current radio signal as a percentage.
Access functions:
Return the current radio tuner state.
Access functions:
See also QRadioTuner::State.
This property holds whether a radio tuner is receiving a stereo signal.
Access functions:
This property holds the stereo mode of a radio tuner.
Access functions:
This property holds the volume of a radio tuner's audio output as a percentage.
Access functions:
Constructs a radio tuner based on a media service allocated by a media service provider.
The parent is passed to QMediaObject.
Destroys a radio tuner.
Returns the availability error state.
Reimplemented from QMediaObject.
Signals a radio tuner's band has changed.
Stops scanning for a signal.
See also searchForward(), searchBackward(), and searching.
Returns the error state of a radio tuner.
See also errorString().
Signals that an error occurred.
Returns a description of a radio tuner's error state.
See also error().
Signals that the frequency a radio tuner is tuned to has changed.
Returns a frequency band's minimum and maximum frequency.
Returns the number of Hertz to increment the frequency by when stepping through frequencies within a given band.
Returns true if the radio tuner service is ready to use.
Reimplemented from QMediaObject.
Identifies if a frequency band is supported by a radio tuner.
Returns true if the band is supported, and false if it is not.
Signals that the muted state of a radio tuner's audio output has changed.
Starts a backwards scan for a signal, starting from the current frequency.
See also searchForward(), cancelSearch(), and searching.
Starts a forward scan for a signal, starting from the current frequency.
See also searchBackward(), cancelSearch(), and searching.
Signals that the searching state of a radio tuner has changed.
Signals that the strength of the signal received by a radio tuner has changed.
Activate the radio device.
This signal is emitted when the state changes to state.
Signals that the stereo state of a radio tuner has changed.
Deactivate the radio device.
Signals that the volume of a radio tuner's audio output has changed.
| Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies) | Trademarks | Qt Mobility Project 1.0.1 |