Класс QRadioTuner

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

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

Открытые типы

Свойства

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

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

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

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

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

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

Сигналы

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

Статические публичные члены

• 9 статических публичных членов унаследовано от 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 и Обзор радио.

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

перечисление QRadioTuner::Band

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

перечисление QRadioTuner::Error

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

перечисление QRadioTuner::SearchMode

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

перечисление QRadioTuner::State

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

перечисление QRadioTuner::StereoMode

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

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

QRadioTuner::QRadioTuner(QObject *parent = nullptr)

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

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

[virtual] QRadioTuner::~QRadioTuner()

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

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

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

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

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

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

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

[slot] void QRadioTuner::cancelSearch()

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

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

QRadioTuner::Error QRadioTuner::error() const

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

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

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

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

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

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

QString QRadioTuner::errorString() const

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

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

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

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

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

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

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

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

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

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

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

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

[signal] void QRadioTuner::mutedChanged(bool 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(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.