QRadioTuner¶

The QRadioTuner class provides an interface to the systems analog radio device. More…

Synopsis¶

Functions¶

def band ()
def error ()
def errorString ()
def frequency ()
def frequencyRange (band)
def frequencyStep (band)
def isAntennaConnected ()
def isBandSupported (b)
def isMuted ()
def isSearching ()
def isStereo ()
def radioData ()
def setStereoMode (mode)
def signalStrength ()
def state ()
def stereoMode ()
def volume ()

Slots¶

def cancelSearch ()
def searchAllStations ([searchMode=QRadioTuner.SearchFast])
def searchBackward ()
def searchForward ()
def setBand (band)
def setFrequency (frequency)
def setMuted (muted)
def setVolume (volume)
def start ()
def stop ()

Signals¶

def antennaConnectedChanged (connectionStatus)
def bandChanged (band)
def error (error)
def frequencyChanged (frequency)
def mutedChanged (muted)
def searchingChanged (searching)
def signalStrengthChanged (signalStrength)
def stateChanged (state)
def stationFound (frequency, stationId)
def stereoStatusChanged (stereo)
def volumeChanged (volume)

Detailed Description¶

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() .

See also

QRadioData Radio Overview

class PySide2.QtMultimedia.QRadioTuner([parent=None])¶

param parent:

PySide2.QtCore.QObject

Constructs a radio tuner based on a media service allocated by the default media service provider.

The parent is passed to QMediaObject .

PySide2.QtMultimedia.QRadioTuner.State¶

Enumerates radio tuner states.

Constant	Description
QRadioTuner.ActiveState	The tuner is started and active.
QRadioTuner.StoppedState	The tuner device is stopped.

PySide2.QtMultimedia.QRadioTuner.Band¶

Enumerates radio frequency bands.

Constant	Description
QRadioTuner.AM	520 to 1610 kHz, 9 or 10kHz channel spacing, extended 1610 to 1710 kHz
QRadioTuner.FM	87.5 to 108.0 MHz, except Japan 76-90 MHz
QRadioTuner.SW	1.711 to 30.0 MHz, divided into 15 bands. 5kHz channel spacing
QRadioTuner.LW	148.5 to 283.5 kHz, 9kHz channel spacing (Europe, Africa, Asia)
QRadioTuner.FM2	range not defined, used when area supports more than one FM range.

PySide2.QtMultimedia.QRadioTuner.Error¶

Enumerates radio tuner error conditions.

Constant	Description
QRadioTuner.NoError	No errors have occurred.
QRadioTuner.ResourceError	There is no radio service available.
QRadioTuner.OpenError	Unable to open radio device.
QRadioTuner.OutOfRangeError	An attempt to set a frequency or band that is not supported by radio device.

PySide2.QtMultimedia.QRadioTuner.StereoMode¶

Enumerates radio tuner policy for receiving stereo signals.

Constant	Description
QRadioTuner.ForceStereo	Provide stereo mode, converting if required.
QRadioTuner.ForceMono	Provide mono mode, converting if required.
QRadioTuner.Auto	Uses the stereo mode matching the station.

PySide2.QtMultimedia.QRadioTuner.SearchMode¶

Enumerates how the radio tuner should search for stations.

Constant	Description
QRadioTuner.SearchFast	Use only signal strength when searching.
QRadioTuner.SearchGetStationId	After finding a strong signal, wait for the RDS station id (PI) before continuing.

PySide2.QtMultimedia.QRadioTuner.antennaConnectedChanged(connectionStatus)¶

Parameters:: connectionStatus – bool

PySide2.QtMultimedia.QRadioTuner.band()¶

Return type:: Band

This property holds the frequency band a radio tuner is tuned to..

See also

Band

PySide2.QtMultimedia.QRadioTuner.bandChanged(band)¶

Parameters:: band – Band

PySide2.QtMultimedia.QRadioTuner.cancelSearch()¶: Stops scanning for a signal.

See also

searchForward() searchBackward() searching

PySide2.QtMultimedia.QRadioTuner.error()¶

Return type:: Error

Returns the error state of a radio tuner.

See also

errorString()

PySide2.QtMultimedia.QRadioTuner.error(error)

Parameters:: error – Error

PySide2.QtMultimedia.QRadioTuner.errorString()¶

Return type:: str

Returns a description of a radio tuner’s error state.

See also

error()

PySide2.QtMultimedia.QRadioTuner.frequency()¶

Return type:: int

This property holds the frequency in Hertz a radio tuner is tuned to..

PySide2.QtMultimedia.QRadioTuner.frequencyChanged(frequency)¶

Parameters:: frequency – int

PySide2.QtMultimedia.QRadioTuner.frequencyRange(band)¶

Parameters:: band – Band
Return type:

