UGameplayStatics::SpawnSoundAttached

This function allows users to create and play Audio Components attached to a specific Scene Component.

Windows
MacOS
Linux

References

Module

Engine

Header

/Engine/Source/Runtime/Engine/Classes/Kismet/GameplayStatics.h

Include

#include "Kismet/GameplayStatics.h"

Source

/Engine/Source/Runtime/Engine/Private/GameplayStatics.cpp

Syntax

static UAudioComponent * SpawnSoundAttached
(
    USoundBase * Sound,
    USceneComponent * AttachToComponent,
    FName AttachPointName,
    FVector Location,
    FRotator Rotation,
    EAttachLocation::Type LocationType,
    bool bStopWhenAttachedToDestroyed,
    float VolumeMultiplier,
    float PitchMultiplier,
    float StartTime,
    USoundAttenuation * AttenuationSettings,
    USoundConcurrency * ConcurrencySettings,
    bool bAutoDestroy
)

Remarks

This function allows users to create and play Audio Components attached to a specific Scene Component. Useful for spatialized and/or distance-attenuated sounds that need to follow another object in space.

Returns

An audio component to manipulate the spawned sound

Parameters

Parameter

Description

Sound

sound to play

AttachComponent

Component to attach to.

AttachPointName

Optional named point within the AttachComponent to play the sound at

Location

Depending on the value of Location Type this is either a relative offset from the attach component/point or an absolute world position that will be translated to a relative offset

Rotation

Depending on the value of Location Type this is either a relative offset from the attach component/point or an absolute world rotation that will be translated to a relative offset

LocationType

Specifies whether Location is a relative offset or an absolute world position

bStopWhenAttachedToDestroyed

Specifies whether the sound should stop playing when the owner of the attach to component is destroyed.

VolumeMultiplier

A linear scalar multiplied with the volume, in order to make the sound louder or softer.

PitchMultiplier

A linear scalar multiplied with the pitch.

StartTime

How far in to the sound to begin playback at

AttenuationSettings

Override attenuation settings package to play sound with

ConcurrencySettings

Override concurrency settings package to play sound with

bAutoDestroy

Whether the returned audio component will be automatically cleaned up when the sound finishes (by completing or stopping) or whether it can be reactivated

Help shape the future of Unreal Engine documentation! Tell us how we're doing so we can serve you better.
Take our survey
Dismiss