Spec-Zone.ru › Qt 5.11

Класс QRadioTuner

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

Заголовок: #include <QRadioTuner>
qmake: QT += multimedia
Наследует: QMediaObject
  • Список всех членов, включая унаследованные

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

Перечисление Band { AM, FM, SW, LW, FM2 }
Перечисление Error { NoError, ResourceError, OpenError, OutOfRangeError }
Перечисление SearchMode { SearchFast, SearchGetStationId }
Перечисление State { ActiveState, StoppedState }
Перечисление StereoMode { ForceStereo, ForceMono, Auto }

Свойства

  • antennaConnected : const bool
  • band : Band
  • frequency : int
  • muted : bool
  • radioData : QRadioData* const
  • searching : const bool
  • signalStrength : const int
  • state : const State
  • stereo : const bool
  • stereoMode : StereoMode
  • volume : int
  • 1 свойство унаследовано от QMediaObject
  • 1 свойство унаследовано от QObject

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

QRadioTuner(QObject *parent = nullptr)
virtual ~QRadioTuner()
QRadioTuner::Band band() const
QRadioTuner::Error error() const
QString errorString() const
int frequency() const
QPair<int, int> frequencyRange(QRadioTuner::Band band) const
int frequencyStep(QRadioTuner::Band band) const
bool isAntennaConnected() const
bool isBandSupported(QRadioTuner::Band band) const
bool isMuted() const
bool isSearching() const
bool isStereo() const
QRadioData * radioData() const
void setStereoMode(QRadioTuner::StereoMode mode)
int signalStrength() const
QRadioTuner::State state() const
QRadioTuner::StereoMode stereoMode() const
int volume() const

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

virtual QMultimedia::AvailabilityStatus availability() const override
  • 10 открытых функций унаследовано от QMediaObject
  • 34 открытых функции унаследовано от QObject

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

void cancelSearch()
void searchAllStations(QRadioTuner::SearchMode searchMode = QRadioTuner::SearchFast)
void searchBackward()
void searchForward()
void setBand(QRadioTuner::Band band)
void setFrequency(int frequency)
void setMuted(bool muted)
void setVolume(int volume)
void start()
void stop()
  • 1 открытый слот унаследован от QObject

Сигналы

void antennaConnectedChanged(bool connectionStatus)
void bandChanged(QRadioTuner::Band band)
void error(QRadioTuner::Error error)
void frequencyChanged(int frequency)
void mutedChanged(bool muted)
void searchingChanged(bool searching)
void signalStrengthChanged(int strength)
void stateChanged(QRadioTuner::State state)
void stationFound(int frequency, QString stationId)
void stereoStatusChanged(bool stereo)
void volumeChanged(int volume)
  • 6 сигналов унаследовано от QMediaObject
  • 2 сигнала унаследовано от QObject

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

  • 1 общественная переменная, унаследованная от QObject
  • 10 статических общедоступных членов, унаследованных от QObject
  • 2 защищенные функции, унаследованные от QMediaObject
  • 9 защищенных функций, унаследованных от QObject
  • 2 защищенные переменные, унаследованные от 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::AM 0 520 до 1610 кГц, интервал между каналами 9 или 10 кГц, расширенный 1610 до 1710 кГц
QRadioTuner::FM 1 87,5 до 108,0 МГц, за исключением Японии 76-90 МГц
QRadioTuner::SW 2 1,711 до 30,0 МГц, разделены на 15 диапазонов. Интервал между каналами 5 кГц
QRadioTuner::LW 3 148,5 до 283,5 кГц, интервал между каналами 9 кГц (Европа, Африка, Азия)
QRadioTuner::FM2 4 Диапазон не определен, используется, когда область поддерживает более одного диапазона FM.

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

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

Константа Значение Описание
QRadioTuner::NoError 0 Ошибок не произошло.
QRadioTuner::ResourceError 1 Нет доступной радиослужбы.
QRadioTuner::OpenError 2 Не удалось открыть устройство радио.
QRadioTuner::OutOfRangeError 3 Попытка установить частоту или диапазон, которые не поддерживаются устройством радио.

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

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

Константа Значение Описание
QRadioTuner::SearchFast 0 Использовать только силу сигнала при поиске.
QRadioTuner::SearchGetStationId 1 После обнаружения сильного сигнала подождать идентификатора станции RDS (PI), прежде чем продолжить.

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

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

