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 |
- 31 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
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 one using the function pointer syntax, you must specify the signal type in a static cast, as shown in this example:
connect(radioTunerControl, static_cast<void(QRadioTunerControl::*)(QRadioTuner::Error)>(&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.
© 2017 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.