The QRadioTuner class provides an interface to the systems analog radio device. More...
#include <QRadioTuner>
Inherits QMediaObject.
| 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 ( 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.
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.
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.
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.
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.
Access functions:
| int | signalStrength () const |
Notifier signal:
| void | signalStrengthChanged ( int strength ) |
Return the current radio tuner state.
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.
Access functions:
| bool | isStereo () const |
Notifier signal:
| void | stereoStatusChanged ( bool stereo ) |
This property holds the stereo mode of a radio tuner.
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.
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.
Destroys a radio tuner.
Reimplemented from QMediaObject::availabilityError().
Returns the availability error state.
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.
Reimplemented from QMediaObject::isAvailable().
Returns true if the radio tuner service is ready to use.
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.