Класс QRadioTuner

Класс 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 = nullptr)

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

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

void QRadioTuner::bandChanged(QRadioTuner::Band band)

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

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

void QRadioTuner::cancelSearch()

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

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

void QRadioTuner::error(QRadioTuner::Error error)

Сигнализирует о том, что произошла ошибка error.

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

void QRadioTuner::frequencyChanged(int frequency)

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

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

void QRadioTuner::mutedChanged(bool muted)

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

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

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(QRadioTuner::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.

[virtual] QRadioTuner::~QRadioTuner()

Удаляет радиоприемник.

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

Переопределяет: QMediaObject::availability() const.

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

QRadioTuner::Error QRadioTuner::error() const

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

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

QString QRadioTuner::errorString() const

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

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

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

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

int QRadioTuner::frequencyStep(QRadioTuner::Band band) const

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

bool QRadioTuner::isBandSupported(QRadioTuner::Band band) const

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

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