QML类型说明-AudioCategory

AudioCategory

 

ImportStatement:   import QtAudioEngine1.0

Since:  Qt 5.0

Inherits:     Item

 

Properties

name : string

volume : real

Methods

pause()

pause()

stop()

 

DetailedDescription

这个类型是QtAudioEngine1.0模块的一部分。通过AudioEngine能访问AudioCategory的实例。AudioCategory必须定义在AudioEngine内部，且需要一个名字。

 

import QtQuick 2.0

import QtAudioEngine 1.0

 

Rectangle {

   color:"white"

    width:300

    height:500

 

    AudioEngine{

       id:audioengine

 

       AudioCategory {

           name: "sfx"

           volume: 0.8

       }

 

       AudioSample {

           name:"explosion"

           source: "explosion-02.wav"

       }

 

       Sound {

           name:"explosion"

           category: "sfx"

           PlayVariation {

               sample:"explosion"

           }

       }

    }

 

    MouseArea{

       anchors.fill: parent

       onPressed: {

           audioengine.categories["sfx"].volume = 0.5;

       }

    }

}

通过指定的category属性，声音实例被组建。当我们改变category的音量时，声音输出所有相关联的实例，都会受到影响。

注意：无论我们是否定义，名为default的AudioCategory将总是存在。如果我们没有为Sound指定AudioCategory，它将自动使用默认AudioCategory。

 

PropertyDocumentation

name : string

AudioCategory的名字。它必须被定义且只能定义一次。在实例初始化后，它不能被改变。

 

volume : real

category的音量，它将调节属于这个category的所有音频实例的输出。

 

Method Documentation

pause()

将和本category相关的声音实例从暂停中恢复。这里看上去应该是play()，或许是官方文档的疏漏，测试并验证它。

 

pause()

暂停所有和本category相关的声音实例。

 

stop()

停止所有和本category相关的声音实例。