内容

• 特性
• 信号
• 方法
• 详细描述

SoundInstance QML Type

Play 3d audio content. 更多...

导入语句：	import QtAudioEngine 1.15
Since:	Qt 5.0
继承：	Item

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

特性

• direction : vector3d
• engine : QtAudioEngine::AudioEngine
• gain : vector3d
• pitch : vector3d
• position : vector3d
• sound : string
• state : enumeration
• velocity : vector3d

信号

• directionChanged ()
• gainChanged ()
• pitchChanged ()
• positionChanged ()
• soundChanged ()
• stateChanged ( state )
• velocityChanged ()

方法

• pause ()
• play ()
• stop ()

详细描述

There are two ways to create SoundInstance objects. You can obtain it by calling newInstance method of a Sound :

Rectangle {
    id:root
    color:"white"
    width: 300
    height: 500
    AudioEngine {
        id:audioengine
        AudioSample {
            name:"explosion01"
            source: "explosion-01.wav"
        }
        Sound {
            name:"explosion"
            PlayVariation {
                sample:"explosion01"
            }
        }
    }
    property variant soundEffect: audioengine.sounds["explosion"].newInstance();
    MouseArea {
        anchors.fill: parent
        onPressed: {
            root.soundEffect.play();
        }
    }
}
					

Or alternatively, you can explicitly define SoundInstance outside of AudioEngine for easier qml bindings:

Rectangle {
    id:root
    color:"white"
    width: 300
    height: 500
    AudioEngine {
        id:audioengine
        AudioSample {
            name:"explosion01"
            source: "explosion-01.wav"
        }
        Sound {
            name:"explosion"
            PlayVariation {
                sample:"explosion01"
            }
        }
    }
    Item {
        id: animator
        x: 10 + observer.percent * 100
        y: 20 + observer.percent * 80
        property real percent: 0
        SequentialAnimation on percent {
            loops: Animation.Infinite
            running: true
            NumberAnimation {
            duration: 8000
            from: 0
            to: 1
            }
        }
    }
    SoundInstance {
        id:soundEffect
        engine:audioengine
        sound:"explosion"
        position:Qt.vector3d(animator.x, animator.y, 0);
    }
    MouseArea {
        anchors.fill: parent
        onPressed: {
            soundEffect.play();
        }
    }
}
					

特性文档编制

direction : vector3d

This property holds the current 3d direction.

engine : QtAudioEngine::AudioEngine

This property holds the reference to AudioEngine , must be set only once.

gain : vector3d

This property holds the gain adjustment which will be used to modulate the audio output level from this SoundInstance .

pitch : vector3d

This property holds the pitch adjustment which will be used to modulate the audio pitch from this SoundInstance .

position : vector3d

This property holds the current 3d position.

sound : string

This property specifies which Sound this SoundInstance will use. Unlike some properties in other types, this property can be changed dynamically.

state : enumeration

This property holds the current playback state. It can be one of:

值	描述
StopppedState	SoundInstance is not playing, and when playback begins next it will play from position zero.
PlayingState	SoundInstance is playing the media.
PausedState	SoundInstance is not playing, and when playback begins next it will play from the position that it was paused at.

velocity : vector3d

This property holds the current 3d velocity.

信号文档编制

directionChanged ()

此信号被发射当 direction 改变。

相应处理程序是 onDirectionChanged .

注意： 相应处理程序是 onDirectionChanged .

gainChanged ()

此信号被发射当 gain 改变。

相应处理程序是 onGainChanged .

注意： 相应处理程序是 onGainChanged .

pitchChanged ()

此信号被发射当 pitch 改变。

相应处理程序是 onPitchChanged .

注意： 相应处理程序是 onPitchChanged .

positionChanged ()

此信号被发射当 position 改变。

相应处理程序是 onPositionChanged .

注意： 相应处理程序是 onPositionChanged .

soundChanged ()

此信号被发射当 sound 改变。

相应处理程序是 onSoundChanged .

注意： 相应处理程序是 onSoundChanged .

stateChanged ( state )

此信号被发射当 state 改变。

相应处理程序是 onStateChanged .

注意： 相应处理程序是 onStateChanged .

velocityChanged ()

此信号被发射当 velocity 改变。

相应处理程序是 onVelocityChanged .

注意： 相应处理程序是 onVelocityChanged .

方法文档编制

pause ()

Pauses current playback.

play ()

Starts playback.

stop ()

Stops current playback.