QRadioTunerControl Class
The QRadioTunerControl class provides access to the radio tuning functionality of a QMediaService. More...
Header: | #include <QRadioTunerControl> |
qmake: | QT += multimedia |
Inherits: | QMediaControl |
Public Functions
~QRadioTunerControl() | |
virtual QRadioTuner::Band | band() const = 0 |
virtual void | cancelSearch() = 0 |
virtual QRadioTuner::Error | error() const = 0 |
virtual QString | errorString() const = 0 |
virtual int | frequency() const = 0 |
virtual QPair<int, int> | frequencyRange(QRadioTuner::Band band) const = 0 |
virtual int | frequencyStep(QRadioTuner::Band band) const = 0 |
virtual bool | isAntennaConnected() const |
virtual bool | isBandSupported(QRadioTuner::Band band) const = 0 |
virtual bool | isMuted() const = 0 |
virtual bool | isSearching() const = 0 |
virtual bool | isStereo() const = 0 |
virtual void | searchAllStations(QRadioTuner::SearchMode searchMode = QRadioTuner::SearchFast) = 0 |
virtual void | searchBackward() = 0 |
virtual void | searchForward() = 0 |
virtual void | setBand(QRadioTuner::Band band) = 0 |
virtual void | setFrequency(int frequency) = 0 |
virtual void | setMuted(bool muted) = 0 |
virtual void | setStereoMode(QRadioTuner::StereoMode mode) = 0 |
virtual void | setVolume(int volume) = 0 |
virtual int | signalStrength() const = 0 |
virtual void | start() = 0 |
virtual QRadioTuner::State | state() const = 0 |
virtual QRadioTuner::StereoMode | stereoMode() const = 0 |
virtual void | stop() = 0 |
virtual int | volume() const = 0 |
- 32 public functions inherited from QObject
Signals
void | antennaConnectedChanged(bool connectionStatus) |
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 | stationFound(int frequency, QString stationId) |
void | stereoStatusChanged(bool stereo) |
void | volumeChanged(int volume) |
- 2 signals inherited from QObject
Protected Functions
QRadioTunerControl(QObject *parent = Q_NULLPTR) |
- 9 protected functions inherited from QObject
Macros
QRadioTunerControl_iid |
Additional Inherited Members
- 1 property inherited from QObject
- 1 public slot inherited from QObject
- 11 static public members inherited from QObject
Detailed Description
The QRadioTunerControl class provides access to the radio tuning functionality of a QMediaService.
If a QMediaService can tune an analog radio device it will implement QRadioTunerControl. This control provides a means to tune a radio device to a specific frequency as well as search forwards and backwards for a signal.
The functionality provided by this control is exposed to application code through the QRadioTuner class.
The interface name of QRadioTunerControl is org.qt-project.qt.radiotunercontrol/5.0
as defined in QRadioTunerControl_iid.
See also QMediaService::requestControl() and QRadioTuner.
Member Function Documentation
[protected]
QRadioTunerControl::QRadioTunerControl(QObject *parent = Q_NULLPTR)
Constructs a radio tuner control with the given parent.
QRadioTunerControl::~QRadioTunerControl()
Destroys a radio tuner control.
[signal]
void QRadioTunerControl::antennaConnectedChanged(bool connectionStatus)
Signals that the antenna has either been connected or disconnected as reflected with the connectionStatus.
[pure virtual]
QRadioTuner::Band QRadioTunerControl::band() const
Returns the frequency band a radio tuner is tuned to.
See also setBand().
[signal]
void QRadioTunerControl::bandChanged(QRadioTuner::Band band)
Signals that the frequency band a radio tuner is tuned to has changed.
[pure virtual]
void QRadioTunerControl::cancelSearch()
Stops scanning for a signal.
[pure virtual]
QRadioTuner::Error QRadioTunerControl::error() const
Returns the error state of a radio tuner.
[signal]
void QRadioTunerControl::error(QRadioTuner::Error error)
Signals that an error has occurred.
Note: Signal error is overloaded in this class. To connect to this signal by using the function pointer syntax, Qt provides a convenient helper for obtaining the function pointer as shown in this example:
connect(radioTunerControl, QOverload<QRadioTuner::Error>::of(&QRadioTunerControl::error), [=](QRadioTuner::Error error){ /* ... */ });
[pure virtual]
QString QRadioTunerControl::errorString() const
Returns a string describing a radio tuner's error state.
[pure virtual]
int QRadioTunerControl::frequency() const
Returns the frequency a radio tuner is tuned to.
See also setFrequency().
[signal]
void QRadioTunerControl::frequencyChanged(int frequency)
Signals that the frequency a radio tuner is tuned to has changed.
[pure virtual]
QPair<int, int> QRadioTunerControl::frequencyRange(QRadioTuner::Band band) const
Returns a frequency band's minimum and maximum frequency.
[pure virtual]
int QRadioTunerControl::frequencyStep(QRadioTuner::Band band) const
Returns the number of Hertz to increment the frequency by when stepping through frequencies within a given band.
[virtual]
bool QRadioTunerControl::isAntennaConnected() const
Identifies if there is an antenna connected to the device.
Returns true if there is a connected antenna, and false otherwise.
[pure virtual]
bool QRadioTunerControl::isBandSupported(QRadioTuner::Band band) const
Identifies if a frequency band is supported.
Returns true if the band is supported, and false if it is not.
[pure virtual]
bool QRadioTunerControl::isMuted() const
Identifies if a radio tuner's audio output is muted.
Returns true if the audio is muted, and false if it is not.
[pure virtual]
bool QRadioTunerControl::isSearching() const
Identifies if a radio tuner is currently scanning for signal.
Returns true if the tuner is scanning, and false if it is not.
[pure virtual]
bool QRadioTunerControl::isStereo() const
Identifies if a radio tuner is receiving a stereo signal.
Returns true if the tuner is receiving a stereo signal, and false if it is not.
[signal]
void QRadioTunerControl::mutedChanged(bool muted)
Signals that the muted state of a radio tuner's audio output has changed.
[pure virtual]
void QRadioTunerControl::searchAllStations(QRadioTuner::SearchMode searchMode = QRadioTuner::SearchFast)
Starts a scan through the whole frequency band searching all stations with a specific searchMode.
[pure virtual]
void QRadioTunerControl::searchBackward()
Starts a backwards scan for a signal, starting from the current frequency().
[pure virtual]
void QRadioTunerControl::searchForward()
Starts a forward scan for a signal, starting from the current frequency().
[signal]
void QRadioTunerControl::searchingChanged(bool searching)
Signals that the searching state of a radio tuner has changed.
[pure virtual]
void QRadioTunerControl::setBand(QRadioTuner::Band band)
Sets the frequecy band a radio tuner is tuned to.
Changing the frequency band will reset the frequency to the minimum frequency of the new band.
See also band().
[pure virtual]
void QRadioTunerControl::setFrequency(int frequency)
Sets the frequency a radio tuner is tuned to.
See also frequency().
[pure virtual]
void QRadioTunerControl::setMuted(bool muted)
Sets the muted state of a radio tuner's audio output.
See also isMuted().
[pure virtual]
void QRadioTunerControl::setStereoMode(QRadioTuner::StereoMode mode)
Sets a radio tuner's stereo mode.
See also stereoMode() and QRadioTuner::StereoMode.
[pure virtual]
void QRadioTunerControl::setVolume(int volume)
Sets the percentage volume of a radio tuner's audio output.
See also volume().
[pure virtual]
int QRadioTunerControl::signalStrength() const
Return a radio tuner's current signal strength as a percentage.
[signal]
void QRadioTunerControl::signalStrengthChanged(int strength)
Signals that the percentage strength of the signal received by a radio tuner has changed.
[pure virtual]
void QRadioTunerControl::start()
Activate the radio device.
[pure virtual]
QRadioTuner::State QRadioTunerControl::state() const
Returns the current radio tuner state.
[signal]
void QRadioTunerControl::stateChanged(QRadioTuner::State state)
Signals that the state of a radio tuner has changed.
[signal]
void QRadioTunerControl::stationFound(int frequency, QString stationId)
Signals that new station with frequency and stationId was found when scanning
[pure virtual]
QRadioTuner::StereoMode QRadioTunerControl::stereoMode() const
Returns a radio tuner's stereo mode.
See also setStereoMode() and QRadioTuner::StereoMode.
[signal]
void QRadioTunerControl::stereoStatusChanged(bool stereo)
Signals that the stereo state of a radio tuner has changed.
[pure virtual]
void QRadioTunerControl::stop()
Deactivate the radio device.
[pure virtual]
int QRadioTunerControl::volume() const
Returns the volume of a radio tuner's audio output as a percentage.
See also setVolume().
[signal]
void QRadioTunerControl::volumeChanged(int volume)
Signals that the percentage volume of radio tuner's audio output has changed.
Macro Documentation
QRadioTunerControl_iid
org.qt-project.qt.radiotunercontrol/5.0
Defines the interface name of the QRadioTunerControl class.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qradiotunercontrol.html