UAudioComponent

class Engine Blueprint Since 4.0

Inherits: UObjectBase › UObjectBaseUtility › UObject › UActorComponent › USceneComponent › UAudioComponent

#include "Components/AudioComponent.h"

Description

A scene component that plays a USoundBase asset at the component's world location with full control over volume, pitch, 3D spatialization, fade transitions, and runtime parameters.

Caveats & Gotchas

• bAutoDestroy causes the component to be destroyed after playback ends. It is set automatically by UGameplayStatics::SpawnSoundAtLocation — never set it on persistent audio components you intend to reuse.
• IsPlaying() returns false when paused or fading. Use GetPlayState() to query EAudioComponentPlayState for the full status.
• Parameter changes via SetFloatParameter/SetBoolParameter are silently dropped when bDisableParameterUpdatesWhilePlaying is true.
• Attaching audio to fast-moving skeletal meshes can cause spatialization lag. For fire-and-forget 3D sounds, prefer UGameplayStatics::PlaySoundAtLocation.

Example

Play ambient audio with a fade-in C++

// Persistent component set up in constructor:
// AmbientComp = CreateDefaultSubobject<UAudioComponent>(TEXT("AmbientComp"));
AmbientComp->SetSound(AmbientLoopSound);
AmbientComp->FadeIn(2.0f, 1.0f);

Functions (4)

Audio 4

Audio

4 ▼

Access	Type	Name	Description
public	function	UAudioComponent::FadeIn	Starts the sound and ramps volume from 0 to FadeVolumeLevel over FadeInDuration seconds.
public	function	UAudioComponent::FadeOut	Smoothly ramps the playing sound's volume down to FadeVolumeLevel over FadeOutDuration seconds.
public	function	UAudioComponent::Play	Starts playing the component's assigned Sound asset from StartTime.
public	function	UAudioComponent::Stop	Immediately stops the sound playing on this component and fires OnAudioFinished.

Version History

Introduced in: 4.0

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?