Тип 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()

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

Доступ к Sound можно получить через 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 и начинает воспроизведение со значением position, velocity, настроенным gain и pitch. Direction устанавливается в значение "0,0,0".

play(position, gain, pitch)

Создает новый SoundInstance и начинает воспроизведение со значением position, настроенным gain и pitch. Direction и velocity устанавливаются в значение "0,0,0".

play(position, velocity, direction, gain)

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

play(position, velocity, gain)

Создает новый SoundInstance и начинает воспроизведение со значением position, velocity и настроенным gain. Direction устанавливается в значение "0,0,0".

play(position, gain)

Создает новый SoundInstance и начинает воспроизведение со значением position и настроенным gain. Direction и velocity устанавливаются в значение "0,0,0".

play(position, velocity, direction)

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

play(position, velocity)

Создает новый SoundInstance и начинает воспроизведение со значением position и velocity. Direction устанавливается в значение "0,0,0".

play(position)

Создает новый SoundInstance и начинает воспроизведение со значением position. Direction и velocity устанавливаются в значение "0,0,0".

play(gain, pitch)

Создает новый SoundInstance и начинает воспроизведение с настроенным gain и pitch. Position, direction и velocity устанавливаются в значение "0,0,0".

play(gain)

Создает новый SoundInstance и начинает воспроизведение с настроенным gain. Position, direction и velocity устанавливаются в значение "0,0,0".

play()

Создает новый SoundInstance и начинает воспроизведение. Position, direction и velocity устанавливаются в значение "0,0,0".