Sound QML Type

Define a variety of samples and parameters to be used for SoundInstance . 更多...

import 语句: import QtAudioEngine 1.15
Since: Qt 5.0
继承:

Item

特性

方法

详细描述

Sound can be accessed through QtAudioEngine::AudioEngine::sounds with its unique name and must be defined inside AudioEngine or be added to it using AudioEngine.addSound() if Sound is created dynamically.

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 : string

This property specifies which attenuation model this sound will apply.

category : string

This property specifies which AudioCategory this sound belongs to.

cone.innerAngle : real

This property holds the innerAngle for Sound definition. The range is [0, 360] degree. There is no directional attenuation within innerAngle.

cone.outerAngle : real

This property holds the outerAngle for Sound definition. The range is [0, 360] degree. All audio output from this sound will be attenuated by outerGain outside outerAngle.

cone.outerGain : real

This property holds attenuation value for directional attenuation of this sound. The range is [0, 1]. All audio output from this sound will be attenuated by outerGain outside outerAngle .

name : string

This property holds the name of Sound, must be unique among all sounds and only defined once.

playType : enumeration

This property holds the playType. It can be one of:

  • Random - randomly picks up a play variation when playback is triggered
  • Sequential - plays each variation in sequence when playback is triggered

The default value is Random.

方法文档编制

addPlayVariation ( PlayVariation playVariation )

添加给定 playVariation to sound. This can be used when the PlayVariation is created dynamically:

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 and starts playing with specified position , velocity , direction , adjusted gain and pitch .

play ( position , velocity , gain , pitch )

创建新的 SoundInstance and starts playing with specified position , velocity , adjusted gain and pitch . Direction is set to "0,0,0" .

play ( position , gain , pitch )

创建新的 SoundInstance and starts playing with specified position , adjusted gain and pitch . Direction and velocity are all set to "0,0,0" .

play ( position , velocity , direction , gain )

创建新的 SoundInstance and starts playing with specified position , velocity , direction and adjusted gain .

play ( position , velocity , gain )

创建新的 SoundInstance and starts playing with specified position , velocity and adjusted gain . Direction is set to "0,0,0" .

play ( position , gain )

创建新的 SoundInstance and starts playing with specified position and adjusted gain . Direction and velocity are all set to "0,0,0" .

play ( position , velocity , direction )

创建新的 SoundInstance and starts playing with specified position , velocity and direction .

play ( position , velocity )

创建新的 SoundInstance and starts playing with specified position and velocity . Direction is set to "0,0,0" .

play ( position )

创建新的 SoundInstance and starts playing with specified position . Direction and velocity are all set to "0,0,0" .

play ( gain , pitch )

创建新的 SoundInstance and starts playing with the adjusted gain and pitch . Position, direction and velocity are all set to "0,0,0" .

play ( gain )

创建新的 SoundInstance and starts playing with the adjusted gain . Position, direction and velocity are all set to "0,0,0" .

play ()

创建新的 SoundInstance and starts playing. Position, direction and velocity are all set to "0,0,0" .