Тип QML SoundEffect

Тип SoundEffect предоставляет способ воспроизведения звуковых эффектов в QML. Подробнее...

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

Свойства

• loops : int
• loopsRemaining : int
• muted : bool
• playing : bool
• source : url
• status : перечисление
• volume : qreal

Сигналы

• loadedChanged()
• loopCountChanged()
• loopsRemainingChanged()
• mutedChanged()
• playingChanged()
• sourceChanged()
• statusChanged()
• volumeChanged()

Методы

• bool isLoaded()
• play()
• stop()

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

Этот тип позволяет воспроизводить несжатые аудиофайлы (обычно WAV-файлы) с меньшей задержкой и подходит для звуков типа «отклика» в ответ на действия пользователя (например, звуки виртуальной клавиатуры, положительная или отрицательная обратная связь для всплывающих диалоговых окон или звуки игр). Если низкая задержка не важна, используйте вместо этого тип MediaPlayer, так как он поддерживает более широкий спектр форматов медиа и потребляет меньше ресурсов.

Обычно звуковой эффект должен быть повторно использован, что позволяет выполнить все парсинг и подготовку заранее и активировать его только при необходимости. Это легко реализовать с помощью QML, так как вы можете объявить экземпляр SoundEffect и ссылаться на него в других местах.

В следующем примере WAV-файл воспроизводится при щелчке мышью.

Text {
    text: "Click Me!";
    font.pointSize: 24;
    width: 150; height: 50;

    SoundEffect {
        id: playSound
        source: "soundeffect.wav"
    }
    MouseArea {
        id: playArea
        anchors.fill: parent
        onPressed: { playSound.play() }
    }
}

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

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

loops : int

Это свойство содержит количество повторов воспроизведения звука. Значение 0 или 1 означает, что звук будет воспроизведён только один раз; задайте SoundEffect.Infinite, чтобы включить бесконечное повторение.

Значение может быть изменено во время воспроизведения звукового эффекта, в этом случае оставшееся количество повторов будет обновлено до нового значения.

loopsRemaining : int

Это свойство содержит количество оставшихся повторов, прежде чем звуковой эффект остановится сам по себе, или SoundEffect.Infinite, если в loops было установлено соответствующее значение.

muted : bool

Это свойство позволяет управлять отключением звука. Значение true отключит этот эффект. В противном случае воспроизведение будет происходить с текущим указанным значением volume.

playing : bool

Это свойство указывает, воспроизводится ли звуковой эффект или нет.

source : url

Это свойство содержит URL для воспроизводимого звука. Для SoundEffect, чтобы попытаться загрузить источник, URL должен существовать, и приложение должно иметь права чтения в указанном каталоге. Если требуемый источник — это локальный файл, URL может быть указан с использованием абсолютного или относительного (относительно файла, объявившего SoundEffect) пути.

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

Это свойство указывает текущий статус SoundEffect, как перечислено в SoundEffect. Возможные статусы перечислены ниже.

volume : qreal

Это свойство содержит громкость воспроизведения звукового эффекта.

Громкость масштабируется линейно от 0.0 (тишина) до 1.0 (полная громкость). Значения вне этого диапазона будут ограничены.

Значение громкости по умолчанию — 1.0.

Управление громкостью в пользовательском интерфейсе обычно должно масштабироваться нелинейно. Например, использование логарифмического масштаба обеспечит линейные изменения в воспринимаемой громкости, что ожидается от управления громкостью пользователем. См. convertVolume() для получения более подробной информации.

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

loadedChanged()

Сигнал loadedChanged генерируется при изменении состояния загрузки.

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

loopCountChanged()

Сигнал loopCountChanged генерируется при изменении начального числа повторов.

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

loopsRemainingChanged()

Сигнал loopsRemainingChanged генерируется при изменении оставшегося числа повторов.

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

mutedChanged()

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

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

playingChanged()

Сигнал playingChanged генерируется при изменении свойства playing.

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

sourceChanged()

Сигнал sourceChanged генерируется при изменении источника.

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

statusChanged()

Сигнал statusChanged генерируется при изменении свойства status.

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

volumeChanged()

Сигнал volumeChanged генерируется при изменении громкости.

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

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

bool isLoaded()

Возвращает, завершила ли загрузка звукового эффекта source.

play()

Запускает воспроизведение звукового эффекта, повторяя его заданное количество раз, как указано в свойстве loops.

Это — основной метод для SoundEffect.

SoundEffect {
    id: playSound
    source: "soundeffect.wav"
}
MouseArea {
    id: playArea
    anchors.fill: parent
    onPressed: { playSound.play() }
}

stop()

Останавливает текущее воспроизведение.