Константа Значение Описание
QRadioTuner::ActiveState 0 Тюнер запущен и активен.
QRadioTuner::StoppedState 1 Устройство тюнера остановлено.

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

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

Константа Значение Описание
QRadioTuner::ForceStereo 0 Предоставление стереорежима, преобразование при необходимости.
QRadioTuner::ForceMono 1 Предоставление монорежима, преобразование при необходимости.
QRadioTuner::Auto 2 Использует стереорежим, соответствующий станции.

Документация свойств

antennaConnected : const bool

Это свойство содержит информацию о том, подключена ли антенна.

Функции доступа:

bool isAntennaConnected() const

Сигнал уведомления:

void antennaConnectedChanged(bool connectionStatus)

band : Band

Это свойство содержит диапазон частот, к которому настроен радиотюнер.

Функции доступа:

QRadioTuner::Band band() const
void setBand(QRadioTuner::Band band)

Сигнал уведомления:

void bandChanged(QRadioTuner::Band band)

См. также QRadioTuner::Band.

frequency : int

Это свойство содержит частоту в герцах, к которой настроен радиотюнер.

Функции доступа:

int frequency() const
void setFrequency(int frequency)

Сигнал уведомления:

void frequencyChanged(int frequency)

muted : bool

Это свойство содержит информацию о том, выключен ли звук радиотюнера.

Функции доступа:

bool isMuted() const
void setMuted(bool muted)

Сигнал уведомления:

void mutedChanged(bool muted)

radioData : QRadioData* const

содержит экземпляр QRadioData

Экземпляр QRadioData уже привязан к этому экземпляру QRadioTuner.

Функции доступа:

QRadioData * radioData() const

searching : const bool

Это свойство содержит информацию о том, ищет ли радиотюнер сигнал в данный момент.

Функции доступа:

bool isSearching() const

Сигнал уведомления:

void searchingChanged(bool searching)

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

signalStrength : const int

Это свойство содержит силу текущего радиосигнала в процентах.

Функции доступа:

int signalStrength() const

Сигнал уведомления:

void signalStrengthChanged(int strength)

state : const State

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

Функции доступа:

QRadioTuner::State state() const

Сигнал уведомления:

void stateChanged(QRadioTuner::State state)

См. также QRadioTuner::State.

stereo : const bool

Это свойство содержит информацию о том, принимает ли радиотюнер стереосигнал.

Функции доступа:

bool isStereo() const

Сигнал уведомления:

void stereoStatusChanged(bool stereo)

stereoMode : StereoMode

Это свойство содержит стереорежим радиотюнера.

Функции доступа:

QRadioTuner::StereoMode stereoMode() const
void setStereoMode(QRadioTuner::StereoMode mode)

volume : int

Это свойство содержит громкость аудиовыхода радиотюнера в процентах.

Функции доступа:

int volume() const
void setVolume(int volume)

Сигнал уведомления:

void volumeChanged(int volume)

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

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 диапазон) const

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

int QRadioTuner::frequencyStep(QRadioTuner::Band диапазон) const

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

bool QRadioTuner::isBandSupported(QRadioTuner::Band диапазон) const

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

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

[signal] void QRadioTuner::mutedChanged(bool выключен)

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

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

[slot] void QRadioTuner::searchAllStations(QRadioTuner::SearchMode режимПоиска = QRadioTuner::SearchFast)

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

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

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

[slot] void QRadioTuner::searchBackward()

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

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

[slot] void QRadioTuner::searchForward()

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

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

[signal] void QRadioTuner::searchingChanged(bool поиск)

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

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

[slot] void QRadioTuner::setBand(QRadioTuner::Band диапазон)

Устанавливает диапазон частот радиотюнера.

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

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

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

[slot] void QRadioTuner::setFrequency(int частота)

Устанавливает частоту радиотюнера.

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

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

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

[signal] void QRadioTuner::signalStrengthChanged(int сила)

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

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

[slot] void QRadioTuner::start()

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

[signal] void QRadioTuner::stateChanged(QRadioTuner::State состояние)

Этот сигнал отправляется, когда состояние меняется на состояние.

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

[signal] void QRadioTuner::stationFound(int частота, QString идентификаторСтанции)

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

[signal] void QRadioTuner::stereoStatusChanged(bool стерео)

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

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

[slot] void QRadioTuner::stop()

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

[signal] void QRadioTuner::volumeChanged(int громкость)

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

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

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.11/qradiotuner.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API