Класс QRadioTuner

Класс QRadioTuner предоставляет интерфейс к аналоговому радиоустройству системы. Подробнее...

• Список всех членов, включая унаследованные

Типы публичного доступа

Свойства

• 1 свойство унаследовано от QMediaObject
• 1 свойство унаследовано от QObject

Открытые функции

Переопределенные открытые функции

• 10 открытых функций унаследовано от QMediaObject
• 31 открытых функций унаследовано от QObject

Открытые слоты

• 1 открытый слот унаследован от QObject

Сигналы

• 6 сигналов унаследовано от QMediaObject
• 2 сигнала унаследовано от QObject

Дополнительные унаследованные члены

• 11 статических публичных членов, унаследованных от QObject
• 2 защищенных функции, унаследованные от QMediaObject
• 9 защищенных функций, унаследованных от QObject

Подробное описание

Класс QRadioTuner предоставляет интерфейс к аналоговому радиоустройству системы.

Вы можете управлять аналоговым радиоустройством системы с помощью этого интерфейса, например:

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

Объект радио будет излучать сигналы при любых изменениях состояния, таких как: bandChanged(), frequencyChanged(), stereoStatusChanged(), searchingChanged(), signalStrengthChanged(), volumeChanged(), mutedChanged().

Вы можете переключаться между частотными диапазонами, используя setBand(), однако рекомендуется предварительно проверить доступность диапазона с помощью isBandSupported().

См. также QRadioData и Обзор радио.

Документация по типам членов

enum QRadioTuner::Band

Перечисляет радиочастотные диапазоны.

enum QRadioTuner::Error

Перечисляет условия ошибок радиотюнера.

enum QRadioTuner::SearchMode

Перечисляет способы поиска станций радиотюнером.

enum QRadioTuner::State

Перечисляет состояния радиотюнера.

enum QRadioTuner::StereoMode

Перечисляет политику радиотюнера для приема стереосигналов.

Документация по функциям членов

QRadioTuner::QRadioTuner(QObject *parent = Q_NULLPTR)

Создает радиотюнер на основе медиаслужбы, выделенной поставщиком по умолчанию.

parent передается в QMediaObject.

QRadioTuner::~QRadioTuner()

Уничтожает радиотюнер.

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

Переопределено из QMediaObject::availability().

Возвращает доступность радиотюнера.

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

Сигнализирует о том, что диапазон band радиотюнера изменился.

Примечание: Сигнал уведомления для свойства band.

[slot] void QRadioTuner::cancelSearch()

Останавливает поиск сигнала.

См. также searchForward(), searchBackward() и searching.

Error QRadioTuner::error() const

Возвращает состояние ошибки радиотюнера.

См. также errorString().

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

Сигнализирует о возникновении ошибки error.

Примечание: Сигнал error перегружен в этом классе. Чтобы подключиться к нему с помощью синтаксиса указателя функции, необходимо указать тип сигнала в статическом приведении, как показано в этом примере:

connect(radioTuner, static_cast<void(QRadioTuner::*)(QRadioTuner::Error)>(&QRadioTuner::error),
    [=](QRadioTuner::Error error){ /* ... */ });

QString QRadioTuner::errorString() const

Возвращает описание состояния ошибки радиотюнера.

См. также error().

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

Сигнализирует о том, что частота, к которой настроен радиотюнер, изменилась.

Примечание: Сигнал уведомления для свойства frequency.

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

Возвращает минимальную и максимальную частоты диапазона band.

int QRadioTuner::frequencyStep(Band band) const

Возвращает количество Герц для приращения частоты при переходе через частоты в заданном диапазоне band.

bool QRadioTuner::isBandSupported(Band band) const

Определяет, поддерживается ли частотный диапазон band радиоприёмником.

Возвращает true, если диапазон поддерживается, и false, если нет.

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

Сигнализирует о том, что состояние muted аудиовыхода радиоприёмника изменилось.

Примечание: Сигнал уведомления для свойства muted.

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

Поиск всех станций в текущем диапазоне

Вызывает QRadioTuner::stationFound(int, QString) для каждой найденной станции. После завершения поиска, генерируется QRadioTuner::searchingChanged(bool) (false). Если searchMode установлен в SearchGetStationId, поиск ожидает идентификатор станции (PI) на каждой частоте.

См. также searchForward(), searchBackward(), и searching.

[slot] void QRadioTuner::searchBackward()

Начинает обратный поиск сигнала, начиная с текущей частоты.

См. также searchForward(), cancelSearch(), и searching.

[slot] void QRadioTuner::searchForward()

Начинает прямой поиск сигнала, начиная с текущей частоты.

См. также searchBackward(), cancelSearch(), и searching.

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

Сигнализирует о том, что состояние поиска в радиоприёмнике изменилось.

Примечание: Сигнал уведомления для свойства searching.

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

Устанавливает частотный диапазон радиоприёмника.

Изменение диапазона сбросит частоту до минимальной частоты нового диапазона.

Примечание: Функция-установщик для свойства band.

См. также band().

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

Устанавливает частоту радиоприёмника.

Если приёмник устанавливается на частоту вне текущего диапазона, диапазон будет изменён на тот, который содержит новую частоту.

Примечание: Функция-установщик для свойства frequency.

См. также frequency().

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

Сигнализирует о том, что сила принятого радиоприёмником сигнала изменилась.

Примечание: Сигнал уведомления для свойства signalStrength.

[slot] void QRadioTuner::start()

Активировать радиоустройство.

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

Этот сигнал генерируется при изменении состояния на state.

Примечание: Сигнал уведомления для свойства state.

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

Сигнализирует о том, что станция была найдена на частоте frequency с идентификатором stationId кодом идентификации программы.

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

Сигнализирует о том, что состояние стерео радиоприёмника изменилось.

Примечание: Сигнал уведомления для свойства stereo.

[slot] void QRadioTuner::stop()

Деактивировать радиоустройство.

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

Сигнализирует о том, что громкость аудиовыхода радиоприёмника изменилась.

Примечание: Сигнал уведомления для свойства volume.