Класс 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 } |
Свойства
|
- 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