UAudioComponent::OnAudioMultiEnvelopeValue

property Engine Blueprint Since unknown

#include "Components/AudioComponent.h"

Access: public Specifiers: UPROPERTYBlueprintAssignable

Description

Broadcasts the average and maximum envelope values across all wave instances currently playing on this component, along with the instance count.

Caveats & Gotchas

• Only works with the audio mixer, the same restriction as OnAudioSingleEnvelopeValue — it never fires on the legacy audio engine backend.
• Useful when a single component plays multiple overlapping wave instances (e.g. a Sound Cue with a Random or Mixer node) and one aggregated value is preferable to a callback per wave.

Signature

FOnAudioMultiEnvelopeValue OnAudioMultiEnvelopeValue

Example

React to aggregate envelope across overlapping waves C++

AudioComp->OnAudioMultiEnvelopeValueNative.AddLambda([](const UAudioComponent* Comp, const float AverageEnvelope, const float MaxEnvelope, const int32 NumWaveInstances)
{
    UE_LOG(LogTemp, Log, TEXT("Avg: %.2f Max: %.2f Voices: %d"), AverageEnvelope, MaxEnvelope, NumWaveInstances);
});

Version History

Introduced in: unknown

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?