Sound QML Type

Define a variety of samples and parameters to be used for SoundInstance. More...

Import Statement: import QtAudioEngine 1.0
Since: Qt 5.0
Inherits:

Item

Properties

Methods

  • play(position, velocity, direction, gain, pitch)
  • play(position, velocity, gain, pitch)
  • play(position, gain, pitch)
  • play(position, velocity, direction, gain)
  • play(position, velocity, gain)
  • play(position, gain)
  • play(position, velocity, direction)
  • play(position, velocity)
  • play(position)
  • play(gain, pitch)
  • play(gain)
  • play()

Detailed Description

This type is part of the QtAudioEngine 1.0 module.

Sound can be accessed through QtAudioEngine::AudioEngine::sounds with its unique name and must be defined inside AudioEngine.

import QtQuick 2.0
import QtAudioEngine 1.0

Rectangle {
    color:"white"
    width: 300
    height: 500

    AudioEngine {
        id:audioengine

        AudioSample {
            name:"explosion01"
            source: "explosion-01.wav"
        }

        AudioSample {
            name:"explosion02"
            source: "explosion-02.wav"
        }

        Sound {
            name:"explosion"
            PlayVariation {
                sample:"explosion01"
                minPitch: 0.8
                maxPitch: 1.1
            }
            PlayVariation {
                sample:"explosion01"
                minGain: 1.1
                maxGain: 1.5
            }
        }
    }
    MouseArea {
        anchors.fill: parent
        onPressed: {
            audioengine.sounds["explosion"].play();
        }
    }
}

Property Documentation

attenuationModel : string

This property specifies which attenuation model this sound will apply.


category : string

This property specifies which AudioCategory this sound belongs to.


name : string

This property holds the name of Sound, must be unique among all sounds and only defined once.


playType : enumeration

This property holds the playType. It can be one of:

  • Random - randomly picks up a play variation when playback is triggered
  • Sequential - plays each variation in sequence when playback is triggered

The default value is Random.


Method Documentation

play(position, velocity, direction, gain, pitch)

Creates a new SoundInstance and starts playing with specified position, velocity, direction, adjusted gain and pitch.


play(position, velocity, gain, pitch)

Creates a new SoundInstance and starts playing with specified position, velocity, adjusted gain and pitch. Direction is set to "0,0,0".


play(position, gain, pitch)

Creates a new SoundInstance and starts playing with specified position, adjusted gain and pitch. Direction and velocity are all set to "0,0,0".


play(position, velocity, direction, gain)

Creates a new SoundInstance and starts playing with specified position, velocity, direction and adjusted gain.


play(position, velocity, gain)

Creates a new SoundInstance and starts playing with specified position, velocity and adjusted gain. Direction is set to "0,0,0".


play(position, gain)

Creates a new SoundInstance and starts playing with specified position and adjusted gain. Direction and velocity are all set to "0,0,0".


play(position, velocity, direction)

Creates a new SoundInstance and starts playing with specified position, velocity and direction.


play(position, velocity)

Creates a new SoundInstance and starts playing with specified position and velocity. Direction is set to "0,0,0".


play(position)

Creates a new SoundInstance and starts playing with specified position. Direction and velocity are all set to "0,0,0".


play(gain, pitch)

Creates a new SoundInstance and starts playing with the adjusted gain and pitch. Position, direction and velocity are all set to "0,0,0".


play(gain)

Creates a new SoundInstance and starts playing with the adjusted gain. Position, direction and velocity are all set to "0,0,0".


play()

Creates a new SoundInstance and starts playing. Position, direction and velocity are all set to "0,0,0".


© 2015 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.