Unreal Engine 4.26 Documentation

Unreal Engine 4.27 Documentation

Unreal Engine 5.0 Documentation

Unreal Engine 5.1 Documentation

Unreal Engine 5.2 Documentation

Unreal Engine 5.3 Documentation

> Unreal Engine API Reference > Runtime > Engine > Components > UAudioComponent

Light Theme

Dark Theme

UAudioComponent

AudioComponent is used to play a Sound

Windows

MacOS

Linux

Inheritance Hierarchy

UObjectBase

UObjectBaseUtility

UObject

UActorComponent

USceneComponent

UAudioComponent

UAudioCurveSourceComponent

References

Module	Engine
Header	/Engine/Source/Runtime/Engine/Classes/Components/AudioComponent.h
Include	#include "Components/AudioComponent.h"

Syntax

class UAudioComponent : public USceneComponent

Remarks

AudioComponent is used to play a Sound

Variables

	Name	Description
int32	ActiveCount	A count of how many times we've started playing
FSoundAttenuati...	AttenuationOverrides	If bOverrideSettings is true, the attenuation properties to use for sounds generated by this component
USoundAttenuati...	AttenuationSettings	If bOverrideSettings is false, the asset to use to determine attenuation properties for sounds generated by this component
FName	AudioComponentUserID	Configurable, serialized ID for audio plugins
uint32	AudioDeviceID	The specific audio device to play this component on
EAttachmentRule	AutoAttachLocationRule	Options for how we handle our location when we attach to the AutoAttachParent, if bAutoManageAttachment is true.
TWeakObjectPtr<...	AutoAttachParent	Component we automatically attach to when activated, if bAutoManageAttachment is true.
EAttachmentRule	AutoAttachRotationRule	Options for how we handle our rotation when we attach to the AutoAttachParent, if bAutoManageAttachment is true.
EAttachmentRule	AutoAttachScaleRule	Options for how we handle our scale when we attach to the AutoAttachParent, if bAutoManageAttachment is true.
FName	AutoAttachSocketName	Socket we automatically attach to on the AutoAttachParent, if bAutoManageAttachment is true.
uint8: 1	bAllowSpatialization	Overrides spatialization enablement in either the attenuation asset or on this audio component's attenuation settings override.
uint8: 1	bAlwaysPlay	Whether to artificially prioritize the component to play
uint8: 1	bAutoDestroy	Auto destroy this component on completion
uint8: 1	bAutoManageAttachment	True if we should automatically attach to AutoAttachParent when Played, and detach from our parent when playback is completed.
uint8: 1	bCenterChannelOnly	Whether or not this sound class forces sounds to the center channel
uint8: 1	bEnableLowPassFilter	Whether or not to apply a low-pass filter to the sound that plays in this audio component.
uint8: 1	bIgnoreForFlushing	If true, this sound will not be stopped when flushing the audio device.
uint8: 1	bIsFadingOut	Whether or not fade out was triggered.
uint8: 1	bIsMusic	Whether or not this audio component is a music clip
uint8: 1	bIsPaused	Whether or not this audio component has been paused
uint8: 1	bIsPreviewSound	Whether or not this sound is a preview sound
uint8: 1	bIsUISound	Whether or not this sound plays when the game is paused in the UI
uint8: 1	bOverrideAttenuation	Allows defining attenuation settings directly on this audio component without using an attenuation settings asset.
uint8: 1	bOverridePriority
uint8: 1	bOverrideSubtitlePriority	Whether or not to override the sound's subtitle priority.
uint8: 1	bPreviewComponent	Whether this audio component is previewing a sound
uint8: 1	bReverb	Whether or not the audio component should be excluded from reverb EQ processing
uint8: 1	bShouldRemainActiveIfDropped	Whether the wave instances should remain active if they're dropped by the prioritization code.
uint8: 1	bStopWhenOwnerDestroyed	Stop sound when owner is destroyed
uint8: 1	bSuppressSubtitles	If true, subtitles in the sound data will be ignored.
TSet< USoundCon...	ConcurrencySet	What sound concurrency rules to use for sounds generated by this audio component
int32	EnvelopeFollowerAttackTime	The attack time in milliseconds for the envelope follower.
int32	EnvelopeFollowerReleaseTime	The release time in milliseconds for the envelope follower.
float	FadeInTimeDuration	How much time the audio component was told to fade in.
TArray< struct ...	InstanceParameters	Array of per-instance parameters for this AudioComponent.
float	LowPassFilterFrequency	The frequency of the lowpass filter (in hertz) to apply to this voice.
FSoundModulatio...	Modulation	Modulation for the sound
float	OcclusionCheckInterval	While playing, this component will check for occlusion from its closest listener every this many seconds
FOnAudioFinishe...	OnAudioFinished	Called when we finish playing audio, either because it played to completion or because a Stop() call turned it off early
FOnAudioFinishe...	OnAudioFinishedNative	Shadow delegate for non UObject subscribers
FOnAudioMultiEn...	OnAudioMultiEnvelopeValue
FOnAudioMultiEn...	OnAudioMultiEnvelopeValueNative	Shadow delegate for non UObject subscribers
FOnAudioPlaybac...	OnAudioPlaybackPercent	Called as a sound plays on the audio component to allow BP to perform actions based on playback percentage.
FOnAudioPlaybac...	OnAudioPlaybackPercentNative	Shadow delegate for non UObject subscribers
FOnAudioSingleE...	OnAudioSingleEnvelopeValue
FOnAudioSingleE...	OnAudioSingleEnvelopeValueNative	Shadow delegate for non UObject subscribers
FOnQueueSubtitl...	OnQueueSubtitles	Called when subtitles are sent to the SubtitleManager.
float	PitchModulationMax	The upper bound to use when randomly determining a pitch multiplier
float	PitchModulationMin	The lower bound to use when randomly determining a pitch multiplier
float	PitchMultiplier	A pitch multiplier to apply to sounds generated by this component
float	Priority	A priority value that is used for sounds that play on this component that scales against final output volume.
FRandomStream	RandomStream
USoundBase *...	Sound	The sound to be played
USoundClass ...	SoundClassOverride	Optional sound group this AudioComponent belongs to
USoundEffectSou...	SourceEffectChain
float	SubtitlePriority	Used by the subtitle manager to prioritize subtitles wave instances spawned by this component.
float	TimeAudioComponentPlayed	What time the audio component was told to play. Used to compute audio component state.
float	VolumeModulationMax	The upper bound to use when randomly determining a volume multiplier
float	VolumeModulationMin	The lower bound to use when randomly determining a volume multiplier
float	VolumeMultiplier	A volume multiplier to apply to sounds generated by this component

