Тип QML радио

Доступ к функциям радио из приложения 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 для настройки радио и получения информации о сигнале. Вы также можете использовать радио для получения информации о настройке, например, о поддерживаемых шагах частоты для настройки.

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

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

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

antennaConnected : int

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

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

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

Это одно из:

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

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

frequency : int

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

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

frequencyStep : int

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

maximumFrequency : int

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

minimumFrequency : int

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

muted : bool

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

searching : bool

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

signalStrength : int

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

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

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

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

stereo : bool

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

См. также stereoMode.

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

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

volume : int

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

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

stationFound(int frequency, string stationId)

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

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

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

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

cancelScan()

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

scanDown()

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

scanUp()

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

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

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

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

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()

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

См. также полоса, шаг частоты и минимальная частота.

tuneUp()

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

См. также полоса, шаг частоты и максимальная частота.