Play 3d audio content. 更多...
import 语句: | import QtAudioEngine 1.15 |
Since: | Qt 5.0 |
继承: |
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 .
位置 : 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.
此信号发射当 direction 改变。
相应处理程序是
onDirectionChanged
.
注意:
相应处理程序是
onDirectionChanged
.
此信号发射当 gain 改变。
相应处理程序是
onGainChanged
.
注意:
相应处理程序是
onGainChanged
.
此信号发射当 pitch 改变。
相应处理程序是
onPitchChanged
.
注意:
相应处理程序是
onPitchChanged
.
此信号发射当 position 改变。
相应处理程序是
onPositionChanged
.
注意:
相应处理程序是
onPositionChanged
.
此信号发射当 sound 改变。
相应处理程序是
onSoundChanged
.
注意:
相应处理程序是
onSoundChanged
.
此信号发射当 state 改变。
相应处理程序是
onStateChanged
.
注意:
相应处理程序是
onStateChanged
.
此信号发射当 velocity 改变。
相应处理程序是
onVelocityChanged
.
注意:
相应处理程序是
onVelocityChanged
.
Pauses current playback.
Starts playback.
Stops current playback.