Home · All Classes · All Functions ·

QRadioTuner Class Reference

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

    #include <QRadioTuner>

Inherits QMediaObject.

Public Types

Properties

Public Functions

Public Slots

Signals

Additional Inherited Members


Detailed Description

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

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


Member Type Documentation

enum QRadioTuner::Band

Enumerates radio frequency bands.

ConstantValueDescription
QRadioTuner::AM0520 to 1610 kHz, 9 or 10kHz channel spacing, extended 1610 to 1710 kHz
QRadioTuner::FM187.5 to 108.0 MHz, except Japan 76-90 MHz
QRadioTuner::SW21.711 to 30.0 MHz, divided into 15 bands. 5kHz channel spacing
QRadioTuner::LW3148.5 to 283.5 kHz, 9kHz channel spacing (Europe, Africa, Asia)
QRadioTuner::FM24range not defined, used when area supports more than one FM range.

enum QRadioTuner::Error

Enumerates radio tuner error conditions.

ConstantValueDescription
QRadioTuner::NoError0No errors have occurred.
QRadioTuner::ResourceError1There is no radio service available.
QRadioTuner::OpenError2Unable to open radio device.
QRadioTuner::OutOfRangeError3An attempt to set a frequency or band that is not supported by radio device.

enum QRadioTuner::State

Enumerates radio tuner states.

ConstantValueDescription
QRadioTuner::ActiveState0The tuner is started and active.
QRadioTuner::StoppedState1The tuner device is stopped.

enum QRadioTuner::StereoMode

Enumerates radio tuner policy for receiving stereo signals.

ConstantValueDescription
QRadioTuner::Auto2Uses the stereo mode matching the station.
QRadioTuner::ForceStereo0Provide stereo mode, converting if required.
QRadioTuner::ForceMono1Provide mono mode, converting if required.


Property Documentation

band : Band

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

Access functions:

See also QRadioTuner::Band.

frequency : int

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

Access functions:

muted : bool

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

Access functions:

searching : const bool

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

Access functions:

See also searchForward(), searchBackward(), and cancelSearch().

signalStrength : const int

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

Access functions:

state : const State

Return the current radio tuner state.

Access functions:

See also QRadioTuner::State.

stereo : const bool

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

Access functions:

stereoMode : StereoMode

This property holds the stereo mode of a radio tuner.

Access functions:

volume : int

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

Access functions:


Member Function Documentation

QRadioTuner::QRadioTuner ( QObject * parent = 0, QMediaServiceProvider * provider = QMediaServiceProvider::defaultServiceProvider() )

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

The parent is passed to QMediaObject.

QRadioTuner::~QRadioTuner ()

Destroys a radio tuner.

QtMultimediaKit::AvailabilityError QRadioTuner::availabilityError () const   [virtual]

Returns the availability error state.

Reimplemented from QMediaObject.

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

Signals a radio tuner's band has changed.

void QRadioTuner::cancelSearch ()   [slot]

Stops scanning for a signal.

See also searchForward(), searchBackward(), and searching.

Error QRadioTuner::error () const

Returns the error state of a radio tuner.

See also errorString().

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

Signals that an error occurred.

QString QRadioTuner::errorString () const

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

See also error().

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

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

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::isAvailable () const   [virtual]

Returns true if the radio tuner service is ready to use.

Reimplemented from QMediaObject.

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.

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

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

void QRadioTuner::searchBackward ()   [slot]

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

See also searchForward(), cancelSearch(), and searching.

void QRadioTuner::searchForward ()   [slot]

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

See also searchBackward(), cancelSearch(), and searching.

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

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

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

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

void QRadioTuner::start ()   [slot]

Activate the radio device.

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

This signal is emitted when the state changes to state.

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

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

void QRadioTuner::stop ()   [slot]

Deactivate the radio device.

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

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


Copyright © 2010 Nokia Corporation and/or its subsidiary(-ies) Trademarks
Qt Mobility Project 1.0.1