QRadioTuner Class

  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();
  }

成员函数

QRadioTuner::QRadioTuner(QObject *parent = Q_NULLPTR)

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

The parent is passed to QMediaObject.

QRadioTuner::~QRadioTuner()

Destroys a radio tuner.

[override virtual] QMultimedia::AvailabilityStatus QRadioTuner::availability() const

Reimplemented from QMediaObject::availability().

Returns the availability of the radio tuner.

[signal] void QRadioTuner::bandChanged(QRadioTuner::Band band)

Signals a radio tuner's band has changed.

Note: Notifier signal for property band.

[slot] void QRadioTuner::cancelSearch()

Stops scanning for a signal.

参见 searchForward(), searchBackward(), and searching.

Error QRadioTuner::error() const

Returns the error state of a radio tuner.

参见 errorString().

[signal] void QRadioTuner::error(QRadioTuner::Error error)

Signals that an error 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(radioTuner, static_cast<void(QRadioTuner::*)(QRadioTuner::Error)>(&QRadioTuner::error),
      [=](QRadioTuner::Error error){ /* ... */ });

QString QRadioTuner::errorString() const

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

参见 error().

[signal] void QRadioTuner::frequencyChanged(int frequency)

Signals that the frequency a radio tuner is tuned to has changed.

Note: Notifier signal for property frequency.

QPair<int, int> QRadioTuner::frequencyRange(Band band) const

Returns a frequency band's minimum and maximum frequency.

int QRadioTuner::frequencyStep(Band band) const

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

bool QRadioTuner::isBandSupported(Band band) const

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

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

[signal] void QRadioTuner::mutedChanged(bool muted)

Signals that the muted state of a radio tuner's audio output has changed.

Note: Notifier signal for property muted.

[slot] void QRadioTuner::searchAllStations(QRadioTuner::SearchMode searchMode = QRadioTuner::SearchFast)

Search all stations in current band

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

参见 searchForward(), searchBackward(), and searching.

[slot] void QRadioTuner::searchBackward()

Starts a backwards scan for a signal, starting from the current frequency.

参见 searchForward(), cancelSearch(), and searching.

[slot] void QRadioTuner::searchForward()

Starts a forward scan for a signal, starting from the current frequency.

参见 searchBackward(), cancelSearch(), and searching.

[signal] void QRadioTuner::searchingChanged(bool searching)

Signals that the searching state of a radio tuner has changed.

Note: Notifier signal for property searching.

[slot] void QRadioTuner::setBand(Band band)

Sets a radio tuner's frequency band.

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

Note: Setter function for property band.

参见 band().

[slot] void QRadioTuner::setFrequency(int frequency)

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.

Note: Setter function for property frequency.

参见 frequency().

[signal] void QRadioTuner::signalStrengthChanged(int strength)

Signals that the strength of the signal received by a radio tuner has changed.

Note: Notifier signal for property signalStrength.

[slot] void QRadioTuner::start()

Activate the radio device.

[signal] void QRadioTuner::stateChanged(QRadioTuner::State state)

This signal is emitted when the state changes to state.

Note: Notifier signal for property state.

[signal] void QRadioTuner::stationFound(int frequency, QString stationId)

Signals that a station was found in frequency with stationId Program Identification code.

[signal] void QRadioTuner::stereoStatusChanged(bool stereo)

Signals that the stereo state of a radio tuner has changed.

Note: Notifier signal for property stereo.

[slot] void QRadioTuner::stop()

Deactivate the radio device.

[signal] void QRadioTuner::volumeChanged(int volume)

Signals that the volume of a radio tuner's audio output has changed.

Note: Notifier signal for property volume.