Тип 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 : строка

Это свойство указывает, какой 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()

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