Класс 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, если нет.