Тип QML Radio

Доступ к функциональности радио из приложения QML. Подробнее...

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

Свойства

• antennaConnected : int
• availability : перечисление
• band : перечисление
• frequency : int
• frequencyStep : int
• maximumFrequency : int
• minimumFrequency : int
• muted : bool
• searching : bool
• signalStrength : int
• state : перечисление
• stereo : bool
• stereoMode : перечисление
• volume : int

Сигналы

• stationFound(int frequency, string stationId)

Методы

• cancelScan()
• scanDown()
• scanUp()
• searchAllStations(перечисление searchMode)
• start()
• stop()
• tuneDown()
• tuneUp()

Подробное описание

Rectangle {
    width: 320
    height: 480

    Radio {
        id: radio
        band: Radio.FM
    }

    MouseArea {
        x: 0; y: 0
        height: parent.height
        width: parent.width / 2

        onClicked: radio.scanDown()
    }

    MouseArea {
        x: parent.width / 2; y: 0
        height: parent.height
        width: parent.width / 2

        onClicked: radio.scanUp()
    }
}

Вы можете использовать Radio для настройки радио и получения информации о сигнале. Вы также можете использовать Radio для получения информации о настройке, например, о поддерживаемых шагах частоты для настройки.

Соответствующий RadioData предоставляет информацию RDS о текущей радиостанции. Лучший способ получить доступ к RadioData для текущего Radio — использовать свойство radioData.

См. также Обзор радио.

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

antennaConnected : int

Это свойство имеет значение true, если подключена антенна. В противном случае оно будет false.

availability : перечисление

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

Это может быть одно из следующих значений:

band : перечисление

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

frequency : int

Устанавливает частоту в герцах, к которой настроено радио. Частота должна быть в пределах диапазона частот для текущего диапазона, в противном случае она будет изменена, чтобы быть в пределах диапазона частот.

См. также maximumFrequency и minimumFrequency.

frequencyStep : int

Количество герц для каждого шага при ручном изменении настройки радио. Значение относится к текущему диапазону.

maximumFrequency : int

Максимальная частота для текущего диапазона.

minimumFrequency : int

Минимальная частота для текущего диапазона.

muted : bool

Это свойство отражает, заглушено ли радио или нет.

searching : bool

Это свойство имеет значение true, если радио в настоящее время ищет радиостанции, например, с помощью методов scanUp, scanDown и searchAllStations. После завершения поиска или его отмены с помощью cancelScan это свойство будет false.

signalStrength : int

Сила текущего радиосигнала в процентах, где 0% — отсутствие сигнала, а 100% — очень хороший сигнал.

state : перечисление

Это свойство содержит текущее состояние радио.

См. также start и stop.

stereo : bool

Это свойство содержит значение true, если радио принимает стереосигнал, или false в противном случае. Если stereoMode установлено в ForceMono, значение всегда будет false. Аналогично, оно всегда будет true, если stereoMode установлено в ForceStereo.

См. также stereoMode.

stereoMode : перечисление

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

volume : int

Установите это свойство для управления громкостью радио. Допустимый диапазон громкости от 0 до 100.

Документация по сигналам

stationFound(int frequency, string stationId)

Этот сигнал генерируется, когда найдена новая радиостанция. Этот сигнал генерируется только в том случае, если searchAllStations вызывается с SearchGetStationId.

frequency возвращается в герцах, а stationId соответствует идентификатору станции в RadioData для этой радиостанции.

Соответствующий обработчик — onStationFound.

Примечание: Соответствующий обработчик — onStationFound.

Документация по методам

cancelScan()

Отмена текущего сканирования. Также отменяет поиск, начатый с помощью searchAllStations.

scanDown()

Производит поиск в обратном направлении в диапазоне частот для текущей полосы.

scanUp()

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

searchAllStations(перечисление searchMode)

Начинает поиск во всем диапазоне частот для текущей полосы и сохраняет все найденные радиостанции. Параметр searchMode может принимать значения, описанные в таблице ниже.

В приведенном ниже фрагменте кода используется searchAllStations с SearchGetStationId для получения всех радиостанций в текущей полосе и сохранения их в элементе ListView. Идентификатор станции отображается пользователю, и при нажатии на станцию радио настраивается на эту станцию.

Item {
    width: 640
    height: 360

    Radio {
        id: radio
        onStationFound: radioStations.append({"frequency": frequency, "stationId": stationId})
    }

    ListModel {
        id: radioStations
    }

    ListView {
        model: radioStations
        delegate: Rectangle {
                MouseArea {
                    anchors.fill: parent
                    onClicked: radio.frequency = frequency
                }

                Text {
                    anchors.fill: parent
                    text: stationId
                }
            }
    }

    Rectangle {
        MouseArea {
            anchors.fill: parent
            onClicked: radio.searchAllStations(Radio.SearchGetStationId)
        }
    }
}

start()

Запускает радио. Если радио доступно, как определено свойством availability, это приведет к тому, что свойство state примет значение ActiveState.

stop()

Останавливает радио. После вызова этого метода свойство state примет значение StoppedState.

tuneDown()

Уменьшает частоту на шаг частоты для текущей полосы. Если частота уже установлена на минимальную частоту, вызов этой функции не оказывает никакого влияния.

См. также band, frequencyStep, и minimumFrequency.

tuneUp()

Увеличивает частоту на шаг частоты для текущей полосы. Если частота уже установлена на максимальную частоту, вызов этой функции не оказывает никакого влияния.

См. также band, frequencyStep, и maximumFrequency.