Класс QRadioTuner

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

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

Типы общего доступа

Свойства

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

Функции общего доступа

Переопределённые функции общего доступа

• 10 функций общего доступа унаследовано от QMediaObject
• 32 функции общего доступа унаследовано от 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 и Обзор радио.

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

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

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

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

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

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

Перечисляет, как радиотюнер должен искать станции.

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

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

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

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

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

QRadioTuner::QRadioTuner(QObject *parent = Q_NULLPTR)

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

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

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.

Error QRadioTuner::error() const

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

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

[signal] void QRadioTuner::error(QRadioTuner::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)

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

Примечание: Сигнал уведомления для свойства 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.