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 QRadioTuner([parent=None])¶

param parent

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

See also

setBand()

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: unicode

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

See also

error()

PySide2.QtMultimedia.QRadioTuner.frequency()¶

Return type: int

See also

setFrequency()

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

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

PySide2.QtMultimedia.QRadioTuner.isSearching()¶

Return type: bool

PySide2.QtMultimedia.QRadioTuner.isStereo()¶

Return type: bool

PySide2.QtMultimedia.QRadioTuner.mutedChanged(muted)¶

Parameters: muted – bool

PySide2.QtMultimedia.QRadioTuner.radioData()¶

Return type: QRadioData

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

Sets a radio tuner’s frequency band .

Changing the band will reset the frequency to the new band’s minimum frequency.

See also

band()

PySide2.QtMultimedia.QRadioTuner.setFrequency(frequency)¶

Parameters: frequency – int

Sets a radio tuner’s frequency .

If the tuner is set to a frequency outside the current band , the band will be changed to one occupied by the new frequency.

See also

frequency()

PySide2.QtMultimedia.QRadioTuner.setMuted(muted)¶

Parameters: muted – bool

See also

isMuted()

PySide2.QtMultimedia.QRadioTuner.setStereoMode(mode)¶

Parameters: mode – StereoMode

See also

stereoMode()

PySide2.QtMultimedia.QRadioTuner.setVolume(volume)¶

Parameters: volume – int

See also

volume()

PySide2.QtMultimedia.QRadioTuner.signalStrength()¶

Return type: int

PySide2.QtMultimedia.QRadioTuner.signalStrengthChanged(signalStrength)¶

Parameters: signalStrength – int

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

PySide2.QtMultimedia.QRadioTuner.state()¶

Return type: State

PySide2.QtMultimedia.QRadioTuner.stateChanged(state)¶

Parameters: state – State

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

Parameters

frequency – int
stationId – unicode

PySide2.QtMultimedia.QRadioTuner.stereoMode()¶

Return type: StereoMode

See also

setStereoMode()

PySide2.QtMultimedia.QRadioTuner.stereoStatusChanged(stereo)¶

Parameters: stereo – bool

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

PySide2.QtMultimedia.QRadioTuner.volume()¶

Return type: int

See also

setVolume()

PySide2.QtMultimedia.QRadioTuner.volumeChanged(volume)¶

Parameters: volume – int

Qt Documentation

Table of Contents

QRadioTuner¶

Synopsis¶

Functions¶

Slots¶

Signals¶

Detailed Description¶