Constructors

	Name	Description
	UAudioComponent ( const FObjectInitializer& ObjectIn... )

Functions

	Name	Description
void	AdjustAttenuation ( const FSoundAttenuationSettings& I... )	Modify the attenuation settings of the audio component
void	AdjustVolume ( float AdjustVolumeDuration, float AdjustVolumeLevel, const EAudioFaderCurve FadeCurve )	This will allow one to adjust the volume of an AudioComponent on the fly
void	AdjustVolumeInternal ( float AdjustVolumeDuration, float AdjustVolumeLevel, bool bIsFadeOut, EAudioFaderCurve FadeCurve )
bool	BP_GetAttenuationSettingsToApply ( FSoundAttenuationSettings& OutAtte... )
void	CollectAttenuationShapesForVisualization ( TMultiMap< EAttenuationShape::Type,... )	Collects the various attenuation shapes that may be applied to the sound played by the audio component for visualization in the editor or via the in game debug visualization.
void	FadeIn ( float FadeInDuration, float FadeVolumeLevel, float StartTime, const EAudioFaderCurve FadeCurve )	This can be used in place of "play" when it is desired to fade in the sound over time.
void	FadeOut ( float FadeOutDuration, float FadeVolumeLevel, const EAudioFaderCurve FadeCurve )	This is used in place of "stop" when it is desired to fade the volume of the sound before stopping.
const FSound...	GetAttenuationSettingsToApply()	Returns a pointer to the attenuation settings to be used (if any) for this audio component dependent on the SoundAttenuation asset or overrides set.
UAudioCompon...	GetAudioComponentFromID ( uint64 AudioComponentID )
uint64	GetAudioComponentID()
FName	GetAudioComponentUserID()
FAudioDevice...	GetAudioDevice()	Returns the active audio device to use for this component based on whether or not the component is playing in a world.
bool	GetCookedEnvelopeData ( float& OutEnvelopeData )	Retrieves the current-time cooked envelope data of the playing audio component.
bool	GetCookedEnvelopeDataForAllPlayingSounds ( TArray< FSoundWaveEnvelopeDataPerSo... )	Retrieves the current-time envelope data of the sounds playing audio component.
bool	GetCookedFFTData ( const TArray< float >& Frequencies..., TArray< FSoundWaveSpectralData >& ... )	Retrieves the current-time cooked spectral data of the sounds playing on the audio component.
bool	GetCookedFFTDataForAllPlayingSounds ( TArray< FSoundWaveSpectralDataPerSo... )	Retrieves the current-time cooked spectral data of the sounds playing audio component.
EAudioCompon...	GetPlayState()	Returns the enumerated play states of the audio component.
bool	HasCookedAmplitudeEnvelopeData()	Queries if the sound wave playing in this audio component has cooked amplitude analyses.
bool	HasCookedFFTData()	Queries if the sound wave playing in this audio component has cooked FFT data.
bool	IsPlaying()	Returns if the sound playing any audio.
void	Play ( float StartTime )	Start a sound playing on an audio component
void	PlaybackCompleted ( uint64 AudioComponentID, bool bFailedToStart )
void	PlayInternal ( const float StartTime, const float FadeInDuration, const float FadeVolumeLevel, const EAudioFaderCurve FadeCurve )	Utility function called by Play and FadeIn to start a sound playing.
void	SetBoolParameter ( FName InName, bool InBool )	Set a boolean instance parameter for use in sound cues played by this audio component
void	SetFloatParameter ( FName InName, float InFloat )	Set a float instance parameter for use in sound cues played by this audio component
void	SetIntParameter ( FName InName, int32 InInt )	Set an integer instance parameter for use in sound cues played by this audio component
void	SetLowPassFilterEnabled ( bool InLowPassFilterEnabled )	Sets whether or not the low pass filter is enabled on the audio component.
void	SetLowPassFilterFrequency ( float InLowPassFilterFrequency )	Sets lowpass filter frequency of the audio component.
void	SetPaused ( bool bPause )	Pause an audio component playing its sound cue, issue any delegates if needed
void	SetPitchMultiplier ( float NewPitchMultiplier )	Set a new pitch multiplier
void	SetPlaybackTimes ( const TMap< uint32, float >& InSou... )	Sets the audio thread playback time as used by the active sound playing this audio component Will be set if the audio component is using baked FFT or envelope following data so as to be able to feed that data to BP based on playback time
void	SetSound ( USoundBase* NewSound )	Set what sound is played by this component.
void	SetSoundParameter ( const FAudioComponentParam& Param )	Sets the sound instance parameter.
void	SetSourceBusSendPostEffect ( USoundSourceBus* SoundSourceBu..., float SourceBusSendLevel )	Sets how much audio the sound should send to the given Source Bus (POST Source Effects).
void	SetSourceBusSendPreEffect ( USoundSourceBus* SoundSourceBu..., float SourceBusSendLevel )	Sets how much audio the sound should send to the given Source Bus (PRE Source Effects).
void	SetSourceEffectChain ( USoundEffectSourcePresetChain*... )
void	SetSubmixSend ( USoundSubmixBase* Submix, float SendLevel )	Sets how much audio the sound should send to the given submix.
void	SetUISound ( bool bInUISound )	Set whether sounds generated by this audio component should be considered UI sounds
void	SetVolumeMultiplier ( float NewVolumeMultiplier )	Set a new volume multiplier
void	SetWaveParameter ( FName InName, USoundWave* InWave )	Set a sound wave instance parameter for use in sound cues played by this audio component
void	Stop()	Stop an audio component's sound, issue any delegates if needed
void	StopDelayed ( float DelayTime )	Cues request to stop sound after the provided delay, stopping immediately if delay is zero or negative
void	UpdateSpriteTexture()	Utility function that updates which texture is displayed on the sprite dependent on the properties of the Audio Component.

