Тип QML SoundInstance

Воспроизведение 3D аудиоконтента. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• direction : vector3d
• engine : QtAudioEngine::AudioEngine
• gain : vector3d
• pitch : vector3d
• position : vector3d
• sound : строка
• state : перечисление
• velocity : vector3d

Сигналы

• directionChanged()
• gainChanged()
• pitchChanged()
• positionChanged()
• soundChanged()
• stateChanged(state)
• velocityChanged()

Методы

• pause()
• play()
• stop()

Подробное описание

Существует два способа создания объектов SoundInstance. Вы можете получить его, вызвав метод newInstance объекта 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();
        }
    }
}

Или, как альтернативу, вы можете явно определить SoundInstance вне AudioEngine для упрощения привязок qml:

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

Это свойство содержит текущее 3D направление.

engine : QtAudioEngine::AudioEngine

Это свойство содержит ссылку на AudioEngine, должно быть установлено только один раз.

gain : vector3d

Это свойство содержит регулировку усиления, которая будет использоваться для модуляции уровня аудиовывода из этого SoundInstance.

pitch : vector3d

Это свойство содержит регулировку высоты тона, которая будет использоваться для модуляции высоты звука из этого SoundInstance.

position : vector3d

Это свойство содержит текущее 3D положение.

sound : строка

Это свойство указывает, какой звук будет использовать этот SoundInstance. В отличие от некоторых свойств в других типах, это свойство может динамически изменяться.

state : перечисление

Это свойство содержит текущее состояние воспроизведения. Может быть одним из:

velocity : vector3d

Это свойство содержит текущую 3D скорость.

Документация по сигналам

directionChanged()

Этот сигнал испускается при изменении direction

Соответствующий обработчик onDirectionChanged.

gainChanged()

Этот сигнал испускается при изменении gain

Соответствующий обработчик onGainChanged.

pitchChanged()

Этот сигнал испускается при изменении pitch

Соответствующий обработчик onPitchChanged.

positionChanged()

Этот сигнал испускается при изменении position

Соответствующий обработчик onPositionChanged.

soundChanged()

Этот сигнал испускается при изменении sound

Соответствующий обработчик onSoundChanged.

stateChanged(state)

Этот сигнал испускается при изменении state

Соответствующий обработчик onStateChanged.

velocityChanged()

Этот сигнал испускается при изменении velocity

Соответствующий обработчик onVelocityChanged.

Документация по методам

pause()

Приостанавливает текущее воспроизведение.

play()

Начинает воспроизведение.

stop()

Останавливает текущее воспроизведение.