内容

• 特性
• 方法
• 详细描述

Sound QML Type

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

import 语句：	import QtAudioEngine 1.1
Since:	Qt 5.0
继承：	Item

• 所有成员列表，包括继承成员

特性

• attenuationModel : string
• category : string
• name : string
• playType : enumeration

方法

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

详细描述

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.

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

创建新的 SoundInstance and starts playing. 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 ( gain , pitch )

创建新的 SoundInstance and starts playing with the adjusted gain and pitch . Position, direction and velocity are all 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 ( position , velocity )

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

play ( position , velocity , direction )

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

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 , gain )

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

play ( position , velocity , direction , gain )

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

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 , gain , pitch )

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

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

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