QML类型说明-AudioEngine

AudioEngine

 

ImportStatement:   import QtAudioEngine1.0

Since:  Qt 5.0

Inherits:     Item

Properties

categories : map

dopplerFactor : real

listener : QtAudioEngine::AudioListener

liveInstances : int

loading : bool

samples : map

sounds : map

speedOfSound : real

Signals

finishedLoading()

isLoadingChanged()

liveInstanceCountChanged()

ready()

 

DetailedDescription

AudioEngine是QtAudioEngine 1.0模块的一部分

 

import QtQuick 2.0

import QtAudioEngine 1.0

 

Rectangle {

   color:"white"

    width:300

    height:500

 

    AudioEngine{

       id:audioengine

 

       AudioSample {

           name:"explosion"

           source: "explosion-02.wav"

       }

 

       Sound {

           name:"explosion"

           PlayVariation {

               sample:"explosion"

           }

       }

 

       dopplerFactor: 1

       speedOfSound: 343.33 // Approximate speed of sound in air at 20degrees Celsius

 

       listener.up:"0,0,1"

       listener.position:"0,0,0"

       listener.velocity:"0,0,0"

       listener.direction:"0,1,0"

    }

 

    MouseArea{

       anchors.fill: parent

       onPressed: {

           audioengine.sounds["explosion"].play();

       }

    }

}

AudioEngine是一个应用声音部分的核心，所以应该在应用中被定义并只定义一次。英文原档上有个3Daudio，不知和微软的3Daudio有没有关系。这个组件包含了诸如AudioCategory、AudioSample、Sound的接口。同时可参阅AudioCategory、AudioSample、Sound、SoundInstance、AttenuationModelLinear和AttenuationModelInverse的组件文档。

 

PropertyDocumentation

categories : map

包含了所有AudioCategory的实例。

 

dopplerFactor : real

这是多普勒平移影响的简单扩展。

 

listener : QtAudioEngine::AudioListener

声音的听众，通过改变这个属性可以影响声音的3D定位。同时参阅AudioListener的文档。

 

liveInstances : int

当前有多少存活的声音实例。

 

loading : bool

如果声音引擎正在加载任何声音样本，这个属性为真。在所有的声音样本被加载完毕前，我们可以通过这个属性，在屏幕上给用户显示正在加载中的提示。

 

samples : map

包含所有的AudioSample实例。

 

sounds : map

包含所有的Sound实例。

 

speedOfSound : real

声音的速度，米每秒。这个属性用于计算多普勒平移。多普勒平移用于模拟当声音靠近或远离倾听者时，倾听者感受到的频率变化。声音的速度跟声音传播的介质有关。

 

SignalDocumentation

finishedLoading()

当加载完成，这个信号被发射。从这里开始，响应信号的句柄不在描述。

 

isLoadingChanged()

当loading这个属性发生变化时，这个信号发射。

 

liveInstanceCountChanged()

当AudioEngine存活的实例数目发生变化时，这个信号发射。

 

ready()

当AudioEngine准备好时，这个信号发射。