内容

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

SoundInstance QML Type

Play 3d audio content. 更多...

import 语句：	import QtAudioEngine 1.1
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	The SoundInstance is not playing, and when playback begins next it will play from position zero.
PlayingState	The SoundInstance is playing the media.
PausedState	The 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 is changed

相应处理程序是 onDirectionChanged .

gainChanged ()

此信号发射当 gain is changed

相应处理程序是 onGainChanged .

pitchChanged ()

此信号发射当 pitch is changed

相应处理程序是 onPitchChanged .

positionChanged ()

此信号发射当 position is changed

相应处理程序是 onPositionChanged .

soundChanged ()

此信号发射当 sound is changed

相应处理程序是 onSoundChanged .

stateChanged ( state )

此信号发射当 state is changed

相应处理程序是 onStateChanged .

velocityChanged ()

此信号发射当 velocity is changed

相应处理程序是 onVelocityChanged .

方法文档编制

pause ()

Pauses current playback.

play ()

Starts playback.

stop ()

Stops current playback.