AudioCategory QML Type | Qt Multimedia 5.15.18

- Qt 5.15
- Qt Multimedia
- QML Types
- AudioCategory QML Type
- Qt 5.15.18 Reference Documentation

# AudioCategory QML Type

Control all active sound instances by group. More...

Import Statement: | import QtAudioEngine 1.15
Since: | Qt 5.0

- List of all members, including inherited members

## Properties

- name : string
- volume : real

## Methods

- pause()
- pause()
- stop()

## Detailed Description

An instance of AudioCategory can be accessed through AudioEngine.categories with its unique name and must be defined inside AudioEngine or be added to it using AudioEngine.addAudioCategory() if AudioCategory is created dynamically.

     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;
             }
         }
     }

Sound instances can be grouped together by specifying the category property. When you change the volume of a category, all audio output from related instances will be affected as well.

Note: there will always be an AudioCategory named `default` whether you explicitly define it or not. If you do not specify any category for a Sound, it will be grouped into the `default` category.

## Property Documentation

name : string

This property holds the name of AudioCategory. The name must be unique among all categories and only defined once. The name cannot be changed after the instance has been initialized.

volume : real

This property holds the volume of the category and will modulate all audio output from the instances which belong to this category.

## Method Documentation

pause()

Resumes all active sound instances from paused state which belong to this category.

pause()

Pauses all active sound instances which belong to this category.

stop()

Stops all active sound instances which belong to this category.