📢 Runtime Audio Library

Short Description

Small runtime audio helpers exposed to Blueprints and C++. Includes conveniences for playing voice lines with async loading and spawn-time callbacks.

Long Description

UGorgeousAudioBlueprintFunctionLibrary wraps common audio playback flows so gameplay code and tools can play voice lines and handle lifecycle events without boilerplate. The library accepts TSoftObjectPtr references and uses asynchronous loading paths where supported to avoid hitching.

🚀 Features

Play voice lines at an actor location with async load support.
Callbacks for when the audio component is created and when playback finishes.
Blueprint-callable API and C++ friendly helpers.

`PlayVoiceLineAtActorLocation`

Plays a voice line at the specified actor's location. Supports both USoundBase and UDialogueWave types and provides two delegates: one for when the audio component is ready, and one for when the line finishes.

Parameter Name	Type	Description
`Sound`	`TSoftObjectPtr<USoundBase>`	Soft reference to the sound or dialogue wave asset.
`Actor`	`AActor*`	Actor whose location will be used as the origin.
`OnVoiceLineFinished`	`FOnVoiceLineFinishedNative`	Delegate executed when playback has finished.
`OnVoiceLineAudioReady`	`FOnVoiceLineAudioReadyNative`	Delegate executed with the spawned `UAudioComponent*` when audio is ready.
`WorldContextObject`	`UObject*`	Optional world context.

TSoftObjectPtr<USoundBase> MyVoiceLine = TSoftObjectPtr<USoundBase>(FSoftObjectPath("/Game/Audio/VoiceLines/MyLine.MyLine"));
UGorgeousAudioBlueprintFunctionLibrary::PlayVoiceLineAtActorLocation(
    MyVoiceLine,
    PlayerCharacter,
    FOnVoiceLineFinishedNative::CreateLambda([](){ /* finished */ }),
    FOnVoiceLineAudioReadyNative::CreateLambda([](UAudioComponent* Audio){ /* ready */ }),
    GetWorld()
);

Pass a soft reference to a sound asset and the target actor. Bind the two delegate outputs to react to audio readiness and completion.

Notes & implementation details

The implementation detects UDialogueWave vs USoundBase and dispatches to SpawnDialogueAtLocation or SpawnSoundAtLocation respectively.
Async asset loading paths use engine-version guards (GORGEOUS_55_HIGHER vs GORGEOUS_54_LOWER) to pick either LoadAsync or FStreamableManager fallback.
There are TODO comments in the source indicating this helper can be extended to use a runtime audio configuration provider (attenuation, volume, context listeners).