Returns a frequency band ‘s minimum and maximum frequency.

PySide2.QtMultimedia.QRadioTuner.frequencyStep(band)¶

Parameters:: band – Band
Return type:: int

Returns the number of Hertz to increment the frequency by when stepping through frequencies within a given band .

PySide2.QtMultimedia.QRadioTuner.isAntennaConnected()¶

Return type:: bool

This property holds whether there is an antenna connected.

PySide2.QtMultimedia.QRadioTuner.isBandSupported(b)¶

Parameters:: b – Band
Return type:: bool

Identifies if a frequency band is supported by a radio tuner.

Returns true if the band is supported, and false if it is not.

PySide2.QtMultimedia.QRadioTuner.isMuted()¶

Return type:: bool

This property holds whether a radio tuner’s audio output is muted..

PySide2.QtMultimedia.QRadioTuner.isSearching()¶

Return type:: bool

This property holds whether a radio tuner is currently scanning for a signal..

PySide2.QtMultimedia.QRadioTuner.isStereo()¶

Return type:: bool

This property holds whether a radio tuner is receiving a stereo signal..

PySide2.QtMultimedia.QRadioTuner.mutedChanged(muted)¶

Parameters:: muted – bool

PySide2.QtMultimedia.QRadioTuner.radioData()¶

Return type:: PySide2.QtMultimedia.QRadioData

This property holds an instance of QRadioData .

The instance of QRadioData is already bound to this instance of QRadioTuner .

PySide2.QtMultimedia.QRadioTuner.searchAllStations([searchMode=QRadioTuner.SearchFast])¶

Parameters:: searchMode – SearchMode

Search all stations in current band

Emits stationFound (int, QString ) for every found station. After searching is completed, searchingChanged (bool) is emitted (false). If searchMode is set to SearchGetStationId , searching waits for station id (PI) on each frequency.

PySide2.QtMultimedia.QRadioTuner.searchBackward()¶: Starts a backwards scan for a signal, starting from the current frequency .

See also

searchForward() cancelSearch() searching

PySide2.QtMultimedia.QRadioTuner.searchForward()¶: Starts a forward scan for a signal, starting from the current frequency .

See also

searchBackward() cancelSearch() searching

PySide2.QtMultimedia.QRadioTuner.searchingChanged(searching)¶

Parameters:: searching – bool

PySide2.QtMultimedia.QRadioTuner.setBand(band)¶

Parameters:: band – Band

This property holds the frequency band a radio tuner is tuned to..

See also

Band

PySide2.QtMultimedia.QRadioTuner.setFrequency(frequency)¶

Parameters:: frequency – int

This property holds the frequency in Hertz a radio tuner is tuned to..

PySide2.QtMultimedia.QRadioTuner.setMuted(muted)¶

Parameters:: muted – bool

This property holds whether a radio tuner’s audio output is muted..

PySide2.QtMultimedia.QRadioTuner.setStereoMode(mode)¶

Parameters:: mode – StereoMode

This property holds the stereo mode of a radio tuner..

PySide2.QtMultimedia.QRadioTuner.setVolume(volume)¶

Parameters:: volume – int

This property holds the volume of a radio tuner’s audio output as a percentage..

PySide2.QtMultimedia.QRadioTuner.signalStrength()¶

Return type:: int

This property holds the strength of the current radio signal as a percentage..

PySide2.QtMultimedia.QRadioTuner.signalStrengthChanged(signalStrength)¶

Parameters:: signalStrength – int

PySide2.QtMultimedia.QRadioTuner.start()¶: Activate the radio device.

PySide2.QtMultimedia.QRadioTuner.state()¶

Return type:: State

Return the current radio tuner state.

See also

State

PySide2.QtMultimedia.QRadioTuner.stateChanged(state)¶

Parameters:: state – State

PySide2.QtMultimedia.QRadioTuner.stationFound(frequency, stationId)¶

Parameters:

frequency – int
stationId – str

PySide2.QtMultimedia.QRadioTuner.stereoMode()¶

Return type:: StereoMode

This property holds the stereo mode of a radio tuner..

PySide2.QtMultimedia.QRadioTuner.stereoStatusChanged(stereo)¶

Parameters:: stereo – bool

PySide2.QtMultimedia.QRadioTuner.stop()¶: Deactivate the radio device.

PySide2.QtMultimedia.QRadioTuner.volume()¶

Return type:: int

This property holds the volume of a radio tuner’s audio output as a percentage..

PySide2.QtMultimedia.QRadioTuner.volumeChanged(volume)¶

Parameters:: volume – int

Table of Contents

Previous topic

Next topic

QRadioTuner¶

Synopsis¶

Functions¶

Slots¶

Signals¶

Detailed Description¶