Тип QML Sound

Определяет различные образцы и параметры, используемые для SoundInstance. Подробнее...

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

Свойства

• attenuationModel : строка
• category : строка
• name : строка
• playType : перечисление

Методы

• addPlayVariation(PlayVariation playVariation)
• QtAudioEngine::SoundInstance newInstance()
• play(position, velocity, direction, gain, pitch)
• play(position, velocity, gain, pitch)
• play(position, gain, pitch)
• play(position, velocity, direction, gain)
• play(position, velocity, gain)
• play(position, gain)
• play(position, velocity, direction)
• play(position, velocity)
• play(position)
• play(gain, pitch)
• play(gain)
• play()

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

К звуку можно получить доступ через QtAudioEngine::AudioEngine::sounds с его уникальным именем и он должен быть определен внутри AudioEngine или добавлен в него с помощью AudioEngine.addSound(), если Sound создается динамически.

Rectangle {
    color:"white"
    width: 300
    height: 500

    AudioEngine {
        id:audioengine

        AudioSample {
            name:"explosion01"
            source: "explosion-01.wav"
        }

        AudioSample {
            name:"explosion02"
            source: "explosion-02.wav"
        }

        Sound {
            name:"explosion"
            playType: Sound.Random
            PlayVariation {
                sample:"explosion01"
                minPitch: 0.8
                maxPitch: 1.1
            }
            PlayVariation {
                sample:"explosion02"
                minGain: 1.1
                maxGain: 1.5
            }
        }
    }
    MouseArea {
        anchors.fill: parent
        onPressed: {
            audioengine.sounds["explosion"].play();
        }
    }
}

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

attenuationModel : строка

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

category : строка

Это свойство указывает, к какой AudioCategory относится этот звук.

name : строка

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

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

Это свойство содержит playType. Оно может быть одним из следующих:

• Случайный - случайным образом выбирает вариацию воспроизведения при запуске воспроизведения
• Последовательный - воспроизводит каждую вариацию последовательно при запуске воспроизведения

Значение по умолчанию - Случайный.

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

addPlayVariation(PlayVariation playVariation)

Добавляет заданный playVariation к звуку. Это может быть использовано, когда PlayVariation создается динамически:

import QtAudioEngine 1.1

AudioEngine {
    id: engine

    Component.onCompleted: {
        var playVariation = Qt.createQmlObject('import QtAudioEngine 1.1; PlayVariation {}', engine);
        playVariation.sample = "sample";
        playVariation.minPitch = 0.8
        playVariation.maxPitch = 1.1

        var sound = Qt.createQmlObject('import QtAudioEngine 1.1; Sound {}', engine);
        sound.name = "example";
        sound.addPlayVariation(playVariation);
        engine.addSound(sound);
    }
}

QtAudioEngine::SoundInstance newInstance()

Возвращает новый SoundInstance.

play(position, velocity, direction, gain, pitch)

Создает новый SoundInstance и начинает воспроизведение со значением position, velocity, direction, с изменённым gain и pitch.

play(position, velocity, gain, pitch)

Создаёт новый SoundInstance и начинает воспроизведение с заданной позицией, скоростью, изменённым усилением и тональностью. Направление установлено в "0,0,0".

play(position, gain, pitch)

Создаёт новый SoundInstance и начинает воспроизведение с заданной позицией, изменённым усилением и тональностью. Направление и скорость установлены в "0,0,0".

play(position, velocity, direction, gain)

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

play(position, velocity, gain)

Создаёт новый SoundInstance и начинает воспроизведение с заданной позицией, скоростью и изменённым усилением. Направление установлено в "0,0,0".

play(position, gain)

Создаёт новый SoundInstance и начинает воспроизведение с заданной позицией и изменённым усилением. Направление и скорость установлены в "0,0,0".

play(position, velocity, direction)

Создаёт новый SoundInstance и начинает воспроизведение с заданной позицией, скоростью и направлением.

play(position, velocity)

Создаёт новый SoundInstance и начинает воспроизведение с заданной позицией и скоростью. Направление установлено в "0,0,0".

play(position)

Создаёт новый SoundInstance и начинает воспроизведение с заданной позицией. Направление и скорость установлены в "0,0,0".

play(gain, pitch)

Создаёт новый SoundInstance и начинает воспроизведение с изменённым усилением и тональностью. Позиция, направление и скорость установлены в "0,0,0".

play(gain)

Создаёт новый SoundInstance и начинает воспроизведение с изменённым усилением. Позиция, направление и скорость установлены в "0,0,0".

play()

Создаёт новый SoundInstance и начинает воспроизведение. Позиция, направление и скорость установлены в "0,0,0".