Overridden from USceneComponent

		Name	Description
	FBoxSphereBo...	CalcBounds ( const FTransform& LocalToWorld )	Calculate the bounds of the component. Default behavior is a bounding box/sphere of zero size.
	void	OnUpdateTransform ( EUpdateTransformFlags UpdateTransfo..., ETeleportType Teleport )	Native callback when this component is moved

Overridden from UActorComponent

	Name	Description
void	Activate ( bool bReset )	Activates the SceneComponent, should be overridden by native child classes.
const UObjec...	AdditionalStatObject()	Give a readable name for this component, including asset name if applicable
void	Deactivate()	Deactivates the SceneComponent.
bool	IsReadyForOwnerToAutoDestroy()	Overridable check for a component to indicate to its Owner that it should prevent the Actor from auto destroying when finished
void	OnRegister()	Called when a component is registered, after Scene is set, but before CreateRenderState_Concurrent or OnCreatePhysicsState are called.
void	OnUnregister()	Called when a component is unregistered.

Overridden from UObject

	Name	Description
void	BeginDestroy()	Called before destroying the object.
FString	GetDetailedInfoInternal()	This function actually does the work for the GetDetailedInfo() and is virtual.
void	PostEditChangeProperty ( FPropertyChangedEvent& PropertyCha... )	Called when a property on this object has been modified externally
void	PostLoad()	Do any object-specific cleanup required immediately after loading an object.
void	Serialize ( FArchive& Ar )	Handles reading, writing, and reference collecting using FArchive.

Constants

Name	Description
AudioComponentIDCounter
AudioIDToComponentMap
AudioIDToComponentMapLock

Deprecated Variables

	Name	Description
USoundConcurren...	ConcurrencySettings_DEPRECATED	What sound concurrency to use for sounds generated by this audio component
float	HighFrequencyGainMultiplier_DEPRECATED
float	VolumeWeightedPriorityScale_DEPRECATED